# GaiaEx — Official LLM & AI Agent Documentation Index (/llms.txt)

> GaiaEx (https://www.gaiaex.com) is an AI-native 100% self-custody crypto derivatives, spot, and RWA exchange built on Hyperliquid L1 (USDC clearinghouse) and Aster DEX (USDT clearinghouse).
> All public and authenticated REST endpoints are served from `https://openapi.gaiaex.com` following the GaiaEx Unified Futures (`/fapi/v1`, `/fapi/v2`) and Spot (`/sapi/v1`) standard.

## AI Coding Agent Skill Packs (1-Click Context)
- [Claude Code Skill (SKILL.md)](https://www.gaiaex.com/ai/claude-skill.md): Drop-in `SKILL.md` for Claude Code CLI & desktop agents.
- [OpenAI Codex Guide (AGENTS.md)](https://www.gaiaex.com/ai/codex-agents.md): Drop-in `AGENTS.md` for OpenAI Codex CLI & autonomous coding agents.
- [Google Antigravity Spec (AGY.md)](https://www.gaiaex.com/ai/antigravity-agy.md): Drop-in `AGY.md` for Antigravity (`agy`) & Gemini agents.
- [OpenAPI 3.0 Specification](https://www.gaiaex.com/openapi.json): Full machine-readable OpenAPI 3.0 schema.
- [Postman Collection v2.1](https://www.gaiaex.com/gaiaex-postman-collection.json): Pre-configured Postman collection for all endpoints.

## Core Documentation Pages
- [API Overview](https://www.gaiaex.com/en_US/docs/overview): Architecture, dual clearinghouse routing (`*USDC` on Hyperliquid, `*USDT` on Aster), and base URLs.
- [General Info & Authentication](https://www.gaiaex.com/en_US/docs/general-info): `X-MBX-APIKEY` header, `HMAC-SHA256` query signing, timestamps, and rate limits.
- [Quick Start Guide](https://www.gaiaex.com/en_US/docs/quick-start): First public request and first authenticated order in Python, JavaScript, and cURL.
- [Perp Market Data (/fapi/v1)](https://www.gaiaex.com/en_US/docs/perp-market-data): `/fapi/v1/ping`, `/fapi/v1/time`, `/fapi/v1/exchangeInfo`, `/fapi/v1/depth`, `/fapi/v1/klines`, `/fapi/v1/ticker/24hr`, `/fapi/v1/premiumIndex`, `/fapi/v1/fundingRate`.
- [Perp Trade Execution (/fapi/v1)](https://www.gaiaex.com/en_US/docs/perp-trade): `POST /fapi/v1/order`, `DELETE /fapi/v1/order`, `POST /fapi/v1/batchOrders`, `POST /fapi/v1/leverage`, `POST /fapi/v1/marginType`.
- [Perp Account & Portfolio (/fapi/v2)](https://www.gaiaex.com/en_US/docs/perp-account): `GET /fapi/v2/balance`, `GET /fapi/v2/account`, `GET /fapi/v2/positionRisk`, `GET /fapi/v1/userTrades`, `GET /fapi/v1/income`.
- [Spot Market Data & Execution (/sapi/v1)](https://www.gaiaex.com/en_US/docs/spot-market-data): `GET /sapi/v1/depth`, `GET /sapi/v1/klines`, `POST /sapi/v1/order`.
- [AI Agent Integration Guide](https://www.gaiaex.com/en_US/docs/ai-integration): Bounded self-custody permissions, IP whitelisting, and async WebSocket loops.
- [Error Codes Reference](https://www.gaiaex.com/en_US/docs/error-codes): `-1022 INVALID_SIGNATURE`, `-1121 INVALID_SYMBOL`, `-2019 MARGIN_NOT_SUFFICIENCE`, and rate-limit recovery.