Skip to main content
1

Get an API key

Visit polyedge.dev to create an account and generate your API key.You’ll use this key in the X-PolyEdge-Key header on every request.
2

Fetch the leaderboard

Call the leaderboard endpoint to retrieve the top Polymarket traders ranked by PNL over the last 30 days.
curl https://api.polyedge.dev/v1/analytics/leaderboard \
  -H "X-PolyEdge-Key: YOUR_API_KEY"
A successful response looks like this:
{
  "traders": [
    {
      "profile": {
        "address": "0x9f2fe025f84839ca81dd8e0338892605702d2ca8",
        "name": "surfandturf",
        "profile_image": "",
        "x_username": "",
        "profile_created_at": "2026-04-01T06:03:57Z",
        "last_trade_at": "2026-04-06T02:32:33Z"
      },
      "total_pnl": "639292755514",
      "total_volume": "2190632870982",
      "roi": 46.52,
      "win_rate": 61.54,
      "rank": 1,
      "markets_count": 26,
      "wins_count": 16
    }
  ],
  "total_count": 202991
}
Demo keys return a maximum of 20 results and do not support pagination (offset must be 0). See Authentication for tier details.
3

Use the SDK

Install the SDK for your language and make the same call with a few lines of code.
npm install eventsource-client
Copy polyedge.js and parser_compact_tx.js (Node.js) or polyedge.py, parser_compact_tx.py, and sseclient.py (Python) from the SDK examples into your project, then call the leaderboard:
import PolyEdgeClient from './polyedge.js';

const client = new PolyEdgeClient('YOUR_API_KEY');

const leaderboard = await client.getLeaderboard({ limit: 10, time_frame: '7D' });
console.log(leaderboard.traders);

​
Next steps

Authentication

Understand access tiers and how to handle auth errors.

Leaderboard guide

Filter and sort the leaderboard to find the traders you care about.

Real-time stream

Subscribe to live Polymarket order flow via SSE.

API reference

Full parameter and response field documentation for every endpoint.