Spot Account Management

API reference for GaiaEx spot accounts: asset balances, deposit and withdrawal history, and account configuration.

AI AGENT READYEquip Claude Code, OpenAI Codex & Antigravity (`agy`) with Official GaiaEx Skills

CLAUDE CODESKILL.md

Claude SKILL.md

Drop-in Claude Code skill with HMAC-SHA256 signing, /fapi/v1 & /fapi/v2 schemas, and secret-redaction guardrails.

Raw ↗

OPENAI CODEXAGENTS.md

Codex AGENTS.md

Drop-in repository AGENTS.md for OpenAI Codex CLI — tick-size rules, rate-limit budgets, and self-custody boundaries.

Raw ↗

ANTIGRAVITYAGY.md

Antigravity AGY.md

Google Antigravity (agy) & Gemini agent spec with verified async Python WebSocket + REST execution templates.

Raw ↗

UNIVERSAL LLMllms.txt

/llms.txt Index

Single-URL machine-readable index of all GaiaEx documentation pages, OpenAPI 3.0 schema, and Postman collection.

Raw ↗

Overview

Spot Account endpoints follow the GaiaEx Spot API standard under https://openapi.gaiaex.com/sapi/v1/* and https://openapi.gaiaex.com/api/v3/*.

All endpoints require the X-MBX-APIKEY header and an HMAC-SHA256 signature + timestamp query parameter. Your account wallet is automatically resolved from the API key.

GET20/s IPhttps://openapi.gaiaex.com/sapi/v1/accountHMAC

Spot Account Information & Balances (USER_DATA)

GET https://openapi.gaiaex.com/sapi/v1/account (or /api/v3/account)

Get current spot account information and token balances (free and locked).

Parameters:

Name	Type	Mandatory	Description
`recvWindow`	LONG	NO	Max `60000` (default `5000`)
`timestamp`	LONG	YES	Current timestamp in milliseconds
`signature`	STRING	YES	`HMAC-SHA256` signature

Response:

{
  "makerCommission": 15,
  "takerCommission": 45,
  "canTrade": true,
  "canWithdraw": false,
  "canDeposit": true,
  "updateTime": 1743508800000,
  "accountType": "SPOT",
  "balances": [
    {
      "asset": "USDC",
      "free": "450.00000000",
      "locked": "50.00000000"
    },
    {
      "asset": "PURR",
      "free": "10000.00000000",
      "locked": "0.00000000"
    }
  ]
}

Parameters

Name	Type	Required	Description
timestamp	int	Yes	Request timestamp in ms
signature	string	Yes	HMAC-SHA256 signature

timestamp

intRequired

Request timestamp in ms

signature

stringRequired

HMAC-SHA256 signature

GET20/s IPhttps://openapi.gaiaex.com/sapi/v1/openOrdersHMAC

Current Open Spot Orders (USER_DATA)

GET https://openapi.gaiaex.com/sapi/v1/openOrders (or /api/v3/openOrders)

Get all open spot orders on a symbol or across all spot pairs.

Parameters:

Name	Type	Mandatory	Description
`symbol`	STRING	NO	Spot pair (omit for all open spot orders)
`timestamp`	LONG	YES	Current timestamp in milliseconds
`signature`	STRING	YES	`HMAC-SHA256` signature

Response:

[
  {
    "symbol": "PURRUSDC",
    "orderId": 555666777,
    "clientOrderId": "spot_order_1",
    "price": "0.0500",
    "origQty": "1000",
    "executedQty": "0",
    "status": "NEW",
    "timeInForce": "GTC",
    "type": "LIMIT",
    "side": "BUY",
    "time": 1743508800000,
    "updateTime": 1743508800000
  }
]

Parameters

Name	Type	Required	Description
symbol	string	No	Spot symbol (omit for all)
timestamp	int	Yes	Request timestamp in ms
signature	string	Yes	HMAC-SHA256 signature

symbol

stringOptional

Spot symbol (omit for all)

timestamp

intRequired

Request timestamp in ms

signature

stringRequired

HMAC-SHA256 signature

GET20/s IPhttps://openapi.gaiaex.com/sapi/v1/myTradesHMAC

Spot Account Trade List (USER_DATA)

GET https://openapi.gaiaex.com/sapi/v1/myTrades (or /api/v3/myTrades)

Get trades for a specific spot account and symbol.

Parameters:

Name	Type	Mandatory	Description
`symbol`	STRING	YES	Spot pair (e.g. `PURRUSDC`)
`limit`	INT	NO	Default `500`; max `1000`
`timestamp`	LONG	YES	Current timestamp in milliseconds
`signature`	STRING	YES	`HMAC-SHA256` signature

Response:

[
  {
    "symbol": "PURRUSDC",
    "id": 28457,
    "orderId": 555666777,
    "price": "0.0523",
    "qty": "1000",
    "quoteQty": "52.30",
    "commission": "0.01831",
    "commissionAsset": "USDC",
    "time": 1743508800000,
    "isBuyer": true,
    "isMaker": false
  }
]

Parameters

Name	Type	Required	Description
symbol	string	Yes	Spot symbol (e.g. PURRUSDC)
timestamp	int	Yes	Request timestamp in ms
signature	string	Yes	HMAC-SHA256 signature

symbol

stringRequired

Spot symbol (e.g. PURRUSDC)

timestamp

intRequired

Request timestamp in ms

signature

stringRequired

HMAC-SHA256 signature