Перейти к содержимому
HTTP APIСлужебные

Версия API, сборка и лимиты

Собрать запрос

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

Команда
curl 'http://127.0.0.1:48180/v1/meta' \
  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"
GET
/meta

Версия API, сборка терминала, права токена, лимиты и топики стрима. Терминал, собранный без рыночных данных, перечисляет в topics только workspace и settings. Рыночные топики и рыночные операции тогда отвечают unsupported.

Авторизация

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

Токен Local API: spt_ и 64 шестнадцатеричных символа. Скопируйте его в Settings App → Общие → Local API. Он принимается только в заголовке Authorization. Имена, перечисленные у операции, — это права, которые ей нужны. У токена терминала есть все.

Тело ответа

Описание этого терминала.

application/json
  1. response
api_version*string

В v1 всегда 1.

app_version*string

Версия терминала.

build_hash*string
build_env*string

production или development.

features*string

Cargo-фичи сборки одной строкой.

scopes*array<>

Права токена.

limits*
topics*array<string>

Топики стрима, которые отдаёт эта сборка.

Пример запроса
curl 'http://127.0.0.1:48180/v1/meta' \  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"
Пример ответа
{  "api_version": "1",  "app_version": "2.0.0",  "build_hash": "3f1c2ab",  "build_env": "production",  "features": "local-api",  "scopes": [    "market:read",    "connections:read",    "account:read",    "trading:write",    "workspace:read",    "workspace:write",    "settings:read",    "settings:write"  ],  "limits": {    "ws_connections_per_token": 8,    "subscriptions_per_connection": 100,    "api_only_instruments": 50,    "exchange_subscriptions_per_second": 5,    "commands_per_second": 10,    "workspace_commands_per_second": 5,    "settings_commands_per_second": 5  },  "topics": [    "trades",    "ticker",    "mark_price",    "book.top",    "clusters",    "account.orders",    "account.positions",    "account.balances",    "account.fills",    "workspace",    "settings"  ]}