Spot Market Data Endpoints

Access GaiaEx spot market data via API: ticker prices, 24h volume, candlestick history, and live order book depth.

Overview

Public endpoints for spot market data. No authentication required.

List Spot Symbols

GET https://openapi.gaiaex.com/v1/trade/spot/symbols

Returns all available spot trading pairs.

Parameters: None

Response:

{
  "status": "ok",
  "count": 25,
  "symbols": [
    {
      "symbol": "@145",
      "subCoin": "PURR",
      "displayName": "PURR/USDC",
      "baseToken": "PURR",
      "quoteToken": "USDC",
      "szDecimals": 0,
      "midPrice": "0.0523",
      "markPrice": "0.0524",
      "prevDayPrice": "0.0501",
      "volume24h": "1250000.00",
      "isCanonical": true
    }
  ],
  "note": "Use displayName base (e.g. 'BTC') or symbol (e.g. '@145') for trading API.",
  "timestamp": 1743508800000
}

GET20/s IPhttps://openapi.gaiaex.com/v1/trade/spot/ticker/{symbol}

Get Spot Ticker

GET https://openapi.gaiaex.com/v1/trade/spot/ticker/{symbol}

Returns real-time price data for a spot trading pair.

Path Parameters:

Parameter	Type	Description
`symbol`	string	Spot symbol (e.g., `PURR/USDC`)

Response:

{
  "symbol": "PURR/USDC",
  "displayName": "PURR/USDC",
  "midPrice": "0.0523",
  "markPrice": "0.0524",
  "prevDayPrice": "0.0501",
  "volume24h": "1250000.00",
  "circulatingSupply": "500000000.0",
  "timestamp": 1743508800000
}

Parameters

Name	Type	Required	Description
symbol	string	Yes	Spot symbol (e.g., ETH)

symbol

stringRequired

Spot symbol (e.g., ETH)

Get Spot Order Book

GET https://openapi.gaiaex.com/v1/trade/spot/orderbook/{symbol}

Returns the order book for a spot trading pair.

Path Parameters:

Parameter	Type	Description
`symbol`	string	Spot symbol (e.g., `PURR/USDC`)

Query Parameters:

Parameter	Type	Default	Max	Description
`depth`	int	20	50	Number of price levels per side

Response:

{
  "symbol": "PURR/USDC",
  "displayName": "PURR/USDC",
  "bids": [
    { "price": 0.0523, "size": 15000.0, "count": 3 },
    { "price": 0.0522, "size": 25000.0, "count": 5 }
  ],
  "asks": [
    { "price": 0.0524, "size": 12000.0, "count": 2 },
    { "price": 0.0525, "size": 18000.0, "count": 4 }
  ],
  "timestamp": 1743508800000
}

Bids are sorted descending (highest first)
Asks are sorted ascending (lowest first)
Each entry is an object with price, size, and count (number of orders at that level)

Server Time

GET https://openapi.gaiaex.com/v1/trade/spot/time

Returns server time in milliseconds. Use to synchronize timestamps for requests.

Parameters: None

Response:

{
  "serverTime": 1743508800000
}