Sign in
latestOpenAPI 3.0.02026-08-1072525.6 KB

59bdec1683ed

Market
Public

List recent trades

Returns the most recent executed trades for a specific market. Each trade includes the price, quantity, side (buy/sell), and timestamp. This data is useful for displaying trade history feeds and analyzing recent market activity. Trades are returned newest-first (reverse chronological order).

The endpoint is public, but callers presenting a bearer token with the trades:read_any scope additionally receive the maker and taker wallet addresses on each trade.

get/v0/markets/{symbol}/trades

Path parameters

symbolstring required

Market symbol in BASE:QUOTE form using the exchange's currency codes (e.g. SOMI:USDso). The authoritative, per-environment list of live symbols and currency codes is served by GET /v0/markets and GET /v0/currencies; do not assume codes are stable across mainnet and testnet. As of writing, mainnet lists SOMI:USDso, WETH:USDso, WBTC:USDso, and USDC.e:USDso.

Market symbol

Query parameters

sinceinteger

Return trades after this unix millisecond timestamp

limitinteger

Maximum number of trades to return (default 100, max 1000)

Response

Recent trades for a market

nextCursorstring

Opaque pagination token. Pass this back as the cursor query parameter on the next request to retrieve the page after this one. The string is intentionally opaque — clients must not parse or modify it. Absent (empty string omitted from the response) when there are no further pages.

symbolstring required

Market symbol in BASE:QUOTE form using the exchange's currency codes (e.g. SOMI:USDso). The authoritative, per-environment list of live symbols and currency codes is served by GET /v0/markets and GET /v0/currencies; do not assume codes are stable across mainnet and testnet. As of writing, mainnet lists SOMI:USDso, WETH:USDso, WBTC:USDso, and USDC.e:USDso.

totalinteger

Total number of trades matching the query filters (e.g. symbols/since), ignoring limit and cursor. Present only on the authenticated per-user trade endpoints. Omitted when the count is unknown. A genuinely empty result set with a known count returns total: 0.