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",
      "priceDecimals": 1,
      "currentPrice": "67500.0"
    },
    {
      "symbol": "xyz:AAPL",
      "displayName": "Apple Inc.",
      "assetClass": "equity",
      "maxLeverage": 10,
      "marginMode": "cross",
      "tradingHours": "US market hours",
      "deployer": "xyz",
      "priceDecimals": 2,
      "currentPrice": "212.50"
    },
    {
      "symbol": "vntl:OPENAI",
      "displayName": "OpenAI",
      "assetClass": "preipo",
      "maxLeverage": 3,
      "marginMode": "isolated",
      "tradingHours": "24/7",
      "deployer": "vntl",
      "priceDecimals": 2,
      "currentPrice": "150.00"
    }
  ],
  "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`, `preipo`, `index`
`priceDecimals`	int	Decimal precision for price display
`currentPrice`	string	Latest mark price
`maxLeverage`	int	Maximum allowed leverage (deployer symbols only)
`marginMode`	string	`cross` or `isolated` (deployer symbols only)
`tradingHours`	string	When the symbol can be traded (deployer symbols only)
`deployer`	string	Deployer prefix that issued the symbol — reflects the symbol prefix (`xyz`, `vntl`, `cash`). Absent for native crypto perps.

Note: Native crypto perps (e.g. BTC, ETH) do not include maxLeverage, marginMode, or tradingHours — those are deployer-only fields.

Server Time

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

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

Parameters: None

Response:

{
  "serverTime": 1743508800000
}

Health Check

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

Returns the health status of the perpetual market data service.

Parameters: None

Response:

{
  "status": "ok",
  "total_symbols": 133,
  "native_perps": 98,
  "deployer_perps": 35,
  "active_symbols": 131,
  "feed_connected": true,
  "upstream_healthy": true,
  "timestamp": 1743508800000
}

Note: status is one of "ok", "degraded", or "error".