> For the complete documentation index, see [llms.txt](https://resolvedmarkets.com/llms.txt). Every docs page is also served as Markdown: append `.md` to its URL or send `Accept: text/markdown`.

# Get Market Trades

### GET /v1/markets/:id/trades — Get Market Trades

Paginated executed-trade tape (last_trade_price fills) for a market. Joins to snapshots via asset_id = token_id and matching timestamp — line up a fill against the book at that instant to see what liquidity was resting. This is the tape AS OBSERVED LIVE, not a guaranteed-complete fill history: trades carry no separate exchange event time (timestamp is capture time), transaction_hash is not captured, and a market that predates trade capture (or had no trades) returns 200 with total: 0.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | yes | Market ID (conditionId) |

**Query parameters**

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `format` | string | no | json | Response encoding. csv and tsv return the row array as a flat file instead of a JSON envelope — the envelope moves to X-* response headers and nulls render as \N. REQUIRES SCALE OR ENTERPRISE (json is available on every tier). Works with includebook=true — the bids/asks ladders come through as compact JSON inside their cell, complete and parseable (pandas: df["bids"].apply(json.loads)). |
| `side` | string | no | — | Token side filter (also populates token_side on each row) |
| `from` | string | no | — | Start timestamp |
| `to` | string | no | — | End timestamp |
| `limit` | number | no | 500 | Max rows (default 500, max 5000) |
| `offset` | number | no | 0 | Pagination offset |
| `order` | string | no | desc | Sort by timestamp: asc/oldest (chronological) or desc/newest (reverse). Defaults to desc. |
| `count` | boolean | no | true | Set to false to skip the count() query (returns total: null). |

**Example response**

```json
{
  "market_id": "0x...",
  "total": 24416,
  "limit": 100,
  "offset": 0,
  "data": [
    {
      "market_id": "0x...",
      "asset_id": "253124573920...",
      "timestamp": "2026-07-14 21:14:31.700",
      "price": 0.9975,
      "size": 42.37,
      "side": "SELL",
      "category": "crypto",
      "subcategory": "BTC",
      "token_side": "UP"
    }
  ]
}
```