Perpetual Futures Market Data

Fetch real-time perpetual futures market data on GaiaEx: funding rates, mark prices, open interest, and order books.

List All Symbols

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

Returns all tradable perpetual symbols with their metadata.

Parameters: None

Response:

{
  "symbols": [
    {
      "symbol": "BTC",
      "assetClass": "crypto",
      "maxLeverage": 100,
      "marginMode": "cross",
      "tradingHours": "24/7"
    },
    {
      "symbol": "xyz:AAPL",
      "displayName": "Apple Inc.",
      "assetClass": "equity",
      "maxLeverage": 20,
      "marginMode": "isolated",
      "tradingHours": "US market hours",
      "deployer": "xyz"
    },
    {
      "symbol": "vntl:OPENAI",
      "displayName": "OpenAI",
      "assetClass": "venture",
      "maxLeverage": 5,
      "marginMode": "isolated",
      "tradingHours": "24/7",
      "deployer": "vntl"
    }
  ],
  "count": 133,
  "timestamp": 1743508800000
}

Symbol object fields:

Field	Type	Description
`symbol`	string	Trading symbol (e.g., `BTC`, `xyz:GOLD`)
`displayName`	string	Human-readable name (deployer symbols only)
`assetClass`	string	`crypto`, `equity`, `commodity`, `forex`, `venture`, `index`
`maxLeverage`	int	Maximum allowed leverage
`marginMode`	string	`cross` or `isolated`
`tradingHours`	string	When the symbol can be traded
`deployer`	string	Deployer dex name, if applicable (`xyz`, `vntl`, `cash`)

Server Time

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

Returns the server's current timestamp. Use this to synchronize your local clock for HMAC signature generation.

Parameters: None

Response:

{
  "serverTime": 1743508800000
}

Health Check

GET https://openapi.gaiaex.com/v1/trade/health

Returns the health status of all backend services.

Parameters: None

Response:

{
  "status": "healthy",
  "services": {
    "trading": "ok",
    "database": "ok",
    "market_data": "ok",
    "candle_data": "ok"
  },
  "fee_rate": "0.00035",
  "serverTime": 1743508800000
}