GaiaEx API Platform Overview

Everything you need to go from zero to a live order via the API.

1. Download the GaiaEx mobile app — iOS or Android.
2. Open an account — one tap. Account setup happens in-app; no paperwork, no waiting.
3. Deposit USDC on Arbitrum — send USDC from any Arbitrum wallet to the deposit address the app shows. Minimum 5 USDC. Funds are credited in 1–5 minutes.
4. Create an API key — Settings → API Keys → Create. Give it read + trade permission. Copy the api_key and api_secret into a config.json file next to your script:

{
  "api_key":      "your_api_key_here",
  "api_secret":   "your_api_secret_here",
  "user_address": "0xYourWalletAddress"
}

That's it — you're trading-ready. The three-line Python snippet below authenticates and fetches your balance. If it returns a number, you can place your first order (see Quick Start).

import hmac, hashlib, time, json, requests

cfg = json.load(open("config.json"))
ts  = str(int(time.time() * 1000))
path = f"/user/{cfg['user_address']}/balance"
sig  = hmac.new(cfg["api_secret"].encode(), (ts + "GET" + path).encode(), hashlib.sha256).hexdigest()

r = requests.get(
    f"https://openapi.gaiaex.com/v1/trade{path}",
    headers={
        "X-GAIAEX-APIKEY":    cfg["api_key"],
        "X-GAIAEX-TIMESTAMP": ts,
        "X-GAIAEX-SIGNATURE": sig,
    },
)
print(r.json())

GaiaEx is a non-custodial Web3 trading interface that provides secure, high-performance access to decentralized digital asset markets.

Through GaiaEx, users trade perpetual futures and spot markets on a fully on-chain order book. All orders, cancellations, trades, and liquidations settle directly on-chain with single-block finality. Users retain control of their private keys at all times — GaiaEx never takes custody of funds.

GaiaEx was founded to address two fundamental challenges in digital asset markets: trust and execution efficiency.

We believe the future of digital finance is built on decentralized infrastructure — where users maintain control, transparency is inherent, and transactions settle directly on blockchain networks without reliance on centralized intermediaries.

Our mission is to support a decentralized digital asset environment where:

• Users maintain full control of their assets — non-custodial architecture with MPC key protection
• Transactions are transparent and verifiable — all settlement occurs on public blockchain networks
• Execution is efficient and accessible — high-performance order matching with sub-second finality
• Infrastructure is resilient and secure — no single point of failure, encrypted communications, session-based access controls

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

Authentication

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

Public market data endpoints require no authentication.

What You Can Build

• Trading bots — place, cancel, and modify orders; set leverage and TP/SL
• 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 history
• Wallet read integrations — portfolio tracking and swap-route previews (read-only; quote endpoints return prices and routes for display)

Perpetual Futures

USDC-margined perpetuals on a fully on-chain order book. Leverage limits are set per symbol and published via GET /symbols/list. Symbols use plain uppercase tickers for crypto and prefixed tickers for other asset classes:

Use GET /v1/trade/symbols/list for the complete, up-to-date symbol list with max leverage and tick sizes.

Spot Markets

On-chain spot trading with direct token settlement. Symbols follow the TOKEN/USDC format (e.g., PURR/USDC, HYPE/USDC).

Use GET /v1/market/spot/symbols/list for available spot pairs.

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

Trading collateral is USDC. Deposits are accepted via USDC on Arbitrum and bridged to the trading environment. The backend handles all internal collateral conversions transparently — users only interact with USDC.

• 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, 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 — give Claude or GPT these same tools via MCP. The agent trades within the API key's scope; it cannot move funds.