GET

/api/v1/exchanges

Permission: EXCHANGES_READSecurity: SIGNED

Returns the array of exchange accounts and API connections currently connected to the user's account with verification status, trading permissions, and connection types.

Query Parameters

exchangestring optional

Optional filter for accounts matching a specific exchange code (e.g. 'binance', 'bybit').

Example Request

GETGET /api/v1/exchanges

Response Parameters

Array of Account Entities

If successful, the response returns an array of Exchange Connection entities detailing the connected exchanges, trading permissions, and operational status.

View Account Entity Spec

Example Response

connected_exchanges_response.json

200 OK

[
  {
    "id": "7fa84b80-77a8-4e89-a292-123456789abc",
    "exchange": "binance",
    "label": "My Main Binance Account",
    "connection_type": "spot",
    "can_trade": true,
    "can_withdraw": false,
    "is_active": true,
    "is_testnet": false,
    "last_verified": "2026-08-20T23:25:00.000Z",
    "last_error": null,
    "created_at": "2026-08-20T23:25:00.000Z"
  },
  {
    "id": "8bc95c91-88b9-5f90-b303-234567890def",
    "exchange": "bybit",
    "label": "Bybit Futures Connection",
    "connection_type": "futures",
    "can_trade": true,
    "can_withdraw": false,
    "is_active": true,
    "is_testnet": false,
    "last_verified": "2026-08-20T23:26:00.000Z",
    "last_error": null,
    "created_at": "2026-08-20T23:26:00.000Z"
  }
]

Previous Edit exchange account NextActive trading entities