Traders
GET /v1/trader/{proxy}
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).
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).
AuthorizationBearer <token>
API key: Authorization: Bearer pk_live_… (mint at polyrank.app/api-keys)
In: header
Path Parameters
proxy*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"{ "proxy_wallet": "string", "metrics_lifetime": { "property1": 0, "property2": 0 }, "percentiles_lifetime": { "property1": 0, "property2": 0 }, "first_trade_at": "string", "last_trade_at": "string", "trade_count": -9007199254740991, "markets_traded": -9007199254740991, "display": { "username": "string", "pseudonym": "string", "profile_image": "string", "x_username": "string", "verified": true, "bio": "string", "eoa": "string", "claimed": true, "claimed_by_me": true, "founding": true }, "snapshot_age_seconds": -9007199254740991, "metrics_windows": { "property1": { "realized_pnl": 0, "volume_usdc": 0, "roi_pct": 0, "n_trades": -9007199254740991 }, "property2": { "realized_pnl": 0, "volume_usdc": 0, "roi_pct": 0, "n_trades": -9007199254740991 } }, "user_id": "string", "wallet_count": -9007199254740991, "scope": "combined", "wallets": [ { "proxy_wallet": "string", "realized_pnl": 0, "lifetime_volume_usdc": 0, "trade_count": -9007199254740991, "win_rate_pct": 0, "is_primary": true, "display": { "username": "string", "pseudonym": "string", "profile_image": "string", "verified": true } } ]}Empty
{ "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"}