prediction-trades
GET api.agentstools.dev/prediction/trades
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
Recent trades for one prediction market (by conditionId, slug or numeric id): a PII-stripped pseudonymous feed plus a derived summary — trade count, buy/sell volume and counts, size-weighted average price, last price and range.
Resource: api.agentstools.dev/prediction/trades
Network: eip155:8453 · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493
Payment methods: — · Last validation: 2026-09-14 16:44:40.511+00
{
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET",
"HEAD",
"DELETE"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [
"market"
],
"properties": {
"side": {
"enum": [
"BUY",
"SELL"
],
"type": "string",
"description": "Filter to one side"
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max trades (default 25, cap 100)"
},
"venue": {
"enum": [
"polymarket"
],
"type": "string",
"description": "Venue (default polymarket)"
},
"market": {
"type": "string",
"description": "Market: 0x conditionId, slug or numeric id (resolved to a conditionId first)"
},
"min_size": {
"type": "number",
"minimum": 0,
"description": "Only trades at/above this cash value"
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
},
"paymentRequirements": [
{
"raw": {
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493",
"amount": "15000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"payTo": "0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493",
"scheme": "exact",
"network": "eip155:8453",
"amountAtomic": "15000"
}
]
}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.