Polyrankdocs
Traders

GET /v1/trader/{proxy}/tags

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

GET
/v1/trader/{proxy}/tags

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

Authorization

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/tags"
{  "proxy_wallet": "string",  "tags": [    {      "tag": "whale",      "score": 0,      "rationale": {        "property1": null,        "property2": null      }    }  ],  "current_metrics": {    "lifetime_volume_usdc": 0,    "brier": 0,    "counter_consensus_alpha": 0,    "n_contrarian_fills": 0,    "n_resolved": 0,    "win_rate_pct": 0  },  "computed_at": "string"}
Empty
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}

GET /v1/trader/{proxy}/return-distribution GET

Resolved-position return distribution over EVERY resolved position (P1-25). Buckets come from the shared RETURN_BUCKETS vocabulary; positions with a non-positive cost basis are reported separately rather than bucketed.

GET /v1/trader/{proxy}/timing-skill GET

Category × entry-timing skill grid for a trader (CH 0146). Every cell carries its own n; cells below the window floor are returned but flagged not rankable.