Skip to main content
GET
curl
The response body shown here is a static example, not live data. After you click Send, your live result appears in a separate panel headed 200 OK. The panel under the status-code tabs is a fixed sample from the spec — its field values (fees, prices, sizes, IDs, timestamps) are placeholders. Use Send, or call the endpoint, for current values.
Returns one trade row. The market query parameter is required: trades_by_market is partitioned by market_id first, so without it the lookup would scan every market’s parts.

Path Parameters

tradeId
string
required

Unique trade identifier.

Example:

"12345"

Query Parameters

market
string
required

Market identifier, e.g. "BTC-USD".

Example:

"BTC-USD"

Response

Trade.

One public-trades fill row — one row per maker/taker pairing. Returned by GET /v1/trades (newest-first array) and by the trades WebSocket channel (one frame per taker match, with one row per pairing inside).

On the WS trades channel the update payload is an array of these rows, all built from a single taker match; takerOrderId, takerAddress, timestamp, and sequenceNumber repeat on every row.

marketId
integer
required

Perpetual market identifier (uint16). Map to display name via GET /markets.

Required range: 0 <= x <= 65535
Example:

0

marketDisplayName
string
required

Market symbol (e.g. BTC-USD).

Example:

"BTC-USD"

side
enum<string>
required

Taker side.

Available options:
BUY,
SELL
price
string
required

Fill price in human-readable USD (decimal string).

Example:

"94500.00"

size
string
required

Fill size in human-readable base-asset units (decimal string).

Example:

"0.25"

tradeId
string
required

Unique trade identifier.

Example:

"12345"

timestamp
integer<int64>
required

Fill timestamp (epoch microseconds).

Example:

1712345678000000

takerOrderId
string
required

Server-generated order ID of the taker order.

Example:

"abc-123..."

takerAddress
string
required

Checksummed Ethereum address of the taker account.

Example:

"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"

makerOrderId
string
required

Server-generated order ID of the maker order.

Example:

"def-456..."

makerAddress
string
required

Checksummed Ethereum address of the maker account.

Example:

"0x70997970C51812dc3A010C7d01b50e0d17dc79C8"

sequenceNumber
integer<uint64>
required

Monotonically increasing sequence number for ordering and gap detection.

Example:

9991234