{"openapi":"3.1.0","info":{"title":"Daepak API","version":"1.0.0","description":"Analyst-grade market data as an API: crypto, the Korean market, US equities, options,\nbacktests, and your own trading journal.\n\n**Authentication.** Every request carries `Authorization: Bearer dpk_live_…`. Keys are\nissued on the Keys page of your profile at [daepak.com](https://daepak.com/app?screen=profile).\n\n⚠️ **The account is derived from the key.** A request cannot name another user; a body\ncontaining `user_id` is rejected with `400` rather than ignored, so a copied example\nfails loudly instead of quietly returning nothing.\n\n**Scopes.** `read:market` · `read:korea` · `read:us` · `read:personal` ·\n`write:personal` · `agent:chat`. Permission to read your journal does not grant\npermission to write to it. The catalogue you receive is filtered by your key's scopes —\nyou never see a tool you cannot call.\n\n**Credits.** Every operation declares its price, so a sequence can be budgeted before it\nruns. Prices come from measuring the tools in production: our own database costs 1,\nan external call 5, embedding or sandbox work 20.\n\n**When the month runs out** you get `402` naming two ways forward — a higher plan or the\nrenewal at the start of the month. There is no overage billing: we would rather refuse\nthan send an invoice nobody expected.\n\n**Errors** default to English; send `X-Lang: ko` or `ru` to get them in that language.","contact":{"url":"https://github.com/Mobiss11/daepak-mcp"},"license":{"name":"Terms","url":"https://daepak.com/terms.html"}},"servers":[{"url":"https://daepak.com"}],"tags":[{"name":"Meta","description":"Catalogue and usage"},{"name":"Agent","description":"Full analyst answers"},{"name":"read:market","description":"Market data — 78 tools"},{"name":"read:personal","description":"Your own records — 9 tools"},{"name":"write:personal","description":"Writing to them — 11 tools"}],"components":{"schemas":{"AgentRequest":{"type":"object","properties":{"message":{"type":"string"},"conversation_id":{"type":"integer","nullable":true,"description":"Returned by the previous call. Pass it back to continue the same conversation. Checked against the key's owner — someone else's id gives 404."},"lang":{"type":"string","enum":["ko","en","ru"]},"coin":{"type":"string","nullable":true},"regenerate":{"type":"boolean","default":false,"description":"Answer the last question again instead of asking a new one."},"seed_context":{"type":"object","nullable":true,"description":"Facts you already have on screen, so the agent does not spend calls fetching them again."},"mode":{"type":"string","enum":["analyst","mentor"],"description":"`mentor` explains the reasoning as it goes; set on the conversation when it is created."},"images":{"type":"array","items":{"type":"string"},"description":"data-URLs, as chat attachments — the agent reads charts and screenshots"}},"required":["message"]}},"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"Your key, `dpk_live_…`, issued on the Keys page of your profile."}}},"security":[{"apiKey":[]}],"paths":{"/v1/tools":{"get":{"summary":"Catalogue of tools this key may call","description":"Schema, required scope and price for every tool available to the key. Filtered by scopes — a tool you cannot call is not listed.","operationId":"listTools","tags":["Meta"],"responses":{"200":{"description":"OK"},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/usage":{"get":{"summary":"Credits used this month, broken down by tool","operationId":"getUsage","tags":["Meta"],"responses":{"200":{"description":"OK"},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/agent/messages":{"post":{"summary":"A complete analyst answer","description":"Runs the full agent loop through the same path as the chat, so conversation memory and image attachments work the same way. Dozens of model and tool calls. Charged against the same daily answer quota as the app, so there is no arbitrage between the two.","operationId":"agentMessage","tags":["Agent"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentRequest"}}}},"responses":{"200":{"description":"OK"},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/agent/resume/{conv_id}":{"get":{"summary":"Reconnect to a generation already running","description":"Replays what you missed and continues the stream. Without this the promise that a dropped connection loses nothing could not be kept. `{\"running\": false}` means it already finished — read the answer from the conversation.","operationId":"agentResume","tags":["Agent"],"parameters":[{"name":"conv_id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"text/event-stream, or {running:false}"},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/agent/cancel/{conv_id}":{"post":{"summary":"Stop a running generation","description":"A caller that simply disconnects leaves the job chewing tokens to the end — and the key's owner pays for them.","operationId":"agentCancel","tags":["Agent"],"parameters":[{"name":"conv_id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/agent/conversations":{"get":{"summary":"Conversations belonging to this key","operationId":"listConversations","tags":["Agent"],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"OK"},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/agent/conversations/{conv_id}":{"get":{"summary":"Messages of one conversation","operationId":"getConversation","tags":["Agent"],"parameters":[{"name":"conv_id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/agent/stream":{"post":{"summary":"The same answer, streamed (SSE)","description":"Server-sent events, exactly what the chat shows. `conversation` arrives **first** and carries the id — keep it, that is where you reconnect. Then `status`, `reasoning`, `tool`, `tool_done` and `delta` (chunks of text). `done` closes the answer; ⚠️ `suggest` (follow-up questions) arrives **after** `done`, so a client that stops reading at `done` will never see it — that ordering is deliberate, the spinner should stop before the suggestions are computed.\n\nGeneration continues **in the background** if you disconnect — the answer still lands in the conversation, and a reconnect replays the backlog. An answer takes tens of seconds; streaming is what makes that bearable.","operationId":"agentStream","tags":["Agent"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentRequest"}}}},"responses":{"200":{"description":"text/event-stream"},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_market_overview":{"post":{"summary":"Сводка по всем отслеживаемым монетам: цена, 24ч, скор, bias","description":"Сводка по всем отслеживаемым монетам: цена, 24ч, скор, bias. Используй для общего обзора рынка.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_market_overview","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_price":{"post":{"summary":"Текущая цена монеты: цена, изменение 24ч, объём, капитализация","description":"Текущая цена монеты: цена, изменение 24ч, объём, капитализация.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_price","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string","description":"Тикер, напр. BTC, ETH, SOL"}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_indicators":{"post":{"summary":"Технические индикаторы монеты: RSI, MACD, моментум, позиция в диапазоне","description":"Технические индикаторы монеты: RSI, MACD, моментум, позиция в диапазоне.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_indicators","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string","description":"Тикер, напр. BTC, ETH, SOL"}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_price_at":{"post":{"summary":"Точная цена монеты N минут/часов назад (из сырого ряда цен) + изменение к текущей","description":"Точная цена монеты N минут/часов назад (из сырого ряда цен) + изменение к текущей. Для вопросов 'какая была цена час назад / в такой-то момент'. minutes_ago=60 — час назад, 1440 — сутки.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_price_at","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string"},"minutes_ago":{"type":"integer"}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_score_history":{"post":{"summary":"Эволюция композитного скора монеты по часам — куда двигалось мнение системы за период","description":"Эволюция композитного скора монеты по часам — куда двигалось мнение системы за период.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_score_history","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string"},"hours":{"type":"integer"}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_signal_outcomes":{"post":{"summary":"Исходы ПОСЛЕДНИХ сигналов (бумажные сделки): по каждому недавнему пробою/сквизу — что было после (тейк/стоп/таймаут, % и","description":"Исходы ПОСЛЕДНИХ сигналов (бумажные сделки): по каждому недавнему пробою/сквизу — что было после (тейк/стоп/таймаут, % и режим). Дополняет агрегатный get_backtest деталями.\n\n**Scope:** `read:market` · **Cost:** 20 credit(s).","operationId":"call_get_signal_outcomes","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_levels":{"post":{"summary":"Объективные тех-уровни монеты на ТФ (детерминированная математика, не паттерны): свинговые поддержки/сопротивления (реал","description":"Объективные тех-уровни монеты на ТФ (детерминированная математика, не паттерны): свинговые поддержки/сопротивления (реальные экстремумы), Фибоначчи-уровни от доминирующего свинга (ретрейс + расширения), ATR (для размера стопа). Даёт конкретные числа для входа/стопа/цели. По умолчанию 4h.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_levels","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string"},"tf":{"type":"string","enum":["15m","1h","4h","1d"]}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_price_history":{"post":{"summary":"Сырые свечи OHLC монеты на ТФ 5m/15m/1h/4h/1d — чтобы САМОСТОЯТЕЛЬНО оценить тренд/структуру (higher highs/lows, где цен","description":"Сырые свечи OHLC монеты на ТФ 5m/15m/1h/4h/1d — чтобы САМОСТОЯТЕЛЬНО оценить тренд/структуру (higher highs/lows, где цена в диапазоне), а не полагаться на готовый вердикт get_regime. По умолчанию 1h, ~40 баров.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_price_history","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string"},"tf":{"type":"string","enum":["5m","15m","1h","4h","1d"]},"bars":{"type":"integer"}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_derivatives":{"post":{"summary":"Деривативы монеты (снимок): funding rate + z-score, открытый интерес и его Δ, taker-flow, long/short-ratio","description":"Деривативы монеты (снимок): funding rate + z-score, открытый интерес и его Δ, taker-flow, long/short-ratio.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_derivatives","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string","description":"Тикер, напр. BTC, ETH, SOL"}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_iv_metrics":{"post":{"summary":"Опционная ВОЛАТИЛЬНОСТЬ (Deribit; исполнение — Bybit), BTC/ETH/SOL: ATM IV (7/30/90д), IV Rank/Percentile (дорогая/дешёв","description":"Опционная ВОЛАТИЛЬНОСТЬ (Deribit; исполнение — Bybit), BTC/ETH/SOL: ATM IV (7/30/90д), IV Rank/Percentile (дорогая/дешёвая премия в годовом диапазоне), term structure (контанго/бэквордация), skew (перекос OTM put/call — страх/спрос на upside), RV vs IV (риск-премия волы → покупать или продавать премию). Главный инструмент для ОПЦИОННЫХ решений — суди по данным, не только по направлению.\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_get_iv_metrics","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string","description":"Тикер, напр. BTC, ETH, SOL"}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_options_positioning":{"post":{"summary":"Опционное ПОЗИЦИОНИРОВАНИЕ (Deribit; исполнение — Bybit), BTC/ETH/SOL: OI по страйкам (стены — магниты/сопротивления), p","description":"Опционное ПОЗИЦИОНИРОВАНИЕ (Deribit; исполнение — Bybit), BTC/ETH/SOL: OI по страйкам (стены — магниты/сопротивления), put/call ratio, max pain (куда тянет к экспирации), GEX + гамма-флип (чистая гамма дилеров: >0 пиннинг/диапазон, <0 усиление/сквиз; флип — где режим меняется). Объясняет пиннинг к круглым уровням и гамма-сквизы — связывай с направлением и уровнями.\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_get_options_positioning","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string","description":"Тикер, напр. BTC, ETH, SOL"}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_option_strategy":{"post":{"summary":"СТРАТЕГИЧЕСКИЙ скаффолд по опционам (BTC/ETH/SOL): связывает направление системы × режим IV (дёшево/дорого) × GEX (диапа","description":"СТРАТЕГИЧЕСКИЙ скаффолд по опционам (BTC/ETH/SOL): связывает направление системы × режим IV (дёшево/дорого) × GEX (диапазон/импульс) → рекомендованные СЕМЕЙСТВА конструкций (дебет/кредит-спреды, кондор, straddle) + якоря страйков по стенам OI + риски (theta/IV crush/Bybit). Это раскладка для решения, не сигнал — используй когда нужен выбор КОНСТРУКЦИИ, а не просто метрики.\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_get_option_strategy","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string","description":"Тикер, напр. BTC, ETH, SOL"}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_options_backtest":{"post":{"summary":"Опционный БЭКТЕСТ (BTC/ETH): проверка по истории, есть ли edge у покупки волы (forward RV − IV) и выше ли он, когда IV д","description":"Опционный БЭКТЕСТ (BTC/ETH): проверка по истории, есть ли edge у покупки волы (forward RV − IV) и выше ли он, когда IV дешёвая (IV Rank<35) — разбивка по режиму IV + winrate. «Машина правды» для вол-тезиса (прокси по RV−IV, без точного theta/страйков). Параметр fwd_days (горизонт, дн).\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_options_backtest","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string"},"fwd_days":{"type":"integer","description":"горизонт удержания, дней (по умолч. 14)"}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_option_structure":{"post":{"summary":"ПЕЙОФФ/ГРЕКИ конкретной опционной конструкции (BTC/ETH Deribit, SOL Bybit): по ногам legs считает чистые delta/theta/veg","description":"ПЕЙОФФ/ГРЕКИ конкретной опционной конструкции (BTC/ETH Deribit, SOL Bybit): по ногам legs считает чистые delta/theta/vega, дебет/кредит, точки безубытка, max profit/loss и payoff к экспирации. Вызывай, когда выбрал конкретные страйки/конструкцию (колл-спред, кондор, straddle) и нужно увидеть реальные цифры сделки. Страйки снапятся к доступным.\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_get_option_structure","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string"},"expiry":{"type":"string","description":"опц., напр. 27JUN26; иначе ~ближайшая месячная"},"legs":{"type":"array","description":"ноги конструкции","items":{"type":"object","properties":{"type":{"type":"string","enum":["call","put"]},"strike":{"type":"number"},"side":{"type":"string","enum":["buy","sell"]},"qty":{"type":"number"}},"required":["type","strike","side"]}}},"required":["coin","legs"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_probability":{"post":{"summary":"СЫРЬЁ для коротких/бинарных ставок: вероятности P(вверх)/P(выше уровня)/P(касания) за горизонт (horizon_min) из реализов","description":"СЫРЬЁ для коротких/бинарных ставок: вероятности P(вверх)/P(выше уровня)/P(касания) за горизонт (horizon_min) из реализованной волы (бездрейфовая лог-нормаль) + ожидаемое движение/σ. На коротком горизонте P≈50% (дрейф≈0) — это факт, не баг. Не вердикт, цифры для оценки. target — опц. уровень.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_probability","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string"},"horizon_min":{"type":"number","description":"горизонт в минутах: 10/30/60/240/1440"},"target":{"type":"number","description":"опц. целевой уровень"}},"required":["coin","horizon_min"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_binary_ev":{"post":{"summary":"СЫРЬЁ: арифметика EV бинарного опциона","description":"СЫРЬЁ: арифметика EV бинарного опциона. По p_win (0..1) и payout_pct (% выплаты при выигрыше, напр. 80) → EV на единицу ставки, безубыточный винрейт, edge. Не вердикт — числа, чтобы видеть, +EV ли ставка.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_binary_ev","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"p_win":{"type":"number"},"payout_pct":{"type":"number"}},"required":["p_win","payout_pct"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_short_calibration":{"post":{"summary":"СЫРЬЁ: эмпирические частоты направления по недавней истории за горизонт (horizon_min) — база 'доля вверх' + винрейты наи","description":"СЫРЬЁ: эмпирические частоты направления по недавней истории за горизонт (horizon_min) — база 'доля вверх' + винрейты наивных сигналов (моментум/реверсия) с размером выборки. Сравнивай с безубытком бинарки. Не вердикт.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_short_calibration","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string"},"horizon_min":{"type":"number"}},"required":["coin","horizon_min"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_risk_sizing":{"post":{"summary":"РИСК/САЙЗИНГ-калькулятор (фьючи/спот/маржа): по входу/стопу/плечу → размер позиции под риск счёта (risk_pct), R-мультипл","description":"РИСК/САЙЗИНГ-калькулятор (фьючи/спот/маржа): по входу/стопу/плечу → размер позиции под риск счёта (risk_pct), R-мультипликаторы к целям, цена и дистанция ЛИКВИДАЦИИ + предупреждение, если ликвидация ближе стопа. account_usd берётся из профиля, если не задан. Вызывай для любого вопроса про размер/плечо/риск сделки.\n\n**Scope:** `read:personal` · **Cost:** 1 credit(s).","operationId":"call_get_risk_sizing","tags":["read:personal"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"entry":{"type":"number"},"stop":{"type":"number"},"side":{"type":"string","enum":["long","short"]},"account_usd":{"type":"number"},"risk_pct":{"type":"number","description":"риск на сделку, % счёта (по умолч. 1)"},"leverage":{"type":"number"},"targets":{"type":"array","items":{"type":"number"}}},"required":["entry","stop"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_positioning_history":{"post":{"summary":"Сырая ДИНАМИКА позиционирования по часам: funding/OI/taker/long-short за период — чтобы САМ оценить, перегружена ли стор","description":"Сырая ДИНАМИКА позиционирования по часам: funding/OI/taker/long-short за период — чтобы САМ оценить, перегружена ли сторона и куда идёт OI, а не по ярлыку 'топливо' из get_coil.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_positioning_history","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string"},"hours":{"type":"integer"}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_liquidations_history":{"post":{"summary":"Сырые крупные ликвидации (отдельные события >$10k) за период — чтобы САМ увидеть каскады/тайминг, а не агрегат-skew","description":"Сырые крупные ликвидации (отдельные события >$10k) за период — чтобы САМ увидеть каскады/тайминг, а не агрегат-skew.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_liquidations_history","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string"},"hours":{"type":"integer"}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_score":{"post":{"summary":"Композитный скор монеты (нарратив×позиционирование, -100","description":"Композитный скор монеты (нарратив×позиционирование, -100..+100) + bias + факторы + дивергенции.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_score","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string","description":"Тикер, напр. BTC, ETH, SOL"}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_liquidations":{"post":{"summary":"Ликвидации монеты за час: объём лонгов/шортов в $ и перекос (skew)","description":"Ликвидации монеты за час: объём лонгов/шортов в $ и перекос (skew). >0 рвут шортов, <0 лонгов.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_liquidations","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string","description":"Тикер, напр. BTC, ETH, SOL"}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_coil":{"post":{"summary":"Состояние «коридора» монеты: сжатие, заряд, границы коридора, топливо (funding/ликвидации) — сетап на сквиз/пробой","description":"Состояние «коридора» монеты: сжатие, заряд, границы коридора, топливо (funding/ликвидации) — сетап на сквиз/пробой.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_coil","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string","description":"Тикер, напр. BTC, ETH, SOL"}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_onchain":{"post":{"summary":"Он-чейн DEX-активность монеты: объём, доля покупок, чистый поток","description":"Он-чейн DEX-активность монеты: объём, доля покупок, чистый поток.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_onchain","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string","description":"Тикер, напр. BTC, ETH, SOL"}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_orderbook":{"post":{"summary":"Стакан монеты: дисбаланс бид/аск, спред","description":"Стакан монеты: дисбаланс бид/аск, спред.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_orderbook","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string","description":"Тикер, напр. BTC, ETH, SOL"}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_social_momentum":{"post":{"summary":"Соц-импульс монеты (снимок): velocity (ускорение обсуждения), breadth (органичность), траектория сентимента","description":"Соц-импульс монеты (снимок): velocity (ускорение обсуждения), breadth (органичность), траектория сентимента.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_social_momentum","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string","description":"Тикер, напр. BTC, ETH, SOL"}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_social_history":{"post":{"summary":"Сырая ДИНАМИКА соц-обсуждения по времени: упоминания, уникальные авторы, сентимент — чтобы САМ увидеть разгон/затухание ","description":"Сырая ДИНАМИКА соц-обсуждения по времени: упоминания, уникальные авторы, сентимент — чтобы САМ увидеть разгон/затухание хайпа, а не снимок.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_social_history","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string"},"hours":{"type":"integer"}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_authenticity":{"post":{"summary":"Органичность обсуждения: метрики (когерентность/дублирование/концентрация/качество аккаунтов + метка organic/manufacture","description":"Органичность обсуждения: метрики (когерентность/дублирование/концентрация/качество аккаунтов + метка organic/manufactured) И СЫРЫЕ УЛИКИ — топ-авторы (кто пушит), фразы-сигнатуры (повторяющиеся n-граммы = шаблон спама), примеры/дубли постов. Смотри улики, а не только числа: назови конкретную кампанию/фразу, если есть.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_authenticity","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string","description":"Тикер, напр. BTC, ETH, SOL"}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_regime":{"post":{"summary":"Режим рынка: тренд, волатильность, risk-on/off, Fear&Greed","description":"Режим рынка: тренд, волатильность, risk-on/off, Fear&Greed.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_regime","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_fear_greed":{"post":{"summary":"Индекс страха и жадности (0-100)","description":"Индекс страха и жадности (0-100).\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_fear_greed","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_kimchi_premium":{"post":{"summary":"Кимчи-премия С РАЗЛОЖЕНИЕМ на валютную ногу (USDT в Корее против курса, общая для всех монет) и ногу актива (что остаётс","description":"Кимчи-премия С РАЗЛОЖЕНИЕМ на валютную ногу (USDT в Корее против курса, общая для всех монет) и ногу актива (что остаётся самой монете). Читать всегда по ногам: общее число смешивает две разные вещи. ⚠️ Ноги ОБЪЯСНЯЮТ, но не предсказывают — проверено бэктестом, связи с ценой на горизонтах до суток нет. По умолчанию — вотчлист (coin → история 48ч; для свежего листинга добавляется разложенный ряд с пометками надёжности). Свежие листинги Upbit ведутся 48ч и видны как is_new_listing. scan_all=true → ЖИВОЙ скан по ВСЕМ ликвидным Upbit-маркетам; монету там определяет сам Upbit по каноничному id, не по совпадению тикера.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_kimchi_premium","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string"},"scan_all":{"type":"boolean"},"top":{"type":"integer"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_movers":{"post":{"summary":"급등 스캐너 «что сейчас летит»: топ рост/падение/оборот по ВСЕМУ рынку (не только вотчлист) — крипта (все ~270 KRW-маркетов U","description":"급등 스캐너 «что сейчас летит»: топ рост/падение/оборот по ВСЕМУ рынку (не только вотчлист) — крипта (все ~270 KRW-маркетов Upbit) + корейские акции (KOSPI/KOSDAQ, Naver 상승률 상위). Используй для дискавери моментума/пампов/급등주. market: all|crypto|stock.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_movers","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"market":{"type":"string","enum":["all","crypto","stock"]},"top":{"type":"integer"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_hit_rate":{"post":{"summary":"Hit-rate сигналов (надёжность скора) по горизонтам 1ч/4ч/24ч","description":"Hit-rate сигналов (надёжность скора) по горизонтам 1ч/4ч/24ч. Без coin — общий, с coin — по монете.\n\n**Scope:** `read:market` · **Cost:** 20 credit(s).","operationId":"call_get_hit_rate","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_positions":{"post":{"summary":"Открытые позиции пользователя (монета/сторона/плечо/размер/вход/стоп/тейки) + его риск-профиль","description":"Открытые позиции пользователя (монета/сторона/плечо/размер/вход/стоп/тейки) + его риск-профиль. Используй для ПЕРСОНАЛЬНЫХ ответов (учитывай, что у него уже есть позиция).\n\n**Scope:** `read:personal` · **Cost:** 1 credit(s).","operationId":"call_get_positions","tags":["read:personal"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/set_position":{"post":{"summary":"Записать позицию пользователя","description":"Записать позицию пользователя. ВЫЗЫВАЙ ТОЛЬКО когда пользователь ЯВНО сообщил свою позицию ('я в лонге ETH от 1720, плечо 3, стоп 1700'). Никогда не выдумывай и не открывай сам — ты не исполнитель сделок.\n\n**Scope:** `write:personal` · **Cost:** 1 credit(s).","operationId":"call_set_position","tags":["write:personal"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string"},"side":{"type":"string","enum":["long","short"]},"leverage":{"type":"number"},"size_usd":{"type":"number"},"entry":{"type":"number"},"stop":{"type":"number"},"takes":{"type":"array","items":{"type":"number"}},"notes":{"type":"string"}},"required":["coin","side"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/update_position":{"post":{"summary":"Скорректировать позицию по id (напр","description":"Скорректировать позицию по id (напр. подвинуть стоп). ТОЛЬКО по явной просьбе пользователя. id бери из get_positions.\n\n**Scope:** `write:personal` · **Cost:** 1 credit(s).","operationId":"call_update_position","tags":["write:personal"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer"},"leverage":{"type":"number"},"size_usd":{"type":"number"},"entry":{"type":"number"},"stop":{"type":"number"},"takes":{"type":"array","items":{"type":"number"}},"notes":{"type":"string"}},"required":["id"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/create_task":{"post":{"summary":"Завести ФОНОВУЮ ЗАДАЧУ: наблюдение за условием (kind=watch) или разбор по расписанию (kind=schedule)","description":"Завести ФОНОВУЮ ЗАДАЧУ: наблюдение за условием (kind=watch) или разбор по расписанию (kind=schedule). Результат придёт в ЭТУ беседу и в колокольчик. ⚠️ Условие проверяется КОДОМ по нашим данным, а не тобой: доступны metric = price (symbol/op/value) · vwap_cross (symbol/dir=below|above) · gap (value=%, symbol='*' для всего рынка) · score (symbol/op/value). Расплывчатое условие («когда станет интересно») задачей быть НЕ может — скажи это прямо, не изображай наблюдение. spec для schedule: {at:'09:00', tz_offset_hours:9} или {every_min:60}. max_runs>1 — если наблюдение должно срабатывать повторно.\n\n**Scope:** `write:personal` · **Cost:** 1 credit(s).","operationId":"call_create_task","tags":["write:personal"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"kind":{"type":"string","description":"watch | schedule"},"spec":{"type":"object"},"prompt":{"type":"string","description":"что разобрать при срабатывании"},"max_runs":{"type":"integer"}},"required":["title","kind","spec"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/list_tasks":{"post":{"summary":"Фоновые задачи пользователя: что наблюдается, когда проверялось, что нашлось, сколько осталось до потолка активных","description":"Фоновые задачи пользователя: что наблюдается, когда проверялось, что нашлось, сколько осталось до потолка активных.\n\n**Scope:** `read:personal` · **Cost:** 1 credit(s).","operationId":"call_list_tasks","tags":["read:personal"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"active | done | cancelled"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/cancel_task":{"post":{"summary":"Отменить фоновую задачу по id","description":"Отменить фоновую задачу по id.\n\n**Scope:** `write:personal` · **Cost:** 1 credit(s).","operationId":"call_cancel_task","tags":["write:personal"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer"}},"required":["id"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/log_trades":{"post":{"summary":"ПАЧКА уже закрытых сделок одним вызовом — для скриншота истории сделок","description":"ПАЧКА уже закрытых сделок одним вызовом — для скриншота истории сделок. Каждая строка: coin, side, entry, exit_price, опционально stop/size_usd/leverage/opened_at/closed_at/notes. Возвращает ПОСТРОЧНЫЙ итог: что легло, что нет и почему. ⚠️ Перед записью ПОКАЖИ пользователю таблицу того, что распознал, и дождись подтверждения — цифра, прочитанная со скриншота неверно, отравляет журнал молча. Не выдумывай стоп: нет на скриншоте — не указывай, инструмент честно скажет, что R не посчитан.\n\n**Scope:** `write:personal` · **Cost:** 1 credit(s).","operationId":"call_log_trades","tags":["write:personal"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"trades":{"type":"array","items":{"type":"object"}},"sim":{"type":"boolean"}},"required":["trades"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/log_trade":{"post":{"summary":"Занести УЖЕ ЗАКРЫТУЮ сделку ОДНИМ вызовом (вход, выход, стоп, размер) — для сделок, о которых человек рассказал после вы","description":"Занести УЖЕ ЗАКРЫТУЮ сделку ОДНИМ вызовом (вход, выход, стоп, размер) — для сделок, о которых человек рассказал после выхода. Раньше для этого нужны были set_position + close_position с проведением id между ними, и сделки просто не попадали в журнал. ⚠️ Стоп указывай, даже если сделка закрыта: без заявленного риска результат нельзя выразить в R, а «сколько заработал в долларах» о качестве решения не говорит. Записывай ТОЛЬКО то, что человек назвал сам — не восстанавливай цены по графику.\n\n**Scope:** `write:personal` · **Cost:** 1 credit(s).","operationId":"call_log_trade","tags":["write:personal"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string","description":"тикер или монета"},"side":{"type":"string","description":"long | short"},"entry":{"type":"number"},"exit_price":{"type":"number"},"stop":{"type":"number"},"size_usd":{"type":"number"},"leverage":{"type":"number"},"opened_at":{"type":"string"},"closed_at":{"type":"string"},"notes":{"type":"string"},"sim":{"type":"boolean","description":"сделка на демо/проп-счёте"}},"required":["coin","side","entry","exit_price"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/close_position":{"post":{"summary":"Закрыть позицию пользователя по id","description":"Закрыть позицию пользователя по id. Только по явной просьбе. Передай exit_price (цену выхода) — тогда зафиксируется P&L для журнала сделок.\n\n**Scope:** `write:personal` · **Cost:** 1 credit(s).","operationId":"call_close_position","tags":["write:personal"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer"},"exit_price":{"type":"number","description":"цена закрытия — для расчёта P&L"}},"required":["id"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_trade_review":{"post":{"summary":"Разбор ЗАКРЫТОЙ сделки пользователя по id: где был вход относительно диапазона и уровней, стоп в ATR, насколько глубоко ","description":"Разбор ЗАКРЫТОЙ сделки пользователя по id: где был вход относительно диапазона и уровней, стоп в ATR, насколько глубоко цена уходила против и в плюс, что было после выхода. Уровни и ATR считаются по свечам ДО входа — не выдавай за очевидное то, что нарисовалось позже. Описывай факты, не говори «надо было».\n\n**Scope:** `read:personal` · **Cost:** 1 credit(s).","operationId":"call_get_trade_review","tags":["read:personal"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"id закрытой сделки"}},"required":["id"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/save_material":{"post":{"summary":"Сохранить материал (книга/видео/курс/документация) в раздел обучения ученика, чтобы он не утонул в переписке","description":"Сохранить материал (книга/видео/курс/документация) в раздел обучения ученика, чтобы он не утонул в переписке. Заполняй РАЗМЕТКУ: take — что брать, skip — что пропустить, weak — в чём слаб или чей интерес, lang — язык материала (для видео это язык ОЗВУЧКИ, а не заголовка). Без разметки не сохраняй: список ссылок без неё бесполезен.\n\n**Scope:** `write:personal` · **Cost:** 1 credit(s).","operationId":"call_save_material","tags":["write:personal"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"},"kind":{"type":"string","enum":["book","video","course","doc"]},"lang":{"type":"string","description":"язык материала; у видео — озвучки"},"why":{"type":"string"},"take":{"type":"string"},"skip":{"type":"string"},"weak":{"type":"string"},"skill_key":{"type":"string","description":"тема материала одним словом (риск, вход, психология)"}},"required":["title","take"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/list_materials":{"post":{"summary":"Материалы, уже сохранённые ученику","description":"Материалы, уже сохранённые ученику. Читай перед тем, как советовать: повтор того же самого выглядит как невнимание.\n\n**Scope:** `read:personal` · **Cost:** 1 credit(s).","operationId":"call_list_materials","tags":["read:personal"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_trade_journal":{"post":{"summary":"Журнал ЗАКРЫТЫХ сделок пользователя: личный винрейт, суммарный/средний P&L, лучшая/худшая, разбивка по монете","description":"Журнал ЗАКРЫТЫХ сделок пользователя: личный винрейт, суммарный/средний P&L, лучшая/худшая, разбивка по монете. Это про РЕАЛЬНЫЕ сделки владельца (не бэктест сигналов) — для вопросов «как я торгую», «мой результат».\n\n**Scope:** `read:personal` · **Cost:** 1 credit(s).","operationId":"call_get_trade_journal","tags":["read:personal"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/remember":{"post":{"summary":"Сохранить DURABLE-факт о владельце в долгосрочную память (тихий побочный эффект, НЕ ответ)","description":"Сохранить DURABLE-факт о владельце в долгосрочную память (тихий побочный эффект, НЕ ответ). Только устойчивое: предпочтения/стиль/повторяющийся контекст. НЕ вызывать на разовый вопрос/сравнение/анализ и НИКОГДА вместо самого ответа — сначала выполни запрос полностью. Кратко, без дублей, не рыночные вердикты.\n\n**Scope:** `write:personal` · **Cost:** 1 credit(s).","operationId":"call_remember","tags":["write:personal"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"fact":{"type":"string"},"category":{"type":"string","enum":["preference","owner_fact","recurring_context","insight"]},"salience":{"type":"integer"}},"required":["fact"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/forget":{"post":{"summary":"Удалить факт из долгосрочной памяти по id (id из list_memory)","description":"Удалить факт из долгосрочной памяти по id (id из list_memory). По просьбе владельца.\n\n**Scope:** `write:personal` · **Cost:** 1 credit(s).","operationId":"call_forget","tags":["write:personal"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer"}},"required":["id"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/list_memory":{"post":{"summary":"Показать долгосрочную память — что агент помнит о владельце (факты/предпочтения)","description":"Показать долгосрочную память — что агент помнит о владельце (факты/предпочтения).\n\n**Scope:** `read:personal` · **Cost:** 1 credit(s).","operationId":"call_list_memory","tags":["read:personal"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/sandbox_exec":{"post":{"summary":"ПЕСОЧНИЦА: выполнить код (python/bash) в ИЗОЛИРОВАННОМ контейнере (свой /work, интернет есть, НЕТ доступа к прод-БД/секр","description":"ПЕСОЧНИЦА: выполнить код (python/bash) в ИЗОЛИРОВАННОМ контейнере (свой /work, интернет есть, НЕТ доступа к прод-БД/секретам/хосту). Для своих скриптов/расчётов/проверок идей. Вывод обрезается, таймаут 60с. Включается флагом (если выкл — вернёт пометку).\n\n**Scope:** `read:market` · **Cost:** 20 credit(s).","operationId":"call_sandbox_exec","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"lang":{"type":"string","enum":["python","bash"]}},"required":["code"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/sandbox_write":{"post":{"summary":"ПЕСОЧНИЦА: записать файл в /work (персистентно между сессиями)","description":"ПЕСОЧНИЦА: записать файл в /work (персистентно между сессиями).\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_sandbox_write","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"path":{"type":"string"},"content":{"type":"string"}},"required":["path","content"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/sandbox_read":{"post":{"summary":"ПЕСОЧНИЦА: прочитать файл из /work","description":"ПЕСОЧНИЦА: прочитать файл из /work.\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_sandbox_read","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"path":{"type":"string"}},"required":["path"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/sandbox_ls":{"post":{"summary":"ПЕСОЧНИЦА: список файлов в /work (или подпапке)","description":"ПЕСОЧНИЦА: список файлов в /work (или подпапке).\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_sandbox_ls","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"path":{"type":"string"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/sandbox_pip":{"post":{"summary":"ПЕСОЧНИЦА: установить pip-пакет (в /work/","description":"ПЕСОЧНИЦА: установить pip-пакет (в /work/.venv, переживает рестарт).\n\n**Scope:** `read:market` · **Cost:** 20 credit(s).","operationId":"call_sandbox_pip","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"package":{"type":"string"}},"required":["package"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/sandbox_load_data":{"post":{"summary":"ПЕСОЧНИЦА: выгрузить наши свечи (read-only) в CSV-файл песочницы для анализа скриптом","description":"ПЕСОЧНИЦА: выгрузить наши свечи (read-only) в CSV-файл песочницы для анализа скриптом. Безопасный мост к данным (без креденшелов в контейнере).\n\n**Scope:** `read:market` · **Cost:** 20 credit(s).","operationId":"call_sandbox_load_data","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string"},"tf":{"type":"string"},"bars":{"type":"integer"}},"required":["coin"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/sandbox_status":{"post":{"summary":"ПЕСОЧНИЦА: статус (включена ли, доступен ли контейнер)","description":"ПЕСОЧНИЦА: статус (включена ли, доступен ли контейнер).\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_sandbox_status","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_portfolio":{"post":{"summary":"ПОРТФЕЛЬНЫЙ вид по открытым позициям: gross/нетто-экспозиция, нетто-направленность (BTC-эквивалент риска, т","description":"ПОРТФЕЛЬНЫЙ вид по открытым позициям: gross/нетто-экспозиция, нетто-направленность (BTC-эквивалент риска, т.к. альты коррелируют с BTC), концентрация в монете, нереализованный P&L + предупреждения о концентрации/однобокости. Для вопросов про общий риск портфеля.\n\n**Scope:** `read:personal` · **Cost:** 1 credit(s).","operationId":"call_get_portfolio","tags":["read:personal"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_catalysts":{"post":{"summary":"Предстоящие КАТАЛИЗАТОРЫ из календаря (FOMC/CPI/анлоки/листинги) — важно для тайминга волы/IV crush и риска","description":"Предстоящие КАТАЛИЗАТОРЫ из календаря (FOMC/CPI/анлоки/листинги) — важно для тайминга волы/IV crush и риска. Параметр days (горизонт). Если пусто — предложи добавить (add_catalyst) или найти даты веб-поиском.\n\n**Scope:** `read:personal` · **Cost:** 1 credit(s).","operationId":"call_get_catalysts","tags":["read:personal"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string"},"days":{"type":"integer"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/add_catalyst":{"post":{"summary":"Добавить событие в календарь катализаторов (по явной просьбе или найдя дату через web_search)","description":"Добавить событие в календарь катализаторов (по явной просьбе или найдя дату через web_search). date — YYYY-MM-DD, coin опц. (NULL=макро).\n\n**Scope:** `write:personal` · **Cost:** 1 credit(s).","operationId":"call_add_catalyst","tags":["write:personal"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string"},"title":{"type":"string"},"coin":{"type":"string"}},"required":["date","title"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_backtest":{"post":{"summary":"Бэктест сигналов («бумажная торговля» с комиссией/проскальзыванием): реальный edge по типам сигналов — винрейт, профит-ф","description":"Бэктест сигналов («бумажная торговля» с комиссией/проскальзыванием): реальный edge по типам сигналов — винрейт, профит-фактор, доходность vs buy&hold. Используй, когда спрашивают, работают ли сигналы/какой стратегии доверять.\n\n**Scope:** `read:market` · **Cost:** 20 credit(s).","operationId":"call_get_backtest","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_narratives":{"post":{"summary":"Трендовые нарративы рынка — что движет ценами сейчас","description":"Трендовые нарративы рынка — что движет ценами сейчас.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_narratives","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_events":{"post":{"summary":"Лента событий-катализаторов (взломы/листинги/регуляция/макро)","description":"Лента событий-катализаторов (взломы/листинги/регуляция/макро). Опц. по монете.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_events","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_recent_news":{"post":{"summary":"Свежие новости (опц","description":"Свежие новости (опц. по монете и за N часов).\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_get_recent_news","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"coin":{"type":"string"},"hours":{"type":"integer"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_period_summary":{"post":{"summary":"СВОДКА ЗА ПЕРИОД одним вызовом: движение цены (начало/конец/мин/макс/%), главные темы, события","description":"СВОДКА ЗА ПЕРИОД одним вызовом: движение цены (начало/конец/мин/макс/%), главные темы, события. days = глубина (1..180), coin — опционально. Используй для вопросов «что было за неделю/месяц/в июне» ВМЕСТО серии отдельных запросов. Если период покрыт не полностью, в ответе будет пометка «⚠️ покрытие» — обязательно передай её пользователю.\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_get_period_summary","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"days":{"type":"integer"},"coin":{"type":"string"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_data_coverage":{"post":{"summary":"За какой период в базе РЕАЛЬНО есть данные каждого типа (новости/нарративы/события/скоры/кимчи/свечи)","description":"За какой период в базе РЕАЛЬНО есть данные каждого типа (новости/нарративы/события/скоры/кимчи/свечи). Вызывай, когда спрашивают про прошлое («месяц назад», «в июне»), чтобы не искать вслепую и честно сказать, покрыт ли период.\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_get_data_coverage","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/search_news":{"post":{"summary":"Гибридный поиск по собранным новостям/постам: смысл (эмбеддинг) + точные вхождения","description":"Гибридный поиск по собранным новостям/постам: смысл (эмбеддинг) + точные вхождения. hours — окно свежести (ПО УМОЛЧАНИЮ 168 = неделя; для вопросов «что сейчас/сегодня» ставь 24 или 12). limit ≤30. В выдаче есть published_at — СВЕРЯЙ его с текущей датой и не выдавай старую новость за свежую.\n\n**Scope:** `read:market` · **Cost:** 20 credit(s).","operationId":"call_search_news","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"coin":{"type":"string"},"hours":{"type":"integer","description":"окно свежести в часах, пусто = вся база"},"limit":{"type":"integer"}},"required":["query"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/search_narratives":{"post":{"summary":"Поиск по ИСТОРИИ нарративов за N дней (не только текущие): что двигало рынок, когда тема появилась/потухла","description":"Поиск по ИСТОРИИ нарративов за N дней (не только текущие): что двигало рынок, когда тема появилась/потухла. query опц. — фильтр по подстроке.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_search_narratives","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"days":{"type":"integer"},"limit":{"type":"integer"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/fetch_social_live":{"post":{"summary":"ЖИВОЙ запрос в Twitter/Reddit прямо сейчас (платный, лимит/час)","description":"ЖИВОЙ запрос в Twitter/Reddit прямо сейчас (платный, лимит/час). Используй ТОЛЬКО когда нужна самая свежая реакция соцсетей, которой нет в собранном (search_news). Не для рутины. Для произвольного токена ПЕРЕДАВАЙ ticker (без $) — построю cashtag-запрос и отфильтрую мусор-однофамильцев по релевантности.\n\n**Scope:** `read:market` · **Cost:** 20 credit(s).","operationId":"call_fetch_social_live","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"ticker":{"type":"string","description":"тикер токена без $ (напр. APEX) — для таргетинга и фильтра релевантности"},"platform":{"type":"string","enum":["twitter","reddit"]}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/resolve_token":{"post":{"summary":"Распознать ПРОИЗВОЛЬНЫЙ тикер/имя токена (вне вотчлиста) → кандидаты CoinGecko (id/symbol/name/рыночный ранг) для дизамб","description":"Распознать ПРОИЗВОЛЬНЫЙ тикер/имя токена (вне вотчлиста) → кандидаты CoinGecko (id/symbol/name/рыночный ранг) для дизамбигуации (напр. APEX = и Civic, и ApeX Protocol). Вызывай ПЕРВЫМ, если тикера нет в нашем покрытии (BTC/ETH/SOL/XRP/DOGE), затем get_token_market по выбранному id.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_resolve_token","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_token_market":{"post":{"summary":"Рынок ЛЮБОГО токена вне вотчлиста (CoinGecko, без ключа): текущая цена/капа/ранк/FDV/объём, изменения 24ч/7д/30д/1г, ATH","description":"Рынок ЛЮБОГО токена вне вотчлиста (CoinGecko, без ключа): текущая цена/капа/ранк/FDV/объём, изменения 24ч/7д/30д/1г, ATH и % от ATH с датой, ГОДОВАЯ история цены (точки + год-назад + min/max) — закрывает 'срез года', 'цена год назад', 'вернулась ли цена'. query — тикер/имя ИЛИ coingecko-id из resolve_token. days опц. (≤365).\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_get_token_market","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"days":{"type":"integer","description":"горизонт истории в днях, по умолч. 365"}},"required":["query"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_token_onchain":{"post":{"summary":"Он-чейн срез ЛЮБОГО токена (DexPaprika DEX-данные, без ключа): нетто-поток buy−sell за 24ч, ликвидность, объём, число по","description":"Он-чейн срез ЛЮБОГО токена (DexPaprika DEX-данные, без ключа): нетто-поток buy−sell за 24ч, ликвидность, объём, число покупателей/продавцов, КРУПНЫЕ недавние сделки по кошелькам — СЫРЬЁ для вопроса 'копят ли фонды / жив ли он-чейн'. Не вердикт: даёт поток и крупные сделки, судишь сам. query — символ/имя/контракт; network опц. (ethereum/solana/bsc…). Это поток сделок; полный список держателей — get_token_holders.\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_get_token_onchain","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"network":{"type":"string"}},"required":["query"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_token_holders":{"post":{"summary":"ТОП-ХОЛДЕРЫ ЛЮБОГО токена + концентрация (% долей, top10_pct) — прямой ответ на 'контролирует ли узкая группа / копят ли","description":"ТОП-ХОЛДЕРЫ ЛЮБОГО токена + концентрация (% долей, top10_pct) — прямой ответ на 'контролирует ли узкая группа / копят ли крупные'. Solana (Helius/публичный RPC) и Ethereum (Ethplorer). ВАЖНО: верхние адреса часто DEX-пулы/CEX/treasury/burn, а не 'фонды' — не выдавай их за накопление фондов; высокая концентрация top10 = риск. Сырьё, не вердикт. query — символ/имя/контракт; network опц.\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_get_token_holders","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"network":{"type":"string"},"limit":{"type":"integer","description":"сколько холдеров (5-50, по умолч. 20)"}},"required":["query"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/web_search":{"post":{"summary":"Веб-поиск актуальной информации (новости/события/актуалка вне базы) — отдаёт title/url/сниппет","description":"Веб-поиск актуальной информации (новости/события/актуалка вне базы) — отдаёт title/url/сниппет. Нашёл нужную ссылку → прочитай её целиком через `fetch_url`.\n\n**Scope:** `read:market` · **Cost:** 20 credit(s).","operationId":"call_web_search","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_stock_quote":{"post":{"summary":"Котировка US-АКЦИИ (yfinance): цена, изменение%, дневной/52-нед диапазон, капа","description":"Котировка US-АКЦИИ (yfinance): цена, изменение%, дневной/52-нед диапазон, капа. Для фондового анализа (AAPL/MSFT/NVDA/SPY…). Акции не 24/7 — вне сессии последнее закрытие.\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_get_stock_quote","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"}},"required":["ticker"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_stock_history":{"post":{"summary":"Сырые свечи US-акции (OHLC) — оцени тренд/структуру сам","description":"Сырые свечи US-акции (OHLC) — оцени тренд/структуру сам. tf: 1d/1h/15m/5m (4h→1h). У акций НЕТ funding/OI/ликвидаций (это перпы-метрики крипты).\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_get_stock_history","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"tf":{"type":"string"},"bars":{"type":"integer"}},"required":["ticker"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_stock_levels":{"post":{"summary":"Объективные уровни US-акции (S/R по свингам + Фибоначчи + ATR) — тот же движок, что для крипты","description":"Объективные уровни US-акции (S/R по свингам + Фибоначчи + ATR) — тот же движок, что для крипты. Для сетапов входа/стопа по акции.\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_get_stock_levels","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"tf":{"type":"string"}},"required":["ticker"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_stock_info":{"post":{"summary":"Фундаментал-справка US-акции: имя/сектор/капитализация/P/E/бета/дивдоходность/таргет аналитиков/рекомендация (yfinance)","description":"Фундаментал-справка US-акции: имя/сектор/капитализация/P/E/бета/дивдоходность/таргет аналитиков/рекомендация (yfinance). У акций фундаментал важнее, чем у крипты.\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_get_stock_info","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"}},"required":["ticker"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/list_stocks":{"post":{"summary":"Тикеры в фондовом вотчлисте (US-акции, доступные для анализа)","description":"Тикеры в фондовом вотчлисте (US-акции, доступные для анализа).\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_list_stocks","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_stock_score":{"post":{"summary":"Композитный СКОР US-акции (−100","description":"Композитный СКОР US-акции (−100..100): моментум + позиция в диапазоне + овернайт-гэп (контрарно, mean-reversion). Как крипто-скор, но под факторы акций (funding/CVD у акций нет). Один из входов, не истина.\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_get_stock_score","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"}},"required":["ticker"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_stock_earnings":{"post":{"summary":"Ближайший отчёт (earnings) + short interest по US-акции (yfinance)","description":"Ближайший отчёт (earnings) + short interest по US-акции (yfinance). Катализатор тайминга + позиционирование (высокий short% = риск сквиза).\n\n**Scope:** `read:market` · **Cost:** 20 credit(s).","operationId":"call_get_stock_earnings","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"}},"required":["ticker"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_stock_holders":{"post":{"summary":"Структура ВЛАДЕНИЯ US-акцией (аналог топ-холдеров крипты, yfinance): % у институционалов и инсайдеров, число фондов, ТОП","description":"Структура ВЛАДЕНИЯ US-акцией (аналог топ-холдеров крипты, yfinance): % у институционалов и инсайдеров, число фондов, ТОП-фонды с долей и Δ за квартал (pct_change>0 = накопление, данные 13F с лагом). Прямой ответ на 'копят ли фонды' для акций. Любой US-тикер.\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_get_stock_holders","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"limit":{"type":"integer"}},"required":["ticker"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_stock_gap_backtest":{"post":{"summary":"«Машина правды» для фондовой стратегии: гэп ВНИЗ ≥gap_pct на открытии → лонг → +target_pct/закрытие","description":"«Машина правды» для фондовой стратегии: гэп ВНИЗ ≥gap_pct на открытии → лонг → +target_pct/закрытие. Винрейт/PF/edge по истории (прокси по дневным барам, без комиссий — реальный edge ниже). Без ticker — по всему вотчлисту. Для проверки premarket-mean-reversion гипотез.\n\n**Scope:** `read:market` · **Cost:** 20 credit(s).","operationId":"call_get_stock_gap_backtest","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"gap_pct":{"type":"number"},"target_pct":{"type":"number"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/fetch_url":{"post":{"summary":"Прочитать страницу по URL ЦЕЛИКОМ — чистый текст статьи/анонса (не сниппет)","description":"Прочитать страницу по URL ЦЕЛИКОМ — чистый текст статьи/анонса (не сниппет). Связка с web_search: поиск→выбор ссылки→fetch_url. Полезно для полного чтения новостей, регуляторики, ТОЧНЫХ ДАТ событий (затем add_catalyst), постов проектов. JS-страницы могут не извлечься (вернёт пометку).\n\n**Scope:** `read:market` · **Cost:** 20 credit(s).","operationId":"call_fetch_url","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_us_extended_quote":{"post":{"summary":"Pre/post-market по US-акции: цена, изменение к вчерашнему закрытию, КОНСОЛИДИРОВАННЫЙ ОБЪЁМ расширенной сессии, максимум","description":"Pre/post-market по US-акции: цена, изменение к вчерашнему закрытию, КОНСОЛИДИРОВАННЫЙ ОБЪЁМ расширенной сессии, максимум/минимум с временами сделок (Nasdaq, все биржи). Это то, чего НЕТ в get_stock_quote (он даёт последнее закрытие). session: pre (04:00-09:30 ET) | post (16:00-20:00 ET). Вне окна сессии данных нет — это не сбой.\n\n**Scope:** `read:market` · **Cost:** 20 credit(s).","operationId":"call_get_us_extended_quote","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"session":{"type":"string","description":"pre | post"}},"required":["ticker"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_us_movers":{"post":{"summary":"СКАНЕР рынка США по живому потоку тиков: кто оторвался от вчерашнего закрытия прямо сейчас, с объёмом расширенной сессии","description":"СКАНЕР рынка США по живому потоку тиков: кто оторвался от вчерашнего закрытия прямо сейчас, с объёмом расширенной сессии. Сортировка по объём×гэп — движение без объёма не событие. session: pre|regular|post (пусто = любая). ВАЖНО: поле stream говорит, жив ли поток; задержка ~2с — годится для гэпов и моментума, НЕ для скальпинга. Гэп сам по себе не причина — почему он случился, ищи через get_recent_news/search_news.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_us_movers","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"session":{"type":"string"},"min_gap_pct":{"type":"number"},"limit":{"type":"integer"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_us_gap_history":{"post":{"summary":"ЧТО ГЭПИЛО В ПРЕМАРКЕТЕ В ПРОШЛЫЙ ДЕНЬ и чем это кончилось — по НАШИМ минутным барам","description":"ЧТО ГЭПИЛО В ПРЕМАРКЕТЕ В ПРОШЛЫЙ ДЕНЬ и чем это кончилось — по НАШИМ минутным барам. Отвечает на «что было вчера / позавчера», где живой сканер get_us_movers бессилен: он показывает только СЕЙЧАС. Даёт по каждому тикеру: вчерашнее закрытие, закрытие премаркета, гэп %, ЦЕНУ ОТКРЫТИЯ, закрытие дня, ход открытие→закрытие, максимальные просадку и рост внутри дня. day — дата по Нью-Йорку YYYY-MM-DD (пусто = последний доступный). Если дня нет — вернёт список доступных дней, а НЕ пустоту. ⚠️ Это описание того, что БЫЛО. Восстанавливать по нему «где был бы вход и выход» и называть цены, которых нет в ответе, — запрещено.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_us_gap_history","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"day":{"type":"string","description":"YYYY-MM-DD по Нью-Йорку"},"min_gap_pct":{"type":"number"},"limit":{"type":"integer"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_us_gap_stats":{"post":{"summary":"⚠️ В ответе есть готовые table_md и headline — вставь их ДОСЛОВНО, не переписывая числа","description":"⚠️ В ответе есть готовые table_md и headline — вставь их ДОСЛОВНО, не переписывая числа. РАБОТАЕТ ЛИ «гэп в премаркете → откат на открытии» — число вместо рассказа. По группам размера гэпа: медиана хода открытие→закрытие, ДОЛЯ ОТКАТОВ, медианные просадка и рост, и флаг reliable. ⚠️ Сравнивать надо с ФОНОМ (группа ±3%), а не с нулём — у фона доля откатов уже ~55%. reliable=false = группы мало для вывода, так и говори: это ОТСУТСТВИЕ вывода, а не слабый сигнал. На нашей выборке гэпы ВВЕРХ откатывают РЕЖЕ фона, то есть ходовой рецепт «шорти гэп на открытии» данными не подтверждается.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_us_gap_stats","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"min_abs_gap":{"type":"number"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_us_earnings_calendar":{"post":{"summary":"Календарь отчётов США на ближайшие дни с ГЛАВНЫМ полем when: 'до открытия' (гэп на премаркете в тот же день) или 'после ","description":"Календарь отчётов США на ближайшие дни с ГЛАВНЫМ полем when: 'до открытия' (гэп на премаркете в тот же день) или 'после закрытия' (гэп назавтра). Плюс прогноз EPS, число оценок, факт прошлого года, капитализация. Для планирования событийного риска на неделю.\n\n**Scope:** `read:market` · **Cost:** 20 credit(s).","operationId":"call_get_us_earnings_calendar","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"days":{"type":"integer","description":"горизонт в днях, по умолч. 7"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_us_analyst_revisions":{"post":{"summary":"Аналитики по US-акции: консенсус, таргеты (низ/средний/верх, разбивка buy/hold/sell), АПГРЕЙДЫ/ДАУНГРЕЙДЫ и история конс","description":"Аналитики по US-акции: консенсус, таргеты (низ/средний/верх, разбивка buy/hold/sell), АПГРЕЙДЫ/ДАУНГРЕЙДЫ и история консенсуса. Для интрадея важны именно ПЕРЕСМОТРЫ — они двигают гэпы; сам факт рейтинга 'Hold' новостью не является.\n\n**Scope:** `read:market` · **Cost:** 20 credit(s).","operationId":"call_get_us_analyst_revisions","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"}},"required":["ticker"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_us_intraday_levels":{"post":{"summary":"ВНУТРИДНЕВНЫЕ ориентиры US-акции: VWAP, опенинг-рейндж (первые N минут), максимум/минимум премаркета с его объёмом, днев","description":"ВНУТРИДНЕВНЫЕ ориентиры US-акции: VWAP, опенинг-рейндж (первые N минут), максимум/минимум премаркета с его объёмом, дневной диапазон, вчерашнее закрытие. Это НЕ get_stock_levels — тот считает свинговые уровни по дневным свечам (горизонт недели-месяцы), а здесь то, по чему торгуют внутри дня. Уровни объективны — направление из них не следует.\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_get_us_intraday_levels","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"opening_range_min":{"type":"integer","description":"окно опенинг-рейнджа в минутах, по умолч. 15"}},"required":["ticker"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_us_intraday_bars":{"post":{"summary":"Минутные свечи US-акции С ПОМЕТКОЙ СЕССИИ (pre/regular/post) — сырьё, чтобы самому разобрать поведение внутри дня","description":"Минутные свечи US-акции С ПОМЕТКОЙ СЕССИИ (pre/regular/post) — сырьё, чтобы самому разобрать поведение внутри дня. interval: 1m/2m/5m/15m. ВАЖНО: у баров расширенной сессии объём всегда 0 (свойство источника, а не тишина рынка) — объём премаркета бери из get_us_extended_quote.\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_get_us_intraday_bars","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"interval":{"type":"string"},"days":{"type":"integer"},"limit":{"type":"integer"}},"required":["ticker"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/make_chart":{"post":{"summary":"НАРИСОВАТЬ ГРАФИК по нашим данным — ОДНИМ вызовом, без написания кода","description":"НАРИСОВАТЬ ГРАФИК по нашим данным — ОДНИМ вызовом, без написания кода. Бери его всегда, когда просят «нарисуй/покажи график»: он сам достаёт свечи (крипта и US-акции), рисует и возвращает поле `markdown` — вставь его в ответ ДОСЛОВНО. symbols: 1-3 символа (BTC, ETH, AAPL). kind: line (линия), candles (свечи, только для одного актива), compare (сравнение, нормализует к 100%). tf: 5m/15m/1h/4h/1d/1wk/1mo. Писать matplotlib руками через sandbox_exec нужно ТОЛЬКО для нестандартного рисунка (схема, диаграмма), которого здесь нет.\n\n**Scope:** `read:market` · **Cost:** 20 credit(s).","operationId":"call_make_chart","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"symbols":{"type":"array","items":{"type":"string"}},"symbol":{"type":"string"},"tf":{"type":"string"},"bars":{"type":"integer"},"kind":{"type":"string"},"title":{"type":"string"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/sandbox_share":{"post":{"summary":"ОТДАТЬ ПОЛЬЗОВАТЕЛЮ файл из песочницы: график, таблицу, документ, план","description":"ОТДАТЬ ПОЛЬЗОВАТЕЛЮ файл из песочницы: график, таблицу, документ, план. Возвращает поле `markdown` — вставь его в ответ ДОСЛОВНО, не меняя и не подставляя ничего своего. Так пользователь видит изображение прямо в чате и может скачать файл. Сначала создай файл через sandbox_exec (например matplotlib → PNG, или обычная запись текста/CSV), потом поделись им этим инструментом.\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_sandbox_share","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"path":{"type":"string","description":"путь внутри песочницы, например chart.png"}},"required":["path"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_us_quote_l1":{"post":{"summary":"BID/ASK со РАЗМЕРАМИ по US-акциям (Nasdaq, real-time) — то, чего НЕТ в потоке тиков","description":"BID/ASK со РАЗМЕРАМИ по US-акциям (Nasdaq, real-time) — то, чего НЕТ в потоке тиков. Даёт спред в абсолюте и в процентах: по нему судят о СТОИМОСТИ ВХОДА, а цена последней сделки об этом не говорит. До 25 тикеров за раз. Это опрос (~2с), не поток: годится для тех бумаг, что смотришь сейчас, не для сканирования рынка. Стакана глубже первого уровня бесплатно нет.\n\n**Scope:** `read:market` · **Cost:** 20 credit(s).","operationId":"call_get_us_quote_l1","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"tickers":{"type":"array","items":{"type":"string"}},"ticker":{"type":"string"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_us_sectors":{"post":{"summary":"Куда идут деньги по СЕКТОРАМ рынка США: изменение, взвешенное по обороту (а не среднее по тикерам — иначе сектор 'двигаю","description":"Куда идут деньги по СЕКТОРАМ рынка США: изменение, взвешенное по обороту (а не среднее по тикерам — иначе сектор 'двигают' неликвиды), оборот, широта (доля выросших) и лидеры. ВАЖНО для толкования: сильный рост при узкой широте = движение пары имён, а не приток в сектор.\n\n**Scope:** `read:market` · **Cost:** 1 credit(s).","operationId":"call_get_us_sectors","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_us_history":{"post":{"summary":"ИСТОРИЯ по акции США на ГОДЫ назад, с настоящим консолидированным объёмом","description":"ИСТОРИЯ по акции США на ГОДЫ назад, с настоящим консолидированным объёмом. Бери его ВСЕГДА, когда вопрос звучит как «на основе прошлых дней», «а раньше так бывало», «как обычно заканчивались такие движения», «проверь закономерность» — свой поток держит всего две недели, и на нём такие проверки дают выборку из единиц, то есть не дают ответа. timeframe: 1Day (по умолчанию, для сравнения дней) | 1Hour | 15Min | 5Min | 1Min. Либо days=N назад, либо day=YYYY-MM-DD для разбора одного конкретного дня поминутно. ⚠️ Ночная сессия 20:00-04:00 ET сюда НЕ входит и свежее 15 минут тоже — для этого get_us_intraday_bars и get_us_extended_quote.\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_get_us_history","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"timeframe":{"type":"string"},"days":{"type":"integer"},"day":{"type":"string"},"limit":{"type":"integer"}},"required":["ticker"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_us_halts":{"post":{"summary":"Остановки торгов на биржах США","description":"Остановки торгов на биржах США. Код LUDP — выход за лимиты волатильности (обычно резкое движение), T1/T2 — ожидание новости от эмитента. Разные вещи: первое уже произошло, второе ещё впереди.\n\n**Scope:** `read:market` · **Cost:** 5 credit(s).","operationId":"call_get_us_halts","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"integer"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}},"/v1/tools/get_us_insiders":{"post":{"summary":"Свежие Form 4 — сделки инсайдеров (SEC EDGAR)","description":"Свежие Form 4 — сделки инсайдеров (SEC EDGAR). В отличие от квартальных 13F в get_stock_holders, это событие ДНЯ: инсайдер обязан подать в течение 2 рабочих дней после сделки. Без ticker — по US-вотчлисту.\n\n**Scope:** `read:market` · **Cost:** 20 credit(s).","operationId":"call_get_us_insiders","tags":["read:market"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"limit":{"type":"integer"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"credits_used":{"type":"integer","description":"charged for this call; 0 if it failed"},"credits_left":{"type":"integer"},"took_ms":{"type":"integer"},"data":{"description":"the tool's own result"}},"required":["tool","credits_used","data"]}}}},"401":{"description":"No key, revoked, or malformed"},"402":{"description":"Monthly credits exhausted — upgrade or wait for renewal"},"403":{"description":"The key lacks the scope; `required_scope` names it"},"404":{"description":"No such tool"},"429":{"description":"Over the per-minute ceiling for the plan"}}}}}}