TESTNET
Connect

MarketDataService

Get Trades

Retrieve recent public trades for a spot symbol, ordered newest first. Supports optional aggressor side, inclusive time-range, and opaque page-token pagination filters.

GET
/v1/spot/markets/{symbol}/trades

Request

Testnet 
curl --request GET \ \
  --url 'https://api.testnet.polyester.com/v1/spot/markets/BTC-USDT/trades?endTime=2025-01-01T00%3A00%3A00Z&limit=100&pageToken=eyJvZmZzZXQiOjEwMH0&side=BUY&startTime=2025-01-01T00%3A00%3A00Z' \
  --header 'Accept: */*'

Responses

{
  "nextPageToken": "eyJvZmZzZXQiOjIwMH0",
  "trades": [
    {
      "executedAt": "2025-01-01T00:00:00Z",
      "matchId": "100001",
      "price": "0.005",
      "qty": "100000",
      "side": "BUY",
      "symbol": "BTC-USDT"
    }
  ]
}
symbol string required

Trading pair symbol, e.g. BTC-USDT

endTime string (date-time)

Filter trades executed at or before this time (inclusive, RFC3339)

limit integer ≤ 1000

Maximum trades to return. Default 100, max 1000.

pageToken string max 512 chars

Opaque cursor from the previous response.

side enum must be defined value

Filter by aggressor side. BUY means the taker bought the base asset; SELL means the taker sold the base asset.

startTime string (date-time)

Filter trades executed at or after this time (inclusive, RFC3339)

nextPageToken string

Opaque cursor for the next page. Empty when no more results exist.

Example eyJvZmZzZXQiOjIwMH0
6 fields
Possible errors: 5
KeyStatusErrorWhen
unauthenticated401UnauthenticatedAuthentication required.
permission-denied403Permission DeniedPermission denied.
invalid-argument400Invalid ArgumentInvalid argument.
not-found404Not FoundNot found.
unavailable503UnavailableService unavailable.