Ozmium Agent API
GET ozmium.org/v1/history/:address
Why an agent can trust this route.
Sonar evidence is advisory. Paid delivery is shown as verified only when paid probes are available; otherwise route estimates use the unpaid handshake as a clearly labeled proxy.
Observed outcomes
Closed leverage round-trips for any Base address from the Gains first-party history: pair (base + quote legs), side, leverage, collateral, open/close price, realized PnL + PnL%, close reason (take-profit / stop-loss / liquidation / manual), open/close tx hashes, and timestamps. GET /v1/history/{address}. Newest first, USDC-collateralized trades.
Resource: ozmium.org/v1/history/:address
Network: eip155:8453 · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0x53a05c0eed6cbf065f31aedbae7b0d8ce1a0f4db
Payment methods: — · Last validation: 2026-09-14 09:39:42.423+00
{
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET",
"HEAD",
"DELETE"
],
"type": "string"
},
"pathParams": {
"type": "object",
"properties": {
"address": {
"type": "string"
}
}
},
"queryParams": {
"type": "object",
"properties": {}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"closed": {
"type": "array",
"items": {
"type": "object",
"properties": {
"pair": {
"type": "string"
},
"pnlUsd": {
"type": "number"
},
"reason": {
"type": "string"
}
}
}
},
"address": {
"type": "string"
}
}
},
"network": {
"type": "string"
}
}
}
}
},
"paymentRequirements": [
{
"raw": {
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2",
"builderCode": "bc_cuzowhhb",
"discoverable": true
},
"payTo": "0x53a05c0eed6cbf065f31aedbae7b0d8ce1a0f4db",
"amount": "1000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 60
},
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"payTo": "0x53a05c0eed6cbf065f31aedbae7b0d8ce1a0f4db",
"scheme": "exact",
"network": "eip155:8453",
"amountAtomic": "1000"
}
]
}Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.