Exchange V2 · Whale Docs

POSThttps://b-api.longbridge.xyz/v1/risk_monitoring/exchange_v2

Authorization

AuthorizationstringheaderRequired

Send the Broker ACCESS_TOKEN as Authorization: Bearer <token>.

Request body application/json

aaidnumberrequired

Account ID. Programmatically derived by the front end from the selected record's record.aaid_val; not a form-editable field.

exchange_booksarray<string>required

Exchange Books. Array of dynamic FX rows; multiple exchange records can be added. See the sub-fields of exchange_books (from_currency, etc.) for each row's structure.

exchange_books.from_currencystringrequired

From Currency. A dropdown whose options are the currencies held in the client's cash books (cash_books).

exchange_books.to_currencystringrequired

To Currency. A dropdown; options come from global_currency_which_support_exchange.

exchange_books.from_amountstring

From Amount. Submit either from_amount or to_amount: the field the user edited last is kept, while the other is computed from the exchange rate and dropped by the front end.

exchange_books.to_amountstring

To Amount. Same as from_amount; the two are mutually exclusive and only one is submitted.

Responses

HTTP 200No confirmable field definitions are available for the response yet.

Standard response envelopecodemessagedata

dataobjectdata structure

No nested fields

Request

curl --request POST \
  --url 'https://b-api.longbridge.xyz/v1/risk_monitoring/exchange_v2' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json'
  --data '{
  "aaid": 10086,
  "exchange_books": [
    {
      "from_currency": "USD",
      "to_currency": "HKD",
      "from_amount": "100.00"
    }
  ]
}'

Response

{
  "code": 0,
  "message": null,
  "data": {}
}