GaiaEx API Platform Overview

Everything you need to go from zero to a live order via the GaiaEx Unified Futures API (/fapi/v1 & /fapi/v2).

1. Download the GaiaEx mobile app — iOS or Android.
2. Open an account — one tap. Account setup and the EIP-712 wallet handshake happen in-app; no paperwork, no waiting. This step is required once and cannot be completed via the API.
3. Deposit collateral:
   • USDC margin: fund your USDC balance from the GaiaEx app. Minimum 5 USDC. Funds are credited in 1–5 minutes.
   • USDT margin: fund your USDT balance from the GaiaEx app. USDC and USDT are independent margin balances.
4. Create an API key — Settings → API Keys → Create. This step requires a passkey step-up in the app and cannot be automated via the REST API (bots cannot self-issue keys). Give the key read + trade permission. Copy the api_key and api_secret, then export them as environment variables:

export GAIAEX_API_KEY="your_api_key_here"
export GAIAEX_API_SECRET="your_api_secret_here"

That's it — you're trading-ready. Your wallet address is automatically resolved server-side from your API key, so standard quantitative SDKs (ccxt, Python, TypeScript, Rust) and bots never need to pass a wallet address. The snippet below authenticates with X-MBX-APIKEY and fetches your futures balances via GET /fapi/v2/balance. If it returns your balance array, you can place your first order (see Quick Start).

import hmac, hashlib, time, os, requests

api_key    = os.environ["GAIAEX_API_KEY"]
api_secret = os.environ["GAIAEX_API_SECRET"]

query = f"timestamp={int(time.time() * 1000)}&recvWindow=5000"
sig   = hmac.new(api_secret.encode(), query.encode(), hashlib.sha256).hexdigest()

r = requests.get(
    f"https://openapi.gaiaex.com/fapi/v2/balance?{query}&signature={sig}",
    headers={"X-MBX-APIKEY": api_key},
)
print(r.json())

GaiaEx is a self-custody derivatives DEX offering USDC-margined and USDT-margined perpetuals from a single GaiaEx Unified Futures API (/fapi/v1 & /fapi/v2). GaiaEx supports ~217 tradable instruments (167 perpetuals + up to 50 spot) across crypto, real-world assets (equities, commodities, forex), venture tokens, and spot markets.

All positions settle on-chain; GaiaEx never takes custody of your collateral.

How Self-Custody Works

When you first open the GaiaEx app, you sign a one-time EIP-712 structured-data message with your embedded wallet. This authorizes GaiaEx to derive an agent key — a narrowly scoped key that can submit and cancel orders on your behalf but cannot move collateral. All on-chain order settlement happens under this agent key. Your main wallet retains full custody; the agent key cannot withdraw funds.

GaiaEx routes your order to the correct margin product based on the symbol you pass — no manual switching required.

GaiaEx offers two independent margin products. Each has its own order book and margin pool. From the API's perspective you interact with both through the same /fapi/v1 and /fapi/v2 endpoints — the correct product is selected automatically based on the symbol you pass.

Separate Margin Accounts

Your USDC balance and USDT balance are completely independent margin accounts. When querying GET /fapi/v2/balance or GET /fapi/v2/account, the response includes asset rows for both USDC and USDT.

Withdrawal Paths

Withdrawals are initiated from the GaiaEx app (not available via API keys) and use an EIP-712 signature from the user's main wallet:

• USDC balance — withdraw USDC from the GaiaEx app
• USDT balance — withdraw USDT from the GaiaEx app

The GaiaEx API exposes the full trading platform through a GaiaEx Unified Futures REST API and real-time WebSocket streams.

Two Account Namespaces

Because GaiaEx has two margin products, USDC Perps (BTCUSDC, ETHUSDC, SOLUSDC) and USDT Perps (BTCUSDT, ETHUSDT, SOLUSDT) have separate margin, separate balance, and separate position state. The endpoint URL pattern is identical for both; only the symbol suffix differs.

Authentication

Two methods are supported — choose based on your use case:

Public market data endpoints (/fapi/v1/ping, /fapi/v1/time, /fapi/v1/exchangeInfo, /fapi/v1/depth, /fapi/v1/klines, /fapi/v1/ticker/24hr) require no authentication.

What You Can Build

• Trading bots & CCXT / Python SDK integrations — place, cancel, and modify orders across both USDC Perps and USDT Perps; set leverage and margin type
• Portfolio dashboards — stream positions, balances, PnL, and funding history in real time
• Market data feeds — subscribe to order book updates, candles, and ticker data
• Risk management tools — query liquidation prices, margin usage, and position risk
• Wallet read integrations — portfolio tracking and swap-route previews (read-only; quote endpoints return prices and routes for display)

USDC Perps

Perpetual futures margined in USDC. 102 crypto symbols available, up to 40x leverage, plus 31 RWA and venture symbols:

USDT Perps

Perpetual futures margined in USDT. 34 symbols covering crypto and commodities, up to 200x leverage:

Spot Markets

50 on-chain spot pairs with direct token settlement. Symbols follow the TOKEN/USDC or TOKEN/USDT format.

Symbol Summary

Use GET /fapi/v1/exchangeInfo for the complete, always-current symbol list with filters, tick sizes, precision, and margin asset.

The GaiaEx wallet supports asset management and cross-chain operations across the following networks:

Trading collateral: USDC Perps are collateralized with USDC; USDT Perps with USDT. Deposits and withdrawals are handled in the GaiaEx app — the backend manages all collateral routing transparently.

• Follow the Quick Start for a complete code cookbook — auth, balance, positions, orders, place / modify / cancel — in Python, JavaScript, Go, Rust, C++, Java, C#, and curl.
• Read General Info for base URL, X-MBX-APIKEY authentication details, HMAC signing walkthrough, timeouts, retries, and idempotency.
• Review Common Definitions for order types, symbol formats, and margin modes.
• Ready for AI? See AI Agent Integration — build an autonomous agent on top of these endpoints. The agent trades within the API key's scope; it cannot move funds.