Polyrankdocs
x402 Agent API

GET /v1/agent/leaderboard

Default/preset top-N board, unmasked; ?sort= orders it by any metric (metric:/pctile:/engine:/timing:<id>). x402: $0.03 per call, settled in USDC only on a 2xx — a 4xx is free.

GET
/v1/agent/leaderboard

Default/preset top-N board, unmasked; ?sort= orders it by any metric (metric:/pctile:/engine:/timing:). x402: $0.03 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

Query Parameters

preset?string

Preset slug (GET /v1/agent/rankings/presets lists them). Default polyrank-default.

sort?string

Order the preset board by: composite (default), a whitelisted column, metric: / pctile: (any displayable metric), engine: or timing:. NULLs last.

dir?string

Sort direction (default desc).

limit?integer

Rows (max 500).

offset?integer

Row offset.

include_breakdown?string

Attach the per-metric percentile breakdown to each row.

Response Body

application/json

curl -X GET "https://example.com/v1/agent/leaderboard"
{}
Empty
Empty

GET /v1/agent/identity/{proxy} GET

Multi-wallet identity: the person’s full wallet set + combined per-user metrics. x402: $0.03 per call, settled in USDC only on a 2xx — a 4xx is free.

GET /v1/agent/market/{conditionId}/active-traders GET

Wallets active in one market ranked by price-adjusted category edge, plus the pre-registered lean (unmasked). x402: $0.05 per call, settled in USDC only on a 2xx — a 4xx is free.