x402 Agent API

GET /v1/agent/market/{conditionId}/stats

All-time market aggregate stats (volume, traders, lifespan, top traders). x402: $0.02 per call, settled in USDC only on a 2xx — a 4xx is free.

Authorization

x402

X-PAYMENT<token>

x402 payment: base64(JSON PaymentPayload) with an EIP-3009 USDC transferWithAuthorization on Base. Call once without it to get the 402 PaymentRequirements; see docs.polyrank.app/x402.

In: header

Path Parameters

conditionId*string

Query Parameters

top?integer

Response Body

`application/json`

curl -X GET "https://example.com/v1/agent/market/string/stats"

{}

Empty

GET /v1/agent/market/{conditionId}/resolution-risk GET

Dispute-risk score (Low/Elevated/High + reasons) + live UMA settlement state. x402: $0.05 per call, settled in USDC only on a 2xx — a 4xx is free.

GET /v1/agent/market/{conditionId} GET

Market summary (holder average entry + settlement-corrected mid + shallow book). x402: $0.01 per call, settled in USDC only on a 2xx — a 4xx is free.