GateData.AI

Recent trades

Query recent individual trades for a trading object, including price, size, side, and time.

GET/api/v1/markets/trades/recent
Domain
Market & Liquidity
Level
Crypto listing
MCP tool
market_data_query (task=trades)

Available data

Returns
Recent individual trades for a trading object, including price, size, side, and time
Market coverage
Crypto listings
Query granularity
One listing per query; each row is an individual trade rather than a value derived from candles or order-book updates

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Object positioning

Provide at least one of listing_id, asset_id, query, or base.

listing_idstringqueryExamplelisting_gate_BTC_USDT_spotconditional

Canonical listing identifier

asset_idstringqueryExampleasset_btcconditional

Canonical asset identifier

querystringqueryExampleBTCconditional

Search text used to resolve the query object

tickerstringqueryExampleBTCconditional

Ticker alias of query.

symbolstringqueryExampleBTCconditional

Symbol alias of query.

basestringqueryExampleBTCconditional

Base asset code of the trading pair

Market routing

Optional; query=BTC defaults to Gate / spot / USDT.

marketMarketqueryExamplecryptooptional

Market of the query object

venuestringqueryExamplegateoptional

Trading venue code to query

market_typeMarketTypequeryExamplespotoptional

Type of traded product

quotestringqueryExampleUSDToptional

Quote asset code of the trading pair

Response control

All optional.

limitintegerqueryExample50optional

Maximum records returned per request

Response

trades[]array[object (Trade)]

Recent public trades

trade_idstringExample215250064

Public trade identifier

pricenumberExample64079.9

Last valid traded price

amountnumberExample0.341013

Trade quantity

sideTradeSideExamplebuy

Aggressor side of the trade

trade_timedatetimeExample2026-08-17T17:07:13.135738802Z

Source event time of the trade

data_statusDataStatusExampleready

Availability of this business record

data_statusDataStatusExampleready

Availability of the business data

metadataobject

Response status and resolution information

data_statusDataStatusExampleready

Availability of the business data

actual_taskstring

Task that was actually executed

route_reasonstring

Reason the task or object was selected

limitations[]string[]

Known data limitations

updated_atdatetime | stringExample2026-08-17T17:07:13Z

Most recent object or response update time

partialboolean

Whether the response contains only a subset of fields

resolution_reasonstring

Reason code for the object-resolution outcome

object_refs[]object[]

Unified object references

typeObjectRefTypeExampleasset

Object reference type

idstringExampleasset_btc

Canonical object identifier

entity_idstring

Canonical entity identifier

asset_idstringExampleasset_btc

Canonical asset identifier

listing_idstring

Canonical listing identifier

instrument_idstring

Canonical financial instrument identifier

venue_idstring

Canonical trading venue identifier

event_refstring

Related event identifier

market_idstring

Canonical market object identifier

venuestring

Related platform code

resolved_fromstringExampleasset_entity

Input used to resolve the object

resolution_confidencestringExampleresolved

Object resolution confidence

Errors & fallback

200
assets_resolve name multi-match; confirm from data[] candidates.
200
The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.
400
Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.
401
The API key is missing or invalid.
403
The current key scope or plan cannot access this data domain.
404
The requested resource does not exist; source coverage gaps are not 404 responses.
402
Credits or monthly quota exhausted.
429
Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.