Social Fetch
Start for freeStart free
Polymarket hub

Polymarket Trades API

The public tape across all markets, or one wallet's or event's trades.

GET /v1/polymarket/trades

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/polymarket/trades returns data.trades, newest first, from the public tape. Each row has transactionHash, at, side (BUY or SELL), price, shares, outcome, outcomeIndex, tokenId, conditionId, a market object with title, slug and eventSlug, and a trader object with wallet, name, pseudonym and image.

Filter by wallet, eventId, side, minSize (US dollars), from and to (unix seconds). limit is 1 to 1000 and defaults to 100. Without a wallet or event filter this is the live cross-market tape, which moves quickly.

Polymarket Trades API FAQ

How is this different from the market trades route?

This route spans every market and can filter by wallet or event. The market route is pinned to one condition id. Use this route for a trader's history or a cross-market scan, and the market route when you already know the market.

Can I follow one wallet's trades?

Pass wallet with a 0x address. You can also use GET /v1/polymarket/users/{wallet}/activity for trades, splits, merges, redemptions and rewards in one history. This route returns fills only.

Why does the tape move so fast without filters?

It is the live public tape across all markets. A page can be out of date by the time you process it. Add from and to or filter by event or wallet when you need a stable window.

What does lookupStatus mean on this route?

found means the object or list was returned. not_found means no matching object exists. HTTP 200 only means the request finished, so branch on data.lookupStatus before storing a row.

How much does this route cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

Other Polymarket endpoints