Polymarket Get trader leaderboard rankings

https://api.sandbase.ai/v1/api/polymarket/leaderboard

Returns trader leaderboard rankings for a selected category and time period.

Price
$0.02USD / call
Method
POST
Response
JSON
Parameters
0 required · 7 optional
Production route

Try the model

Playground

Open playground
Input
Market category for the leaderboard Allowed values: OVERALL, POLITICS, SPORTS, ESPORTS, CRYPTO, CULTURE, MENTIONS, WEATHER, ECONOMICS, TECH, FINANCE.
150
Max number of leaderboard traders to return Range: 1 to 50.
01000
Starting index for pagination Range: 0 to 1000.
Leaderboard ordering criteria Allowed values: PNL, VOL.
Time period for leaderboard results Allowed values: DAY, WEEK, MONTH, ALL.
Limit leaderboard to a single user by address
Limit leaderboard to a single username
OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price
$0.02 / run

Request & response

Method
POST
Request body
application/json
Response
application/json
Execution
sync

Parameters

category
string (OVERALL, POLITICS, SPORTS, ESPORTS, CRYPTO, CULTURE, MENTIONS, WEATHER, ECONOMICS, TECH, FINANCE) · optional
limit
integer · optional
offset
integer · optional
orderBy
string (PNL, VOL) · optional
timePeriod
string (DAY, WEEK, MONTH, ALL) · optional
user
string · optional
userName
string · optional

Access

Provider
Polymarket
API
Platform API
Base URL
https://api.sandbase.ai
Endpoint
/v1/api/polymarket/leaderboard
Authentication
Bearer API key

API README

Polymarket Get trader leaderboard rankings API

Returns trader leaderboard rankings for a selected category and time period.

The response is the official Polymarket API response, unchanged.

Request

curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "polymarket/leaderboard"}'

Parameters

NameTypeRequiredDescription
categorystringNoMarket category for the leaderboard
limitintegerNoMax number of leaderboard traders to return
offsetintegerNoStarting index for pagination
orderBystringNoLeaderboard ordering criteria
timePeriodstringNoTime period for leaderboard results
userstringNoLimit leaderboard to a single user by address
userNamestringNoLimit leaderboard to a single username

Pricing

Flat price per call. Failed calls are not charged.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/polymarket/leaderboard
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/polymarket/leaderboard" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "user": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
  "limit": 25,
  "offset": 0,
  "orderBy": "PNL",
  "category": "OVERALL",
  "timePeriod": "DAY"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
Polymarket$0.02 per callJSONAug 10, 2026
Polymarket$0.02 per callJSONOct 30, 2026
Polymarket$0.02 per callJSONOct 30, 2026
Polymarket$0.02 per callJSONOct 30, 2026
Polymarket$0.02 per callJSONOct 30, 2026
Polymarket$0.02 per callJSONOct 30, 2026

Questions

FAQ

How do I use the Polymarket Get trader leaderboard rankings API?

Send a POST request to https://api.sandbase.ai/v1/api/polymarket/leaderboard with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Polymarket Get trader leaderboard rankings API cost?

$0.02 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

What parameters does the Polymarket Get trader leaderboard rankings API accept?

No parameters are required. Optional: category (one of OVERALL, POLITICS, SPORTS, ESPORTS, CRYPTO, CULTURE, MENTIONS, WEATHER, ECONOMICS, TECH, FINANCE), limit (integer), offset (integer), orderBy (one of PNL, VOL), timePeriod (one of DAY, WEEK, MONTH, ALL) and user (string) and 1 more. The Parameters table and the Playground on this page list every field.

What does the Polymarket Get trader leaderboard rankings API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a Polymarket developer account or API key?

No. Polymarket Get trader leaderboard rankings runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Polymarket API access separately.