Для разработчиков и ИИ-агентов

API и MCP

Факты CAPLERT для ваших программ и ИИ-агентов: REST API и MCP-сервер. Каждый факт приходит с меткой происхождения (замер, расчёт, модель, внешняя метка), источниками и временем сбора. Только чтение.

caplert-api-v1api-allowlist-v1

Виджет для сайта или блога — без ключа

Картинка с последними запечатанными событиями CAPLERT по монете и их исходом через 24 часа и 7 дней — промахи тоже. Обновляется каждые 10 минут, работает без ключа и без скриптов: обычный тег <img> внутри ссылки.

<a href="https://caplert.com/coin/BTC"><img src="https://caplert.com/api/widget?s=BTC&lang=ru" width="360" alt="CAPLERT · BTC"></a>

Параметры: s — тикер; lang=ru|en; theme=light|dark.

1. Получите ключ

Войдите и откройте Настройки → «Ключи API и MCP». Ключ показывается один раз; мы храним только его хэш. Передавайте его в заголовке Authorization: Bearer cap_….

2. REST API

GET /api/v1/facts?symbols=BTC,ETH — факты по 1–5 монетам и по рынку
GET /api/v1/providers — какие поставщики фактов отдаются (с меткой происхождения) и какие исключены и почему
GET /api/v1/journal?symbol=BTC&limit=500 — запечатанный журнал сценариев с цепочкой хэшей

curl -H "Authorization: Bearer $CAPLERT_KEY" "https://caplert.com/api/v1/facts?symbols=BTC,ETH"

curl -H "Authorization: Bearer $CAPLERT_KEY" "https://caplert.com/api/v1/providers"

Каждый лист фактов: id, title, scope, basis, basis_label, symbol, url, lines[], collected_at, sources[]. Строки фактов — на русском (язык реестра). CORS открыт для GET с любого источника: ключ передаётся заголовком, куки не используются. Не храните ключ в коде страницы, видимой другим.

3. MCP-сервер

Адрес: https://caplert.com/api/mcp — Streamable HTTP, без состояния, JSON-ответы. Инструменты: get_facts(symbols[]), list_providers(), get_market_overview(), get_scenario_journal(symbol?).

Claude Code

claude mcp add --transport http caplert https://caplert.com/api/mcp --header "Authorization: Bearer cap_…"

Claude Desktop

Через мост mcp-remote в claude_desktop_config.json:

{
  "mcpServers": {
    "caplert": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://caplert.com/api/mcp", "--header", "Authorization:Bearer ${CAPLERT_KEY}"],
      "env": { "CAPLERT_KEY": "cap_…" }
    }
  }
}

Лимит считают только вызовы инструментов (tools/call); initialize и tools/list бесплатны.

4. Лимиты

Тариф	Вызовов в сутки (UTC)
CAPLERT Free	20000
CAPLERT Pro	20000
CAPLERT Elite	20000
CAPLERT Owner	без потолка

Счёт ведётся по каждому ключу. Сверх лимита — HTTP 429 с JSON {"status":"RATE_LIMITED","limit","used","reset_in_s"} и заголовками X-RateLimit-*, Retry-After. Ответы кэшируются до 5 минут.

5. Что отдаётся и что нет

Только рыночные и монетные факты из явного списка разрешённых поставщиков. Личные данные (портфель, позиции, монитор) не отдаются никогда. Поставщики, зависящие от источников с лицензией «только личное использование» или требующих разрешения, исключены.

quoteзамереноcoinЦена и деривативы
deep_taмодельcoinГлубокий теханализ (волны Эллиотта, Фибоначчи, структура, уровни)
trader_kitрасчётcoinИндикаторы по всем таймфреймам 15м–1н (лента EMA, Supertrend, WaveTrend и поток, RSI, MACD, EMA, Боллинджер) и их согласие
scenariosмодельcoinСценарии и уровни
venuesзамереноcoinБиржи: OI и фандинг
hyperliquidзамереноcoinКрупные трейдеры Hyperliquid
liq_estimateмодельcoinОценочная карта ликвидаций (Binance, Bybit, OKX)
wiki_attentionрасчётcoinВнимание публики: просмотры статьи в Википедии против своей нормы
unlocksвнешняя меткаcoinРазлоки токенов по документации проекта (90 дней)
accuracyрасчётcoinЖурнал сценариев по монете
track_recordрасчётcoinПроверенная история сигналов (что сбывалось раньше)
wiki_attention_marketрасчётmarketРост внимания публики: монеты, чьи статьи в Википедии читают сильнее своей нормы
unlocks_marketвнешняя меткаmarketБлижайшие разлоки токенов (30 дней, по документации проектов)
btc_cycleмодельmarketЦикл биткоина (Pi Cycle, степенной коридор)
fragilityрасчётmarketХрупкость рынка
accuracy_allрасчётmarketЖурнал сценариев сервиса
exchange_reservesзамереноmarketРезервы бирж (раскрытые кошельки)
exchange_transfersзамереноmarketЗаводы и выводы токенов на биржи (24ч)
stable_mintsзамереноmarketВыпуск и сжигание стейблкоинов USDT и USDC (события контрактов, 24ч/7д/30д)
btc_onchainрасчётmarketОнчейн BTC: хешрейт, сложность, доход майнеров, комиссии, мемпул, резервы бирж (раскрытые кошельки)
exchange_transfers_coinзамереноcoinЗаводы и выводы монеты на биржи
liq_feedзамереноmarketФактические ликвидации OKX (часть рынка, не все биржи)
iv_rankрасчётmarketОпционы Deribit: ранг IV за год, перекос, max pain, крупные сделки

Исключены

position — Личные данные: позиция пользователя.
portfolio_risk — Личные данные: риск портфеля пользователя.
my_notes — Личные данные: журнал заметок пользователя по монете.
trader_profile — Личные данные: профиль трейдера и предпочтения ИИ-агента пользователя.
events — События из монитора владельца аккаунта — данные аккаунта, не общий рынок.
critic_notes — Внутренний журнал расхождений с моделью-критиком — контекст для нашего ИИ, не рыночные данные.
profile — Профиль монеты берётся из CoinGecko Demo — только личное использование.
dev_activity — Репозитории монеты находятся через профиль CoinGecko (только личное использование).
arkham_coin — Метки Arkham: условия требуют письменного разрешения.
arkham_market — Метки Arkham: условия требуют письменного разрешения.
verdict — Картина по горизонтам смешивает макро-ряды Yahoo (нужно разрешение) и CoinMarketCap (личное использование).
pro — Проф-метрики включают макро-ряды Yahoo и данные CoinMarketCap.
breadth — Считается из того же снимка проф-метрик (Yahoo, CoinMarketCap).
background — Фон рынка включает макро-ряды Yahoo (нужно разрешение).
market_structure — Доминация и капитализация — CoinGecko / CoinMarketCap (только личное использование).
changes — Ряд состояний строится из снимков с доминацией CoinGecko / CoinMarketCap и макро Yahoo.

Права на источники — на странице «Данные».

Формат опыта агента

Личный ИИ-агент выгружает свой опыт в открытый JSON-формат caplert-agent-v1 (страница «Мой ИИ-агент» → «Перенос опыта»). Через API и MCP профиль не отдаётся — это личные данные; файл скачивает и переносит сам пользователь.

{
  "format": "caplert-agent-v1",
  "version": 1,
  "exported_at": "2026-09-29T10:00:00.000Z",
  "source": "caplert.com",
  "profile": {
    "horizon":  { "value": "swing", "source": "user", "evidence": null, "at": "…" },
    "risk": null, "leverage": null, "language": null, "verbosity": null, "notes": null,
    "timeframes": [{ "value": "4h", "source": "agent",
                     "evidence": "дневник сделок: медиана удержания 2,1 дн по 24 сделкам", "at": "…" }],
    "coins": [], "instruments": [], "emphasis": [], "skip": []
  },
  "accepted_inferences": [{ "key": "timeframes:4h", "field": "timeframes", "value": "4h", "evidence": "…", "accepted_at": "…" }],
  "rejected_inference_keys": ["emphasis:macro"],
  "journal_summary": { "trips": 24, "median_hold_min": 3050, "futures_share": 0.6, "top_symbols": [], "first_close": "…", "last_close": "…" },
  "journal": { "format": "caplert-journal-v1", "…": "optional" }
}

source: user — указал сам пользователь; agent — подсказка агента по данным пользователя, подтверждённая им (evidence — основание).
Значения: horizon scalp|intraday|swing|position|investor; risk low|medium|high; leverage 1–200; timeframes 5m|15m|1h|4h|1d|1w; instruments spot|futures|options; emphasis/skip derivatives|onchain|ta|news|macro; language auto|ru|en; verbosity short|normal|detailed; notes — простой текст до 1000 символов.
rejected_inference_keys — «поле:значение», которые пользователь отклонил: принимающая система не должна предлагать их снова.
Импорт строгий: точные format и version, файл до 2 МБ, только перечисленные поля (неизвестное поле — отказ), строки ограничены по длине, HTML не принимается. Перед применением показывается разница; ничего не удаляется. journal и journal_summary при импорте не применяются.
null — «неизвестно», а не ноль. Предпочтения меняют акценты и форму ответов, это не инвестиционная рекомендация.

6. Условия

Сохраняйте метку происхождения (MEASURED / DERIVED / MODEL / EXTERNAL), источник и время рядом с каждым показанным фактом.
Не перепродавайте и не распространяйте сырые биржевые данные, полученные через API.
Факты и модельные чтения — не инвестиционная рекомендация и не прогноз.
Нет листа или прочерк — это «нет данных», а не ноль.