Returns the Polymarket leaderboard: top accounts by realized profit OR notional volume over 1d/1w/1m/all-time windows.
Returns the Polymarket leaderboard: top accounts by realized profit OR notional volume over 1d/1w/1m/all-time windows. Includes proxy wallet, pseudonym, bio, amount in USD. DATA only. Use it to find top traders, Polymarket whales, profit or volume leaderboards, and prediction market rankings.
| Method | Endpoint | Price | Description |
|---|---|---|---|
POST | /v1/marketplace/api/polymarket-leaderboard | $0.00575 | Invoke Polymarket Leaderboard (Blockchain) and return the upstream response. |
Requests are paid per call over the x402 protocol. Call the endpoint, receive a 402 Payment Required quote, then repeat the request with the signed payment header. The SDKs do both steps for you.
# 1. Ask for a quote
curl -i -X POST https://jarvisclaw.ai/v1/marketplace/api/polymarket-leaderboard \
-H 'Content-Type: application/json' \
-d '{}'
# 2. Pay it (the SDK signs and retries for you)
curl -X POST https://jarvisclaw.ai/v1/marketplace/api/polymarket-leaderboard \
-H 'Content-Type: application/json' \
-H 'X-PAYMENT: <signed-payload>' \
-d '{}'Taken from the request example this API publishes.
| Name | In | Type | Example |
|---|---|---|---|
limit | body | number | 10 |
metric | body | string | "profit" |
window | body | string | "1d" |
{
"leaderboard": [
{
"rank": 1,
"wallet": "0x91eee6b7...",
"pseudonym": "everydaymortgage",
"amount_usd": 1296360.86
}
],
"metric": "profit",
"window": "1d",
"count": 10,
"attribution": "Data: Polymarket lb-api. https://polymarket.com/leaderboard"
}$0.00575 USDC per call, paid per call over x402. There is no subscription, minimum or monthly fee.
No. Call the endpoint, read the 402 Payment Required quote, and repeat the request with a signed USDC payment header. An account API key also works if you prefer prepaid billing.
USDC on Base or on Solana. The 402 quote lists the accepted networks and the exact amount; the JarvisClaw SDKs sign and retry for you.
Send POST to the endpoint above from any HTTP client, or connect the JarvisClaw MCP server and let the agent find and call it with the search_apis and get_api_detail tools.
Docs: Getting started · x402 payments · x402 discovery · All APIs