Skip to main content
GET
/
v1
/
api
/
traders
/
top
Top traders
curl --request GET \
  --url https://api.dotprediction.io/v1/api/traders/top \
  --header 'X-API-Key: <api-key>'
{
  "traders": [
    {
      "rank": 123,
      "address": "<string>",
      "display_name": "<string>",
      "pseudonym": "<string>",
      "profile_image": "<string>",
      "bio": "<string>",
      "social": {
        "x_username": "<string>",
        "verified": true
      },
      "stats": {
        "total_volume": 123,
        "total_pnl": 123,
        "roi_percent": 123,
        "markets_traded": 123,
        "win_rate": 123,
        "portfolio_value": 123,
        "open_positions": 123
      }
    }
  ],
  "pagination": {
    "total": 123,
    "limit": 123,
    "has_more": true,
    "next_cursor": "<string>"
  },
  "meta": {
    "platforms": [
      "<string>"
    ],
    "request_time": 123,
    "cache_hit": true,
    "sort_by": "<string>",
    "time_period": "<string>",
    "category": "<string>"
  }
}

Authorizations

X-API-Key
string
header
required

API key for authentication. Generate one via the dashboard or the /v1/api/auth/api-keys endpoint.

Query Parameters

provider
enum<string>
required

Platform to query.

Available options:
polymarket,
limitless
category
string
default:overall

Category filter (default: overall).

time_period
enum<string>
default:month

Time period for ranking.

Available options:
day,
week,
month,
all
sort_by
enum<string>
default:pnl

Sort dimension.

Available options:
pnl,
volume
limit
integer
default:25

Max results to return (default 25, max 50).

Required range: x <= 50
cursor
string

Pagination cursor from a previous response.

Response

Top traders leaderboard.

traders
object[]
pagination
object
meta
object