Trades

Query trade fills

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.

get/v1/trades

Request

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

Query parameters

walletstring
Example:0x0000000000000000000000000000000000000000

Filter by proxy wallet address.

marketstring

Filter by market condition id.

side'BUY' | 'SELL'

Trade side.

min_betnumber

Minimum bet value (USD).

startstring

Window start — ISO-8601 or unix-ms. Required with end when no wallet/market filter.

endstring

Window end — ISO-8601 or unix-ms. Window capped at 90 days.

limitinteger

Page size (default 25, max 100).

cursorstring

Opaque pagination cursor from a previous response's next_cursor. Omit for the first page. A cursor that is supplied but undecodable returns 400 bad_request ("Invalid cursor") — it does not silently restart at page 1.

Response

Cursor-paginated trade fills.

next_cursorstring nullable

Example response

{
  "data": [
    {
      "proxy_wallet": "0x0000000000000000000000000000000000000000"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.