Trades

{
  "success": true,
  "data": {
    "rows": [
      {
        "id": "987654321",
        "order_id": "123456789",
        "symbol": "PERP_ETH_USDC",
        "side": "BUY",
        "executed_price": "2500.00",
        "executed_quantity": "0.5",
        "fee": "0.0005",
        "fee_asset": "USDC",
        "is_maker": false,
        "realized_pnl": "10.50",
        "executed_timestamp": 1714900000000
      }
    ],
    "next_cursor": "eyJsYXN0X2lkIjo5ODc2NTQzMjEsInNyYyI6Im15c3FsIn0"
  },
  "ts": 1779269143700
}

Executed trade fills for an address. The handler transparently combines real-time fills (last 24 hours) with the archive (older than 24 hours); the cursor carries which source the next page is on, so pagination is continuous. Weight: 5

Request

{
  "type": "trades",
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "symbol": "PERP_ETH_USDC",
  "start_time": 1714000000000,
  "end_time": 1715000000000,
  "limit": 200
}

Field	Type	Required	Default	Notes
`address`	string	Yes	—	Wallet address
`broker_id`	string	No	—	Optional
`account_id`	string	No	—	Optional
`symbol`	string	No	—	Symbol filter
`start_time`	int64	No	—	ms epoch
`end_time`	int64	No	`now` (when `start_time` set)	ms epoch
`limit`	int	No	100	1..1000 (without time range) or 1..2000 (with time range)
`cursor`	string	No	—	Opaque cursor (carries `src`)

Response

Field	Type	Notes
`id`	string	Transaction ID
`order_id`	string \| null	`null` on orphaned / liquidation fills
`is_maker`	bool	`true` = maker, `false` = taker
`realized_pnl`	string \| null	`null` for fills older than 24 hours (archive does not retain this column)

Notes

24-hour boundary: real-time data covers [max(start_time, now − 24h), end_time]; archived data covers [start_time, min(end_time, now − 24h − 1ms)]
Treat the cursor as opaque — always pass it back as-is

{
  "success": true,
  "data": {
    "rows": [
      {
        "id": "987654321",
        "order_id": "123456789",
        "symbol": "PERP_ETH_USDC",
        "side": "BUY",
        "executed_price": "2500.00",
        "executed_quantity": "0.5",
        "fee": "0.0005",
        "fee_asset": "USDC",
        "is_maker": false,
        "realized_pnl": "10.50",
        "executed_timestamp": 1714900000000
      }
    ],
    "next_cursor": "eyJsYXN0X2lkIjo5ODc2NTQzMjEsInNyYyI6Im15c3FsIn0"
  },
  "ts": 1779269143700
}

Position context Deposits and withdrawals

Builder quickstart

Partner onboarding & support

Core integration flows

Builders Marketplace

API fundamentals

Public Info API

General API

User API

Trading API

Strategy vault API

Staking & VALOR API

Builder API

Points module

Market data API

Websocket API

Request

Response

Notes

​Request

​Response

​Notes

Request

Response

Notes