trades: Get recent trades

API: gateio.ws:gate.io-api
Endpoint: /spot/trades
Response format: application/json
Auth: none
Method: GET
Last Status: 200
Latency: 1103ms

Description

Returns recent trades executed for a trading pair showing actual transaction history including price, amount, and side (buy/sell). Use this to analyze market activity, recent price action, or trading volume.

From spec: Get the most recent trades for a specific trading pair.

Usage Tips

- Required parameter: currency_pair (e.g., BTC_USDT) - Optional: limit (1-1000, default 100) controls number of trades returned - Side indicates who was the taker: 'buy' means a buy order was filled, 'sell' means a sell order was filled - create_time is Unix timestamp in seconds, create_time_ms includes milliseconds - Results are sorted by most recent first

Parameters (2)

currency_pair (string, query, required)

Trading pair in format BASE_QUOTE (e.g., BTC_USDT)

limit (integer, query, optional, default: 100)

Number of trades to return (default: 100, max: 1000)

Constraints: {'minimum': 1, 'maximum': 1000}

Examples (1)

Get recent BTC_USDT trades probe-gate

Demonstrates fetching the 5 most recent trades for BTC_USDT to see recent market activity.

curl 'https://api.gateio.ws/api/v4/spot/trades?currency_pair=BTC_USDT&limit=5'
import requests

resp = requests.get(
    "https://api.gateio.ws/api/v4/spot/trades",
    params={
        'currency_pair': 'BTC_USDT',
        'limit': '5',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("gateio")
result = api.fetch("spot/trades", currency_pair="BTC_USDT", limit=5)

for item in result:
    print(item)
const resp = await fetch("https://api.gateio.ws/api/v4/spot/trades?currency_pair=BTC_USDT&limit=5");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 03:17:30.066572 200 1103ms
2026-04-15 01:56:11.490484 200 1260ms
2026-04-14 00:17:03.504493 200 1459ms
2026-04-12 13:01:18.765141 200 1245ms
2026-04-10 04:20:53.733027 200 1068ms
2026-04-09 00:10:58.998444 200 1300ms
2026-04-08 07:28:21.458223 200 1197ms
2026-04-07 00:50:29.273231 200 1375ms
2026-04-05 21:03:14.017433 200 3855ms