copy open copy.top
copy.top / developers / Polymarket api

polymarket api: how to read the leaderboard, top traders and their trades

Polymarket has public APIs that need no key for reading. this guide shows the calls that work today, with examples tested on November 16, 2026. if you came here looking for a polymarket scraper, you do not need one: the leaderboard and every trader's positions are one request away.

the three Polymarket APIs

data apihttps://data-api.polymarket.com/v2leaderboard, a trader's positions, trades and activity
gamma apihttps://gamma-api.polymarket.commarkets and events: question, end date, liquidity, prices
clob apihttps://clob.polymarket.comthe 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'

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'

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'

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.

other guides

examples tested on November 16, 2026. copy.top is independent: it is not affiliated with fomo, pump.fun, Hyperliquid or Polymarket. the copy.top API is read-only: nothing here places an order. figures are data, not advice. trading crypto is risky and past performance does not predict results.