> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/polymarket/trades>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/polymarket/trades.mdx>

---

# Polymarket Trades API

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

`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.

## Request

- **Endpoint:** `GET /v1/polymarket/trades`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by wallet or event
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/polymarket/trades/get)
- **Platform page:** [/platforms/polymarket](https://www.socialfetch.dev/platforms/polymarket)

## 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.