Polyrankdocs
Markets

GET /v1/event/{slug}/traders

Who is trading an event: the largest holders of its leading open questions, the best-ranked wallets that traded them in the last 24 h (ranked by price-adjusted edge, never by P&L, win rate or raw Brier) with what they hold, and the net tagged-wallet flow per question, plus the event 24 h traders, 24 h volume and all-time volume. Holders are open to every signed-in caller; the active and tagged-flow panels need metrics_full and come back status "locked" without it.

GET
/v1/event/{slug}/traders

Who is trading an event: the largest holders of its leading open questions, the best-ranked wallets that traded them in the last 24 h (ranked by price-adjusted edge, never by P&L, win rate or raw Brier) with what they hold, and the net tagged-wallet flow per question, plus the event 24 h traders, 24 h volume and all-time volume. Holders are open to every signed-in caller; the active and tagged-flow panels need metrics_full and come back status "locked" without it.

Authorization

AuthorizationBearer <token>

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

In: header

Path Parameters

slug*string

Response Body

application/json

curl -X GET "https://example.com/v1/event/string/traders"
{  "slug": "string",  "canonical_slug": "string",  "event_id": -9007199254740991,  "traders_24h": -9007199254740991,  "volume_24h_usd": 0,  "volume_all_time_usd": 0,  "open_questions": -9007199254740991,  "caps": {    "holder_questions": -9007199254740991,    "holders_per_question": -9007199254740991,    "active_questions": -9007199254740991,    "active_wallets": -9007199254740991  },  "holders": {    "status": "ok",    "questions": [      {        "condition_id": "string",        "label": "string",        "title": "string",        "volume_24h_usd": 0,        "rows": [          {            "proxy_wallet": "string",            "display_name": "string",            "outcome_side": "YES",            "shares_held": 0,            "avg_cost": 0,            "has_mid": true,            "current_value": 0,            "unrealized_pnl": 0          }        ]      }    ],    "positions_as_of": "string",    "as_of": "string"  },  "active": {    "status": "ok",    "required_feature": "string",    "window_hours": -9007199254740991,    "rows": [      {        "proxy_wallet": "string",        "display_name": "string",        "rank_reason": "category_sk_14d",        "skill": {          "sk_14d": 0,          "n_14d": -9007199254740991,          "sk_90d": 0,          "n_90d": -9007199254740991,          "calibration_excess_z": 0,          "calibration_excess_n": -9007199254740991        },        "tags": [          "string"        ],        "last_activity_at": "string",        "positions": [          {            "condition_id": "string",            "label": "string",            "title": "string",            "side": "YES",            "entry_price": 0,            "size_usdc": 0,            "shares": 0,            "activity": "holding",            "last_activity_at": "string"          }        ]      }    ],    "n_active": -9007199254740991,    "n_ranked": -9007199254740991,    "questions": [      {        "condition_id": "string",        "label": "string",        "title": "string",        "volume_24h_usd": 0      }    ],    "positions_as_of": "string",    "skill_as_of": "2019-08-24",    "as_of": "string"  },  "tagged_flow": {    "status": "ok",    "required_feature": "string",    "window_hours": -9007199254740991,    "questions": [      {        "condition_id": "string",        "label": "string",        "title": "string",        "volume_24h_usd": 0,        "flow": {          "smart_net_yes_usdc": 0,          "crowd_net_yes_usdc": 0,          "smart_gross_usdc": 0,          "crowd_gross_usdc": 0,          "smart_wallets": -9007199254740991,          "crowd_wallets": -9007199254740991,          "smart_buy_yes_share": 0,          "smart_lean": "YES",          "diverges": true        }      }    ],    "as_of": "string"  },  "as_of": "string"}

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).

GET /v1/event/{slug} GET

Event (fixture) view: header, dates, every question in the fixture with our own 24h volume and live mids. Scoped to the whole game when Gamma provides a gameId.