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

Відкриті позиції

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

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

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

Відкриті позиції підключення. unrealized_pnl і mark_price обчислює термінал. mark_price — це найкращий bid для лонга і найкращий ask для шорта.

Авторизація

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/positions?connection_id=12' \  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"
Приклад відповіді
{  "connection_id": 12,  "data": [    {      "instrument": "binance:futures:BTCUSDT",      "side": "long",      "size": "0.5",      "lot_size": "1",      "entry_price": "66500",      "notional": "33250",      "unrealized_pnl": "250",      "mark_price": "67000"    }  ]}