Skip to main content
POST /api/v1/account/subaccount/list

​
Request Body

FieldTypeNeedDescriptionExample
”account”stringrequiredMain account wallet address42trU9A5…
“signature”stringrequiredMain account signature5j1Vy9Uq…
“timestamp”integerrequiredCurrent timestamp in milliseconds1716200000000
”agent_wallet”stringoptionalAgent wallet address69trU9A5…
“expiry_window”integeroptionalSignature expiry in milliseconds30000
{
  "account": "42txU9As...",
  "signature": "5j1Vy9Uq...",
  "timestamp": 1716200000000,
  "expiry_window": 30000
}

​
Response

  • Status 200: Subaccounts listed successfully
{
  "success": true,
  "data": {
    "subaccounts": [
      {
        "address": "69txU9As...",
        "balance": "1000.50",
        "pending_balance": "0.00",
        "fee_level": 1,
        "fee_mode": "auto",
        "created_at": 1716200000000,
        "nickname": "Trading Bot"
      }
    ]
  },
  "error": null,
  "code": null
}
FieldTypeDescription
'address'stringCurrent account balance, defined as amount of USD in account before settlement
'balance'decimal stringSubaccount balance in USD
'pending_balance'decimal stringAmount of subaccount balance in pending status (deposit request is successful, waiting on confirmation)
'fee_level'integerCurrent fee tier of account, determined by trading volume
'fee_mode'string"auto" by default
'created_at'integerCreation timestamp in milliseconds
'nickname'string or nullOptional subaccount nickname (omitted when not set)
  • Status 400: Bad request
{
  "success": false,
  "data": null,
  "error": "Invalid signature format",
  "code": null
}
  • Status 401: Unauthorized
{
  "success": false,
  "data": null,
  "error": "Signature verification failed",
  "code": null
}