Get recent trades

Returns recent public trades for a market with sequence numbers for incremental reads. Store the last processed sequence if you are building a polling-based market data feed.

GET /partner/exchange/trades

Get recent trades

cURL

curl --request GET \
  --url https://api.stabyl.com/v1/partner/exchange/trades \
  --header 'X-Api-Key: <api-key>'

200

{
  "data": {
    "trades": [
      {
        "created_at": "2026-05-24T12:00:00Z",
        "id": "0197f1f0-0000-7000-8000-000000000010",
        "pair_id": "USD/NGN",
        "price": "1650.00",
        "quantity": "10.00",
        "sequence": 12345,
        "side": "buy"
      }
    ]
  },
  "status": "success"
}

Authorizations

X-Api-Key · string · header · default: sb_test_your_key · required

API key. Send it in the X-Api-Key header.

Query Parameters

pair_id · string · required

Trading pair identifier returned by GET /partner/exchange/markets, for example USD/NGN.

after_sequence · integer<int64> | null

Resume public trade reads after a previously processed sequence number.

limit · integer<int64> | null

Number of trades to return. Defaults to 50 and is capped by the API.

Response

200

application/json

Recent trades

data · object · required

Recent public trade tape entries for a trading pair.

Show child attributes

status · enum<string> · required

Available options: success