Перейти до вмісту
HTTP APIРахунок

Баланси

Зібрати запит

Змінюйте значення — команда змінюється слідом. Токен тут не вводиться: команда бере його зі змінної оточення SPECTRE_LOCAL_API_TOKEN. Запускайте її у своєму командному рядку.

Команда
curl 'http://127.0.0.1:48180/v1/account/balances?connection_id=12' \
  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"
GET
/account/balances

Останнє значення, яке біржа надіслала для кожної валюти відтоді, як увімкнено API. Біржа надсилає баланс лише тоді, коли він змінюється, тому валюти, яка відтоді не змінювалася, немає. available і locked дорівнюють null, якщо біржа їх не повідомляє. ts — час біржі, а якщо його немає — час отримання.

Авторизація

bearerToken account:read
headerАвторизаціяBearer <token>

Токен Local API: spt_ і 64 шістнадцяткові символи. Скопіюйте його в Settings App → Загальні → Local API. Він приймається лише в заголовку Authorization. Назви, перелічені біля операції, — це права, яких вона потребує. Токен термінала має їх усі.

Право: account:read

Параметри запиту

connection_id*integer

Підключення, рахунок якого читати.

Форматint64

Тіло відповіді

Баланси підключення.

application/json
  1. response
connection_id*integer
Форматint64
data*array<>
Приклад запиту
curl 'http://127.0.0.1:48180/v1/account/balances?connection_id=12' \  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"
Приклад відповіді
{  "connection_id": 12,  "data": [    {      "currency": "USDT",      "total": "1000.5",      "available": "900.5",      "locked": "100",      "ts": 1730294400123    }  ]}