Лимиты
Как часто и сколько: лимиты листенера, запросов и стрима.
Лимиты листенера
Считаются на весь листенер, а не на клиента. GET /v1/meta отдаёт значения работающего терминала; на превышение ответ — 429 rate_limited.
| Лимит | Значение | Описание |
|---|---|---|
ws_connections_per_token | 8 | Соединений стрима на токен. |
subscriptions_per_connection | 100 | Подписок на соединение стрима. |
api_only_instruments | 50 | Инструменты, открытые только для API. Открытые в окне не считаются. |
exchange_subscriptions_per_second | 5 | Новых подписок на биржах в секунду. |
commands_per_second | 10 | Торговых команд в секунду, на всех клиентов вместе. |
workspace_commands_per_second | 5 | Команд рабочего пространства в секунду, на всех клиентов вместе. |
settings_commands_per_second | 5 | Запросов PATCH /settings в секунду, на всех клиентов вместе. |
Лимиты запросов
Границы параметров и списков в телах запросов — так, как они записаны в спецификации.
| Операция | Параметр | Диапазон | По умолчанию |
|---|---|---|---|
GET /v1/instruments | limit | 1–2000 | 500 |
GET /v1/market/candles | limit | ≤ 2000 | 500 |
GET /v1/market/trades | limit | 1–1000 | 100 |
GET /v1/market/orderbook | depth | 1–200 | 50 |
GET /v1/account/fills | limit | 1–1000 | 100 |
POST /v1/workspace/windows/{id}/tabs/{tab}/stacks | items | 1–50 | |
POST /v1/workspace/tabs | items | 1–50 | |
POST /v1/workspace/tabs | name | ≤ 64 | |
PATCH /v1/settings | changes | 1–100 |
Лимиты стрима
Коды закрытия
| Код | Значение |
|---|---|
1001 | API выключили или токен перевыпустили |
4008 | клиент слишком медленный и не успевал дольше 5 с |
4029 | лимит соединений стрима на токен |
Лимиты
Лимиты возвращает GET /v1/meta. Отказ — это кадр error с
rate_limited в ответ на запрос или закрытие с кодом 4029.
| Лимит | Значение |
|---|---|
| соединений стрима на токен | 8 |
| подписок на соединение | 100 |
| инструментов, открытых только для API | 50, не считая открытых в окне |
| новых подписок на биржах в секунду | 5 |
Медленные клиенты
Клиент, который не читает, не замедляет ни терминал, ни других
клиентов. Кадры, которые он не забрал вовремя, отбрасываются. Для trades
кадр gap называет потерянные номера. Для остальных топиков следующий
кадр просто новее.
Ошибки
Коды ошибок Local API, ошибки, которые выбрасывают клиенты, и коды закрытия стрима.
Версия API, сборка и лимиты GET
Версия API, сборка терминала, права токена, лимиты и топики стрима. Терминал, собранный без рыночных данных, перечисляет в `topics` только `workspace` и `settings`. Рыночные топики и рыночные операции тогда отвечают `unsupported`.