API Changelog & Version History

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

Documentation

• Added this Changelog page
• 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

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)

• 155+ REST endpoints across 5 services (market data, trading, public API, wallet, admin)
• 5 WebSocket streams: 3 public (perp market, spot market, USDT market), 1 private (user data), 1 wallet
• HMAC-SHA256 and Bearer session authentication
• 167+ perpetual symbols (133 USDC-margined + 34 USDT-margined perps; crypto, RWA, ventures)
• Spot trading with 50+ tokens
• Calculator utility endpoints (PnL, liquidation, target price, max open, average entry)