GET /v1/rankings/preset/{slug}

Top-N for a named preset. Cached for 60 seconds. Optional active_within_days / best_category / sort_by overrides, and extra_metrics (comma-separated ids) for per-row breakdown columns (paid).

Authorization

AuthorizationBearer <token>

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

In: header

Path Parameters

slug*string

Query Parameters

limit?integer

offset?integer

include_breakdown?boolean

include_verdict?boolean

active_within_days?integer

best_category?string

sort_by?string

sort_dir?string

extra_metrics?string

include_cluster?boolean

dedupe_clusters?boolean

Response Body

`application/json`

curl -X GET "https://example.com/v1/rankings/preset/string"

{  "rows": [    {      "rank": -9007199254740991,      "proxy_wallet": "string",      "user_id": "string",      "wallet_count": -9007199254740991,      "wallets": [        {          "proxy_wallet": "string",          "realized_pnl": 0,          "lifetime_volume_usdc": 0,          "trade_count": -9007199254740991,          "win_rate_pct": 0,          "display": {            "username": "string",            "pseudonym": "string",            "profile_image": "string",            "verified": true          }        }      ],      "display": {        "username": "string",        "pseudonym": "string",        "profile_image": "string",        "verified": true      },      "composite_score": 0,      "lifetime_volume_usdc": 0,      "realized_pnl": 0,      "trade_count": -9007199254740991,      "markets_traded": -9007199254740991,      "win_rate_pct": 0,      "brier": 0,      "last_trade_at": "string",      "breakdown": {        "property1": 0,        "property2": 0      },      "breakdown_measured": {        "property1": true,        "property2": true      },      "verdict": {        "overall": 0,        "tone": "good",        "title": "string",        "topTag": {          "label": "string",          "tone": "good",          "title": "string"        },        "copyRecommended": true,        "copiesBadly": true      },      "cluster_id": "string",      "cluster_size": -9007199254740991    }  ],  "total_rows": -9007199254740991,  "cohort_size": -9007199254740991,  "normalized_weights": {    "property1": 0,    "property2": 0  },  "gated_out_count": -9007199254740991,  "query_ms": -9007199254740991,  "snapshot_age_seconds": -9007199254740991,  "rows_capped_at": -9007199254740991,  "explain": {    "cohort_size": -9007199254740991,    "gates": [      {        "label": "string",        "condition": "string",        "dropped": -9007199254740991,        "remaining": -9007199254740991      }    ]  }}