List Accounts

List trading accounts.

Endpoint

GET /api/v3/tradingAccount/list

Description

Retrieves a list of all trading accounts belonging to the authenticated user, with optional filtering.

Authentication

Requires Bearer token authentication.

Authorization: Bearer {access_token}

Request Parameters

Parameter	Type	Required	Description
tradingAccountId	string	No	Filter by specific account ID
venue	string	No	Filter by exchange venue
status	string	No	Filter by status (ACTIVE, DISABLED, DISCONNECTED)
limit	integer	No	Maximum results (default: 10, max: 100)
offset	integer	No	Number of results to skip

Response

Returns an array of trading account objects.

Field	Type	Description
tradingAccountId	string	Unique trading account identifier
userId	string	User ID
venue	string	Exchange venue
name	string	Trading account name
accountType	string	Account type (SPOT, MARGIN, FUTURES)
status	string	Account status
createdAt	integer	Creation timestamp (milliseconds)
updatedAt	integer	Last update timestamp (milliseconds)

Usage

import requests

headers = {"Authorization": f"Bearer {access_token}"}

# List all trading accounts
response = requests.get(
    "https://cadenza-api-uat.algo724.com/api/v3/tradingAccount/list",
    headers=headers
)

accounts = response.json()["data"]
for account in accounts:
    print(f"{account['venue']}: {account['name']} ({account['status']})")

# List only active Binance accounts
response = requests.get(
    "https://cadenza-api-uat.algo724.com/api/v3/tradingAccount/list",
    headers=headers,
    params={
        "venue": "BINANCE",
        "status": "ACTIVE"
    }
)

curl "https://cadenza-api-uat.algo724.com/api/v3/tradingAccount/list?venue=BINANCE&status=ACTIVE" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Example Response

{
  "data": [
    {
      "tradingAccountId": "550e8400-e29b-41d4-a716-446655440000",
      "userId": "user-uuid-here",
      "venue": "BINANCE",
      "name": "My Binance Account",
      "accountType": "SPOT",
      "status": "ACTIVE",
      "createdAt": 1703052635110,
      "updatedAt": 1703052635110
    },
    {
      "tradingAccountId": "550e8400-e29b-41d4-a716-446655440001",
      "userId": "user-uuid-here",
      "venue": "COINBASE",
      "name": "My Coinbase Account",
      "accountType": "SPOT",
      "status": "ACTIVE",
      "createdAt": 1703052600000,
      "updatedAt": 1703052600000
    }
  ],
  "success": true,
  "errno": 0,
  "error": null,
  "pagination": {
    "offset": 0,
    "limit": 10,
    "total": 2
  }
}

Error Responses

HTTP Code	Error	Description
400	Invalid request	Invalid parameter values
401	Unauthorized	Invalid or expired access token

Notes

• Only trading accounts owned by the authenticated user are returned
• Use the tradingAccountId for trading operations and portfolio queries
• Accounts with status DISCONNECTED are no longer usable for trading
• Use pagination for users with many trading accounts