the three Polymarket APIs
| data api | https://data-api.polymarket.com/v2 | leaderboard, a trader's positions, trades and activity |
|---|---|---|
| gamma api | https://gamma-api.polymarket.com | markets and events: question, end date, liquidity, prices |
| clob api | https://clob.polymarket.com | the order book: markets, prices, and placing orders with a signed key |
the v1 data api is retired
calls to data-api.polymarket.com without /v2 now answer with an error that says "Data API v1 has been retired". many tutorials and scrapers still use the old paths, which is why they break. every example below uses v2.
polymarket leaderboard api
rank traders by profit or by volume, over a day, a week, a month or all time.
curl -s 'https://data-api.polymarket.com/v2/leaderboard?timePeriod=WEEK&orderBy=PNL&limit=50'
- timePeriod: DAY, WEEK, MONTH or ALL. orderBy: PNL or VOLUME. category is optional (for example crypto).
- each row has rank, user_id (the trader's address), user_name, pnl and volume in dollars, x_username and verified.
- for the next page, pass the next_cursor value from pagination back as cursor.
a trader's positions and trades
take a user_id from the leaderboard and read what that trader holds and what they just did.
curl -s 'https://data-api.polymarket.com/v2/positions?user=0xADDRESS&limit=50'
curl -s 'https://data-api.polymarket.com/v2/trades?user=0xADDRESS&limit=50'
curl -s 'https://data-api.polymarket.com/v2/activity?user=0xADDRESS&limit=50'
- positions: current_size, avg_price, total_cost_usdc, current_price, current_value, per market.
- trades: side, size, price, timestamp, and the market's title and slug.
markets and events
curl -s 'https://gamma-api.polymarket.com/markets?limit=20&closed=false'
curl -s 'https://gamma-api.polymarket.com/events?limit=20&closed=false'
- a market row has the question, the slug, the end date, the liquidity and the condition id that links it to positions and trades.
what copy.top does with Polymarket
copy.top publishes a weekly study built from the public leaderboard: how many of the top traders made money, what the median trader made, and how concentrated profits are. it is recomputed every monday and built to be cited.
copy trading Polymarket traders is not open on copy.top yet. copy.top's own API covers fomo, pumpfun and Hyperliquid traders.
faq
is the Polymarket API free?
reading is free and needs no key: leaderboard, positions, trades, markets and events are public. placing orders goes through the clob api and needs a signed key from your own wallet.
is there a Polymarket leaderboard API?
yes: GET https://data-api.polymarket.com/v2/leaderboard with timePeriod (DAY, WEEK, MONTH, ALL), orderBy (PNL or VOLUME) and limit. it returns rank, address, name, pnl and volume.
why did my Polymarket scraper stop working?
the first version of the data api was retired. requests to the old paths return an error. add /v2 to the path and read the rows from the data field.
do I need a Polymarket scraper?
for the leaderboard, positions, trades and markets, no. these are served by public APIs, which are faster and more stable than reading the website.
can I copy Polymarket traders on copy.top?
not yet. copy.top publishes weekly statistics on Polymarket traders, and copies traders from fomo and pumpfun.