Polyrankdocs
x402 Agent API

POST /v1/agent/rankings/custom

Custom composite ranking over the full wallet cohort (weights + filters) — the flagship. x402: $0.2 per call, settled in USDC only on a 2xx — a 4xx is free.

POST
/v1/agent/rankings/custom

Custom composite ranking over the full wallet cohort (weights + filters) — the flagship. x402: $0.2 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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/v1/agent/rankings/custom" \  -H "Content-Type: application/json" \  -d '{    "weights": {      "property1": {        "weight": 0      },      "property2": {        "weight": 0      }    }  }'
{}
Empty
Empty

POST /v1/agent/markets/batch POST

Bulk market summaries for up to 100 condition_ids in one call (holder average entry + settlement-corrected mid + resolution). $0.0015/market, capped. x402: $0.15 per call, settled in USDC only on a 2xx — a 4xx is free.

POST /v1/agent/traders/batch POST

Bulk score up to 100 wallets in one call (metrics + percentiles + tags). $0.0015/wallet, capped. x402: $0.15 per call, settled in USDC only on a 2xx — a 4xx is free.