GaiaExGaiaEx
API

Spot Market Data Endpoints

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

AI AGENT READYEquip Claude Code, OpenAI Codex & Antigravity (`agy`) with Official GaiaEx Skills
CLAUDE CODESKILL.md
Claude SKILL.md

Drop-in Claude Code skill with HMAC-SHA256 signing, /fapi/v1 & /fapi/v2 schemas, and secret-redaction guardrails.

Raw ↗
OPENAI CODEXAGENTS.md
Codex AGENTS.md

Drop-in repository AGENTS.md for OpenAI Codex CLI — tick-size rules, rate-limit budgets, and self-custody boundaries.

Raw ↗
ANTIGRAVITYAGY.md
Antigravity AGY.md

Google Antigravity (agy) & Gemini agent spec with verified async Python WebSocket + REST execution templates.

Raw ↗
UNIVERSAL LLMllms.txt
/llms.txt Index

Single-URL machine-readable index of all GaiaEx documentation pages, OpenAPI 3.0 schema, and Postman collection.

Raw ↗

Overview

Public REST endpoints for Spot Market Data following the industry-standard GaiaEx Spot API standard. No authentication is required.

All Spot Market Data endpoints are available under both https://openapi.gaiaex.com/sapi/v1/* and https://openapi.gaiaex.com/api/v3/* for 1:1 compatibility with existing Spot trading SDKs.

GET20/s IPhttps://openapi.gaiaex.com/sapi/v1/ping

Test Spot Connectivity & Check Server Time

LIVE SANDBOXhttps://openapi.gaiaex.com/sapi/v1/ping

GET https://openapi.gaiaex.com/sapi/v1/ping (or /api/v3/ping)

Test connectivity to the Spot REST API and return an empty JSON object {}.

GET https://openapi.gaiaex.com/sapi/v1/time (or /api/v3/time)

Test connectivity to the Spot REST API and get the current server time in milliseconds.

Response (/sapi/v1/time):

{
  "serverTime": 1743508800000
}
GET20/s IPhttps://openapi.gaiaex.com/sapi/v1/exchangeInfo

Spot Exchange Information

LIVE SANDBOXhttps://openapi.gaiaex.com/sapi/v1/exchangeInfo

GET https://openapi.gaiaex.com/sapi/v1/exchangeInfo (or /api/v3/exchangeInfo)

Returns current spot exchange trading rules and all listed spot pairs.

Query Parameters:

ParameterTypeRequiredDescription
symbolstringNoFilter by a single spot symbol (e.g. BTCUSDC)

Response:

{
  "timezone": "UTC",
  "serverTime": 1743508800000,
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 1200
    }
  ],
  "symbols": [
    {
      "symbol": "BTCUSDC",
      "status": "TRADING",
      "baseAsset": "BTC",
      "baseAssetPrecision": 5,
      "quoteAsset": "USDC",
      "quotePrecision": 2,
      "orderTypes": ["LIMIT", "MARKET"],
      "isSpotTradingAllowed": true,
      "filters": [
        { "filterType": "PRICE_FILTER", "tickSize": "0.1" },
        { "filterType": "LOT_SIZE", "stepSize": "0.00001" }
      ]
    }
  ]
}
GET20/s IPhttps://openapi.gaiaex.com/sapi/v1/depth

Spot Order Book

LIVE SANDBOXhttps://openapi.gaiaex.com/sapi/v1/depth?symbol=BTCUSDC&limit=5

GET https://openapi.gaiaex.com/sapi/v1/depth (or /api/v3/depth)

Returns the L2 order book for a spot trading pair.

Query Parameters:

ParameterTypeRequiredDescription
symbolstringYesSpot symbol (e.g. BTCUSDC, ETHUSDC)
limitintNoNumber of price levels per side (default 20, max 50)

Response:

{
  "lastUpdateId": 1743508800000,
  "bids": [
    ["82779.0", "0.50000"],
    ["82778.0", "1.25000"]
  ],
  "asks": [
    ["82781.0", "0.80000"],
    ["82782.0", "1.40000"]
  ]
}

Parameters

symbol
stringRequired

Spot symbol (e.g. BTCUSDC, PURRUSDC)

limit
intOptional

Levels per side (default 20, max 50)

GET20/s IPhttps://openapi.gaiaex.com/sapi/v1/trades

Recent Spot Trades List

LIVE SANDBOXhttps://openapi.gaiaex.com/sapi/v1/trades?symbol=BTCUSDC&limit=5

GET https://openapi.gaiaex.com/sapi/v1/trades (or /api/v3/trades)

Returns recent spot market trades.

Query Parameters:

ParameterTypeRequiredDescription
symbolstringYesSpot symbol (e.g. BTCUSDC)
limitintNoDefault 100; max 500

Response:

[
  {
    "id": 137712400774055,
    "price": "82780.0",
    "qty": "0.01500",
    "quoteQty": "1241.70",
    "time": 1743508800000,
    "isBuyerMaker": false,
    "isBestMatch": true
  }
]

Parameters

symbol
stringRequired

Spot symbol (e.g. PURRUSDC)

limit
intOptional

Default 100; max 500

GET20/s IPhttps://openapi.gaiaex.com/sapi/v1/klines

Spot Kline/Candlestick Data

LIVE SANDBOXhttps://openapi.gaiaex.com/sapi/v1/klines?symbol=BTCUSDC&interval=1h

GET https://openapi.gaiaex.com/sapi/v1/klines (or /api/v3/klines)

Returns OHLCV candlestick bars for a spot symbol across all 9 intervals (1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w, 1M).

Query Parameters:

ParameterTypeRequiredDescription
symbolstringYesSpot symbol (e.g. BTCUSDC)
intervalstringYes1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w, 1M
startTimeintNoStart time in ms
endTimeintNoEnd time in ms
limitintNoDefault 500; max 1500

Response:

[
  [
    1743508800000,
    "82777.0",
    "82785.0",
    "82727.0",
    "82780.0",
    "3.76363",
    1743508859999,
    "311353.81",
    0,
    "1.8818",
    "155676.90",
    "0"
  ]
]

Parameters

symbol
stringRequired

Spot symbol (e.g. BTCUSDC)

interval
stringRequired

1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w, 1M

GET20/s IPhttps://openapi.gaiaex.com/sapi/v1/ticker/24hr

Spot 24hr Ticker & Symbol Price Ticker

LIVE SANDBOXhttps://openapi.gaiaex.com/sapi/v1/ticker/24hr?symbol=BTCUSDC

GET https://openapi.gaiaex.com/sapi/v1/ticker/24hr & GET /sapi/v1/ticker/price

Returns 24-hour rolling price change statistics or the latest price for one or all spot pairs.

Query Parameters:

ParameterTypeRequiredDescription
symbolstringNoSpot symbol (omit for all listed spot pairs)

Response (/sapi/v1/ticker/24hr):

{
  "symbol": "BTCUSDC",
  "priceChange": "1250.0",
  "priceChangePercent": "1.53",
  "lastPrice": "82780.0",
  "bidPrice": "82779.0",
  "askPrice": "82781.0",
  "highPrice": "83100.0",
  "lowPrice": "81200.0",
  "volume": "1250.00",
  "quoteVolume": "103475000.00",
  "openTime": 1743422400000,
  "closeTime": 1743508800000
}

Parameters

symbol
stringOptional

Spot symbol (e.g. BTCUSDC, PURRUSDC)