Spot Account Management

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

Overview

All spot account endpoints require authentication.

GET20/s IPhttps://openapi.gaiaex.com/v1/trade/spot/balance/{address}HMAC

Get Spot Balance

GET https://openapi.gaiaex.com/v1/trade/spot/balance/{address}

Returns spot token balances for the user.

Path Parameters:

Parameter	Type	Description
`address`	string	User's wallet address

Response:

{
  "address": "0xYourAddress",
  "balances": [
    {
      "coin": "USDC",
      "total": "500.00",
      "hold": "50.00",
      "available": "450.00"
    },
    {
      "coin": "PURR",
      "total": "10000.0",
      "hold": "0.0",
      "available": "10000.0"
    }
  ],
  "unified_mode": true,
  "count": 2,
  "timestamp": 1743508800000
}

Field	Type	Description
`coin`	string	Token name
`total`	string	Total balance
`hold`	string	Amount reserved in open orders
`available`	string	Available for trading or withdrawal
`unified_mode`	boolean	Whether Unified Account mode is active

Parameters

Name	Type	Required	Description
address	string	Yes	Wallet address

address

stringRequired

Wallet address

GET20/s IPhttps://openapi.gaiaex.com/v1/trade/spot/openOrders/{address}HMAC

Get Spot Open Orders

GET https://openapi.gaiaex.com/v1/trade/spot/openOrders/{address}

Returns all open spot orders.

Path Parameters:

Parameter	Type	Description
`address`	string	User's wallet address

Response:

{
  "address": "0xYourAddress",
  "orders": [
    {
      "orderId": 555666777,
      "symbol": "PURR/USDC",
      "side": "BUY",
      "type": "LIMIT",
      "origQty": "1000",
      "price": "0.0500",
      "status": "NEW",
      "time": 1743508800000
    }
  ],
  "count": 1,
  "timestamp": 1743508800000
}

Parameters

Name	Type	Required	Description
address	string	Yes	Wallet address

address

stringRequired

Wallet address

GET20/s IPhttps://openapi.gaiaex.com/v1/trade/spot/fills/{address}HMAC

Get Spot Fills

GET https://openapi.gaiaex.com/v1/trade/spot/fills/{address}

Returns recent spot trade fills.

Path Parameters:

Parameter	Type	Description
`address`	string	User's wallet address

Query Parameters:

Parameter	Type	Default	Description
`limit`	int	100	Number of fills to return

Response:

{
  "address": "0xYourAddress",
  "fills": [
    {
      "coin": "PURR/USDC",
      "px": "0.0523",
      "sz": "1000",
      "side": "B",
      "time": 1743508800000,
      "fee": "0.01831"
    }
  ],
  "count": 1,
  "timestamp": 1743508800000
}

Parameters

Name	Type	Required	Description
address	string	Yes	Wallet address

address

stringRequired

Wallet address

Get Unified Wallet

GET https://openapi.gaiaex.com/v1/trade/user/{address}/wallet

Returns a unified view of both perpetual and spot balances.

Path Parameters:

Parameter	Type	Description
`address`	string	User's wallet address

Response:

{
  "address": "0xYourAddress",
  "unified_mode": true,
  "perps": {
    "usdc_balance": "1000.00",
    "available": "850.00",
    "unrealized_pnl": "12.50",
    "margin_used": "150.00"
  },
  "spot": {
    "balances": [
      {
        "coin": "USDC",
        "total": "500.00",
        "hold": "0.00",
        "available": "500.00"
      }
    ]
  },
  "timestamp": 1743508800000
}