Exchange (CEX) API

Endpoints for centralized exchange integration.

Endpoints

Get Exchange List

Retrieve the list of supported centralized exchanges.

Response:

{
  "exchanges": [
    {
      "name": "Binance",
      "image": "https://...",
      "logoUrl": "https://..."
    },
  ]
}

---

Connect Exchange Account

Link a centralized exchange account using API keys.

Request Body:

{
  "email": "user@example.com",
  "exchangeKeys": {
    "binance": {
      "apiKey": "your-api-key",
      "apiSecret": "your-api-secret"
    }
  }
}

caution

Only use API keys with read and spot trading permissions. Never provide withdrawal-enabled keys.

---

Get Exchange Transactions

Retrieve order history from connected exchanges.

Response Fields:

Field	Type	Description
orderId	string	Exchange order ID
symbol	string	Trading pair (e.g., BTC/USDT)
price	number	Order execution price
amount	number	Order quantity
type	string	Order type (MARKET, LIMIT)
side	string	BUY or SELL
time	number	Timestamp in milliseconds