Polyrankdocs
Traders

GET /v1/trader/{proxy}/trades

Paginated trade history. Cursor-based. Paid feature (metrics_full).

GET
/v1/trader/{proxy}/trades

Paginated trade history. Cursor-based. Paid feature (metrics_full).

Authorization

AuthorizationBearer <token>

API key: Authorization: Bearer pk_live_… (mint at polyrank.app/api-keys)

In: header

Path Parameters

proxy*string

Query Parameters

cursor?string

Opaque cursor from previous response.

limit?integer
side?string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/trader/string/trades"
{  "rows": [    {      "tx_hash": "string",      "block_time": "string",      "block_number": -9007199254740991,      "condition_id": "string",      "market_title": "string",      "market_slug": "string",      "outcome_side": "YES",      "is_buy": true,      "side": "maker",      "price": 0,      "size_shares": 0,      "notional_usdc": 0,      "fee_paid": 0,      "status": "OPEN",      "exchange_version": "string",      "exchange_kind": "string"    }  ],  "next_cursor": "string",  "has_more": true}
{  "error": "string",  "message": "string",  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}

GET /v1/trader/{proxy}/tags GET

Smart-money tags for a trader (whale, sharp, early_bird, contrarian, toxic).

GET /v1/trader/{proxy} GET

Trader profile — every metric value, every percentile rank, plus display enrichment. Full-metric depth is a paid feature; Free gets the public teaser (/v1/public/trader).