---
title: "Query trade fills"
method: GET
path: "/v1/trades"
tags: ["Trades"]
---

# Query trade fills

`GET /v1/trades`

## Request

- Base URL: `https://crowdintel.xyz/api`
- URL: `https://crowdintel.xyz/api/v1/trades`
- Auth: HTTP bearer

**Min tier: `free`.** Raw on-chain trade fills. **At least one selective filter (`wallet`, `market`, or a fully-bounded `start`+`end` window) is required** — unfiltered scans of the 1.3B-row trades table are rejected with `400`. Time windows must supply both `start` and `end` and cannot exceed 90 days. Keyset cursor pagination on `(trade_timestamp, id)`; routes to ClickHouse for heavy reads.

## Query parameters

- `wallet` string
- `market` string
- `side` 'BUY' | 'SELL'
- `min_bet` number
- `start` string
- `end` string
- `limit` integer
- `cursor` string

## Response `200`

Cursor-paginated trade fills.

- object
  - `data` Trade[]
    - `id` union
      - integer
      - string
    - `tx_hash` string
    - `proxy_wallet` string
    - `condition_id` string, nullable
    - `market_slug` string, nullable
    - `market_title` string, nullable
    - `side` 'BUY' | 'SELL' | 'null', nullable
    - `outcome` string, nullable: What the trader bet on (e.g. 'Yes'), not WIN/LOSS.
    - `price` number, nullable
    - `size` number, nullable
    - `bet_value_usd` number, nullable
    - `trade_timestamp` string, date-time, nullable
  - `next_cursor` string, nullable

## Other responses

- `400`: Malformed parameters or a rejected guardrail (e.g. unfiltered trades query, cluster blowup, window > 90 days).
- `401`: Missing, invalid, or revoked API key. Returned before the rate limiter runs, so it carries no `X-RateLimit-*` headers.
- `403`: Key valid but its tier is below this endpoint's minimum. Returned before the rate limiter runs, so it carries no `X-RateLimit-*` headers.
- `429`: Hourly or monthly rate limit exceeded.

---

[API](https://skmtc.dev/crowdintel/apis/crowdintel-api.md) · [All operations](https://skmtc.dev/crowdintel/apis/crowdintel-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crowdintel/apis/crowdintel-api/revisions/7059cfe9320d?raw)