Sign in

v1

latestOpenAPI 3.1.02026-07-265385123.6 KB
Market Data

Get trades

Retrieve recent trades for a specific market ordered by most recent first. Optionally filter by order ID to get trades for a specific order. Supports pagination.

get/api/v1/trades

Query parameters

marketstring required

Market address

order_idstring

Order ID

limitinteger

Page size

offsetinteger

Page offset

Response

Market trade history retrieved successfully

total_countinteger nullable

The total number of items across all pages. Optional: history endpoints omit this field to avoid expensive COUNT(*) queries.

Example response

{
  "items": [
    {
      "account": "0x1234567890abcdef1234567890abcdef12345678",
      "action": "buy",
      "client_order_id": "client_order_abc",
      "counter_party_account": "0xfedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210",
      "market": "0xmarket123456789abcdef",
      "order_id": "12345",
      "price": 50000.25,
      "realized_funding_amount": -15.5,
      "size": 100.5,
      "source": "OrderFill",
      "trade_id": "3647276",
      "transaction_unix_ms": 1634567890000,
      "transaction_version": 3647276285
    }
  ]
}