Перейти до вмісту
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, збірка термінала, права токена, ліміти й топіки стріму. Термінал, зібраний без ринкових даних, перелічує лише workspace і settings у topics. Ринкові топіки й ринкові операції тоді відповідають 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 (features) збірки одним рядком.

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"  ]}