GaiaExGaiaEx
API

API Changelog & Version History

GaiaEx API changelog — new endpoints, breaking changes, deprecations, and version history with dates.

Overview

This page tracks notable changes to the GaiaEx API, documentation, and WebSocket streams. Subscribe to our announcements channel for advance notice of breaking changes.

VERSIONING

The GaiaEx API uses URL-based versioning (/v1/trade). Breaking changes will be introduced under a new version prefix (e.g. /v2/trade) with a deprecation window for the previous version.

2026-04-04 — Documentation Overhaul

Documentation

  • Added this Changelog page
  • Added Testnet environment placeholder (Coming Q3 2026)
  • Moved Calculator endpoints from API Reference to Reference section as "Formulas & Calculations" — added offline computation formulas for PnL, liquidation price, target price, max open position, and average entry
  • Updated Quick Start — API keys are now created exclusively via the GaiaEx mobile app (Settings > API Keys)
  • Expanded Rate Limits documentation — added IP-level limits, Retry-After header details, ban escalation policy, WebSocket recommendation
  • Added HTTP 502/503 retry guidance with unknown execution status warnings for order endpoints

API

  • Fixed POST /calculator/open-price — request example corrected to use entry_price/quantity fields (was incorrectly price/size)
  • Fixed HMAC auth headers in generated code examples — now correctly uses X-GAIAEX-APIKEY, X-GAIAEX-TIMESTAMP, X-GAIAEX-SIGNATURE across all 10 languages
  • Fixed code generator to properly handle DELETE and PATCH HTTP methods
  • Fixed Nginx WebSocket rewrite for /wallet/ location on ws.gaiaex.com

2026-03-31 — API Documentation Launch

Documentation

  • Launched API documentation at https://www.gaiaex.com/en_US/docs
  • 18 documentation pages covering REST, WebSocket, and account management
  • Interactive code panel with 10-language code generation
  • Live "Send API Request" testing for public endpoints

API (v1)

  • 44 REST endpoints (12 public, 32 private)
  • 4 WebSocket streams (2 public, 2 private)
  • HMAC-SHA256 and Bearer session authentication
  • 130+ perpetual symbols (crypto, RWA, ventures)
  • Spot trading with 50+ tokens
  • Calculator utility endpoints (PnL, liquidation, target price, max open, average entry)