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": "PURR/USDC",
      "displayName": "PURR/USDC",
      "baseToken": "PURR",
      "quoteToken": "USDC",
      "status": "active"
    }
  ],
  "note": "GaiaEx on-chain spot order book",
  "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",
  "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": [
    ["0.0523", "15000.0"],
    ["0.0522", "25000.0"]
  ],
  "asks": [
    ["0.0524", "12000.0"],
    ["0.0525", "18000.0"]
  ],
  "timestamp": 1743508800000
}

Bids are sorted descending (highest first)
Asks are sorted ascending (lowest first)
Format: [price, size]