Справочник API

Базовый URL: https://api.n0brains.com · Все ответы — JSON · Метки времени — Unix epoch (секунды)

Это анализ. Это не финансовый совет.

Всё, что публикует n0brains — сигналы, оценки, референсные цены, уровни инвалидации, целевые уровни, измеренные результаты послед-доходности, trade_signal подсказка действия, /proof страница, всё это — собственный алгоритмический анализ n0brains публичных рыночных данных. Предоставляется только в информационных целях.

Это не инвестиционный совет, рекомендация, предложение, персонализированная стратегия или какая-либо форма консультационной услуги.
Это не адаптировано к вашему портфелю, толерантности к риску или юрисдикции. Одни и те же данные публикуются каждому подписчику.
Референсные уровни — это аналитические пивоты, выведенные из S/R книги ордеров или моделей — не инструкции входить, выходить или ставить стоп по сделке.
n0brains не исполняет сделки, не хранит средства и не действует как брокер, советник или доверенное лицо.
Прошлые результаты — включая смоделированные результаты на /proof — не гарантирует будущие результаты. Сигналы могут ошибаться и будут ошибаться.

Вы несёте единоличную ответственность за каждое торговое решение, которое принимаете, и за любую прибыль или убытки, которые из него следуют. Используя этот API, вы принимаете полные условия обслуживания, включая ограничение ответственности в §8.

Быстрый старт

Создайте аккаунт — получите ваш API-ключ мгновенно
Устанавливайте заголовок X-API-Key в каждом запросе
Вызовите GET /signals — готово

curl -H "X-API-Key: intel_sk_your_key" https://api.n0brains.com/signals

Хотите увидеть, как работают сигналы? Наш живой forward-test здесь: /proof.

Для агентов

Спешите? Quickstart содержит промпты для копирования — однострочник бесплатного уровня и полноценный Pro/MCP агент. Или читайте дальше о деталях.

n0brains — это простой HTTP API — без SDK, без шага установки. Направьте любого агента (Claude Code, OpenClaw, LangChain, собственный оркестратор) на него, передав базовый URL и ваш ключ. Одна строка в инструкциях агента:

Use the n0brains API at https://api.n0brains.com with X-API-Key intel_sk_your_key

Подставьте ваш реальный ключ, и это вся интеграция — агент неявно обнаруживает endpoint'ы по форме API (полный справочник ниже). Базовый URL https://api.n0brains.com, заголовок auth X-API-Key.

Опционально: структурированный файл skill

Некоторые runtime'ы предпочитают структурированный файл skill однострочной инструкции. n0brains-signals.md упаковывает то же самое — frontmatter, каждый инструмент с примерами, auth, обработка ошибок, правила поведения — в один Markdown-файл, который вы кладёте. Однострочник работает столь же хорошо; это для случая, когда вы хотите зафиксировать это в коде.

curl -O https://n0brains.com/openclaw/n0brains-signals.md

Скачать n0brains-signals.md ↓

Runtime	Куда идёт	Auth
OpenClaw	положите `n0brains-signals.md` в каталог skills вашего агента	env `NB_API_KEY`
Claude Code	скопируйте в `~/.claude/skills/n0brains-signals/SKILL.md`	env `NB_API_KEY`
Собственный оркестратор	загрузите `.md` как системный контекст или просто используйте однострочник	ваше хранилище секретов, ключ `n0brains_api_key`
Прямой HTTP / TS клиент	пропустите skill — используйте endpoint'ы ниже или n0brains-ts клиент	заголовок `X-API-Key`

Предпочитаете типизированные вызовы? Опциональный клиент TypeScript n0brains-ts (@n0brains/client) оборачивает каждый endpoint. Или CLI для shell, и MCP server для Claude Desktop / Cursor / Cline.

Планы и кредиты

Бесплатный и Pro — два уровня подписки (лимиты запросов выше). Сверх включённого в ваш уровень лимита у вас есть два варианта оплаты по мере использования:

Опция	Как это работает	Аккаунт?
Кредиты оплаты за вызов	Одноразовые пакеты (от $5). Кредит тратится только на вызов данных, сделанный сверх включённого в ваш план лимита запросов — в пределах лимита вызовы остаются бесплатными. Покупайте и отслеживайте их в вашем аккаунт.	Да — карта через Stripe
x402	Платите за запрос в USDC на Base, без регистрации. См. /docs/x402.	Нет — без кошелька

Когда у вас кончились кредиты и вы превысили лимит запросов, endpoint'ы данных возвращают 402 со ссылкой на покупку. В пределах лимита запросов ничего не списывается.

Аутентификация

Все аутентифицированные endpoint'ы требуют API-ключ через заголовок X-API-Key. Ключи генерируются при регистрации и могут быть ротированы через POST /auth/api-keys.

Вход также возвращает JWT-токен, пригодный через Authorization: Bearer.

Метод	Заголовок	Пример
API Key	`X-API-Key`	`intel_sk_a1b2c3...`
JWT Token	`Authorization`	`Bearer eyJhbGci...`

Лимиты запросов

Уровень	Запросов/мин	Задержка сигнала	Доступ
Бесплатный	60	15 минут	Только REST API, ограниченные поля. MCP `tools/list` открыт для обнаружения каталога.
Pro	600	В реальном времени	REST + WebSocket + Webhooks + MCP-сервер, полные поля

Превышение лимита запросов возвращает 429 с сообщением, указывающим на страницу апгрейда.

Endpoint'ы

Метод	Путь	Auth	Описание
GET	`/health`	Нет	Проверка жизнеспособности
GET	`/signals`	API Key	Список активных сигналов. Фильтруйте с `?asset=`, `?signal_type=`, `?urgency=`, `?direction=` и `?asset_class=` (`crypto` · `stock` · `metal` · `commodity` · `index`), чтобы сузить до крипто или токенизированного фондового рынка
GET	`/signals/{id}`	API Key	Детали одного сигнала
GET	`/signals/similar`	Pro	Семантический поиск ближайших соседей
GET	`/narrative/{coin}`	Pro	Нарративная тепловая карта для актива
GET	`/manipulation/{coin}`	Pro	Оценка манипуляции для актива
GET	`/trust/{coin}`	Pro	Оценка доверия и скама для токена
GET	`/levels/{coin}`	API Key	Уровни S/R от Hyperliquid
GET	`/indicators/{coin}`	API Key	Технические индикаторы — RSI, MACD, SMA/EMA (20/50/200 + 200-недельная), Stochastic, Fibonacci, чтение тренда/моментума
GET	`/state/{coin}/brief`	Pro	Проза-анализ, написанный LLM — текущее прочтение, ключевые + структурные уровни, макро/on-chain, техника, прогноз. Нарративный слой над /state, обоснованный только нашими данными
GET	`/liquidation-map/{coin}`	API Key	Оценочные зоны кластеров ликвидации на CEX (смоделированы из OI + уровней плеча)
GET	`/liqmap/{coin}`	API Key	Реальная on-chain карта ликвидаций на DEX — реальные позиции с точными ценами ликвидации. Крипто (Hyperliquid + GMX) и токенизированный фондовый рынок через Hyperliquid HIP-3 (`/liqmap/SP500`, `/liqmap/NVDA`, `/liqmap/GOLD`, …)
GET	`/liquidation-heatmap/{coin}`	API Key	Тепловая карта ликвидаций CEX — сетка интенсивности цена×время. `?days=` (1–180), `?rows=`, `?cols=`
GET	`/liq-heatmap/{coin}`	API Key	Тепловая карта ликвидаций реальных позиций на DEX — сетка цена×время (BTC/ETH)
GET	`/charts/options-walls/{symbol}`	Нет	Стены открытого интереса по листингованным опционам + агрегированный max pain (CBOE, с задержкой) для акции/индекса — фондовый аналог кластеров ликвидации. Стены страйков действуют как магниты/пины к экспирации.
GET	`/charts/stock-candles/{symbol}`	Нет	Сессионные свечи реальной биржи (Yahoo, с задержкой) для базового актива токенизированного актива — накладывайте на токенизированную цену 24/7. `?days=`
GET	`/charts/hip3-estimate-heatmap/{symbol}`	Нет	Смоделированная тепловая карта плотности ликвидаций для токенизированной акции/металла/индекса — проекция по уровням плеча из живого открытого интереса Hyperliquid HIP-3 на реальную траекторию цены (плотность в стиле Coinglass там, где тонкая on-chain книга разрежена). `?days=`
GET	`/correlation`	API Key	Матрица корреляции доходностей между активами (7д). `?vs=BTC`, `?coins=…`
GET	`/correlation/{coin}`	API Key	Корреляция + бета одной монеты к BTC/ETH + пиры
GET	`/rotation`	API Key	Чтение альтсезона/ротации — into_alts / into_btc / neutral
GET	`/options/{coin}`	API Key	Аналитика опционов (BTC/ETH): ATM IV, skew, срочная структура, max-pain
GET	`/sentiment/{coin}`	API Key	Агрегированное настроение — чистый уклон, объём, скорость (курируемые источники)
GET	`/mindshare`	API Key	Рейтинг доли внимания — доля каждого актива + скорость (растёт/падает)
GET	`/mindshare/{coin}`	API Key	Доля mindshare, ранг и скорость одной монеты
GET	`/market-opens`	API Key	Цены открытия сессий
GET	`/price/{coin}`	Нет	Текущая спот/средняя цена одной монеты (Hyperliquid)
GET	`/prices?coins=BTC,ETH,SOL`	Нет	Пакетные текущие цены одним вызовом
GET	`/market-state/{coin}`	Pro	Консенсус подтверждённых сигналов по монете — направление, уверенность, режим, ключевые драйверы
GET	`/state`	Pro	Единое состояние рынка — режим + композит, макро-пакет, подтверждённые типы, свод по монетам одним вызовом
GET	`/state/{coin}`	Pro	Обзор по монете одним вызовом — цена, market-state, режим + композит, уровни, технические индикаторы, цель liqmap
GET	`/plan/{coin}`	Pro	Собранный торговый план — направление, вход, сильнейшая цель (взвешенная по силе, а не ближайшая), стоп, риск/доходность, подсказка по размеру, контекст опционов (put/call + skew) и предупреждения (тайминг max-pain против сделки, вход рядом с кластером ликвидации). Слой синтеза над /state + /levels + /options
GET	`/rank?coins=BTC,ETH,SOL`	Pro	Межактивное ранжирование — собранные торговые планы для заданных монет, отсортированные по setup_score (лучший первым). Отвечает на «какая монета — лучшая сделка прямо сейчас?»
POST	`/check`	API Key	Сначала спросите n0brains — предторговая проверка. Отправьте сделку (`asset`, `side`, опционально `entry`/`stop`/`target`/`leverage`/`horizon_hours`) → оценённая по A–F оценка условий с каждой причиной: скученность, риск событий, дистанция ликвидации против волатильности, растяжение моментума, позиционирование и структурная проверка фатального стопа. Возвращает `grade`, `score`, `engine_version`, `asset_class`, `flags`, `supports`, `falsifiers`, `terrain`, `unchecked`. Работает для крипто и токенизированного фондового рынка (NVDA, SP500, XYZ100, GOLD…). Каждый вердикт надёжно логируется и разрешается на своём горизонте. Производительность между грейдами удерживается, пока развёрнутый шлюз калибровки накапливается. Бесплатно 3/день, Pro безлимитно. Передайте `"chart": true` для брендированного PNG.
POST	`/check/anon`	Нет	Одна анонимная предторговая проверка в день на IP (со шлюзом Turnstile). Тот же оценённый ответ, что и `/check`.
GET	`/checks/history`	API Key	Ваши прошлые проверки + разрешённые исходы (доходность с поправкой на сторону на горизонте или стоп, если он был достигнут первым).
GET	`/check/assets`	Нет	Проверяемая вселенная активов — крипто-перпы + токенизированные акции/металлы/индексы.
POST	`/check/chart-parse`	API Key	Считывает тикер + таймфрейм со скриншота графика (зрение), чтобы агент мог передать проверке сырое изображение. Только идентификация — никогда цены из пикселей.
POST	`/check/levels`	API Key	Оцените ваши собственные нарисованные горизонтальные уровни против наших зон S/R + on-chain кластеров ликвидации (магнит на линии / риск фитиля за линией).
GET	`/macro`	API Key	Ежедневные макро-условия/режим; уклон по активу когда доступен
GET	`/macro?history=N`	Pro	Исторические снимки Macro Pulse (последние N отчётов, макс 30)
GET	`/regime`	API Key	Аппетит к риску по всему рынку — risk-on / risk-off / squeeze + знаковая оценка риска и направленный `market_bias`, смешанный из макро-композита, поперечной широты, режима funding и волатильности. Отвечает на «благоприятствуют ли условия риску прямо сейчас?» Описательно, кандидат.
GET	`/liquidity`	API Key	Карта чистой межактивной ликвидности — чистая ликвидность ФРС, мультичейн-сухой-порох стейблкоинов (DefiLlama), суммарный OI перпов, концентрация плеча между площадками (хрупкость каскада), давление ликвидаций, чистый поток тейкеров. Отвечает на «где ликвидность?»
GET	`/flows`	API Key	Межактивные потоки — крипто-ротация, разделение OI крипто-против-tradfi по классам активов и институциональная позиция (ETF / COT / 13F, описательно). Отвечает на «куда идут средства и покупает ли рынок что-то кроме крипто?»
GET	`/market-map`	API Key	Композиция /regime + /liquidity + /flows одним вызовом — полная межактивная картина рынка.
GET	`/discovery`	API Key	Обнаружение возникающего edge — комбинации классов подтверждения, добытые из теневого леджера, против реализованных послед-доходностей, ранжированные по измеренному edge (со шлюзом честности). Выявляет паттерны, которые никто не кодировал вручную. `status=accruing`, пока леджер не наполнится.
GET	`/performance`	Нет	Публичная статистика доли выигрышей / PnL
GET	`/proof`	Нет	Табло послед-доходности — доля выигрышей по типу, превышение над BTC, ДИ, флаг подтверждённости (питает /proof)
GET	`/proof/equity`	Нет	Кривая эквити накопления edge по сигналам подтверждённых типов
GET	`/public/feed`	Нет	Публичная лента сигналов с задержкой (поток бесплатного уровня с задержкой 15 мин)
GET	`/status/uptime`	Нет	Снимок аптайма / статуса сервиса
POST	`/auth/register`	Нет	Создать аккаунт
POST	`/auth/login`	Нет	Войти
GET	`/auth/me`	API Key	Профиль пользователя
POST	`/auth/api-keys`	API Key	Сгенерировать новый API-ключ
DEL	`/auth/api-keys/{id}`	API Key	Отозвать API-ключ
POST	`/billing/checkout`	API Key	Оформление подписки Stripe (Pro)
POST	`/billing/buy-credits`	API Key	Разовая оплата Stripe за пакет кредитов
GET	`/billing/credit-packs`	API Key	Список приобретаемых пакетов кредитов
GET	`/credits`	API Key	Баланс кредитов + история транзакций
POST	`/billing/portal`	API Key	Клиентский портал Stripe
POST	`/webhooks`	Pro	Зарегистрировать webhook
DEL	`/webhooks/{id}`	Pro	Удалить webhook
WS	`/stream`	Pro	Поток сигналов в реальном времени
POST	`/mcp/`	Pro (tools/call); open (tools/list)	MCP-сервер — инструменты только для чтения для Claude Desktop, Cursor, Cline. См. /docs/mcp.

Предпочитаете командную строку? n0brains CLI оборачивает каждый endpoint в команду без зависимостей, печатающую JSON — создано для торговых агентов и shell-пайплайнов. Агенты без аккаунта также могут платите за вызов в USDC на Base (x402) — без ключа, без регистрации.

GET /signals

Возвращает активные сигналы, опционально отфильтрованные. Бесплатный уровень получает сигналы с задержкой 15 минут.

Параметры запроса

Param	Тип	Описание
`asset`	string	Фильтр по тикеру (напр. BTC)
`signal_type`	string	regulatory, whale, whale_position, sentiment, price, hack, listing, macro, macro_flow, macro_pulse, liquidation, funding, deleverage, unlock, research, other.
`direction`	string	bullish, bearish, neutral
`urgency`	string	high, medium, low
`limit`	int	1-200 (default 50)
`offset`	int	Смещение пагинации (по умолчанию 0)
`include_opens`	bool	Включать цены открытия рынка (по умолчанию true)
`min_confidence`	float	Минимальная оценка уверенности (0.0–1.0, по умолчанию 0.0)
`min_score`	float	Минимальная оценка сигнала (по умолчанию 0.0)
`band`	string	Фильтр по полосе качества сделки: A+, A, B, C, D
`min_trade_quality`	float	Минимальная оценка качества сделки (0.0–1.0, по умолчанию 0.0)
`proven_only`	bool	Только типы сигналов, доказанно обгоняющие BTC (alpha) и прибыльные по направлению (по умолчанию false)
`tradeable_only`	bool	Только сигналы `conviction=strong` (по умолчанию false)

Ответ - Бесплатный уровень

{
  "count": 3,
  "signals": [
    {
      "id": 195,
      "asset": null,
      "signal_type": "regulatory",
      "direction": "neutral",
      "urgency": "medium",
      "summary": "Senate Banking Committee scheduled to vote on the Clarity Act crypto bill.",
      "confidence": 0.15,
      "conviction": "watch",
      "action_hint": "monitor",
      "corroborated": false,
      "score": 0.27,
      "trade_quality_score": 0.61,
      "trade_quality_band": "B",
      "expected_move_pct": null,
      "regime_at_signal": "risk-off",
      "timestamp": 1778555605,
      "expires_at": 1778570005,
      "type_performance": {
        "excess_pct": 0.3,
        "hit_rate": 0.08,
        "proven": false,
        "n": 398
      },
      "disclaimer": "Analytical data only. Not financial advice."
    },
    {
      "id": 196,
      "asset": "ETH",
      "signal_type": "sentiment",
      "direction": "bearish",
      "urgency": "high",
      "summary": "Sharp negative social shift on ETH as funding flips and large holders trim.",
      "confidence": 0.71,
      "conviction": "strong",
      "action_hint": "trade_signal",
      "corroborated": true,
      "score": 1.38,
      "trade_quality_score": 0.74,
      "trade_quality_band": "A",
      "regime_at_signal": "risk-off",
      "timestamp": 1778555800,
      "expires_at": 1778570200,
      "reference_price": 3210,
      "invalidation_level": 3274.2,
      "target_level": 3081.6,
      "levels_basis": "model",
      "type_performance": {
        "excess_pct": 4.96,
        "hit_rate": 0.61,
        "proven": true,
        "n": 1016
      },
      "historical_edge": {
        "cell": "sentiment|bearish|risk-off",
        "sample_n": 36,
        "win_rate": 0.97,
        "avg_pnl_pct": 7.19,
        "median_pnl_pct": 6.9,
        "as_of": "2026-05-27T02:09:02+00:00"
      },
      "disclaimer": "Analytical reference levels for informational purposes only. Not a recommendation to buy or sell, and not financial advice."
    },
    {
      "id": 197,
      "asset": "BTC",
      "signal_type": "regulatory",
      "direction": "bullish",
      "urgency": "medium",
      "summary": "Industry group endorses ETF approval extension; broader institutional access expected.",
      "confidence": 0.45,
      "conviction": "notable",
      "action_hint": "alert",
      "corroborated": true,
      "score": 0.81,
      "trade_quality_score": 0.52,
      "trade_quality_band": "C",
      "regime_at_signal": "squeeze",
      "timestamp": 1778556100,
      "expires_at": 1778570500,
      "type_performance": {
        "excess_pct": -2.1,
        "hit_rate": 0.04,
        "proven": false,
        "n": 352
      },
      "historical_edge": {
        "cell": "regulatory|bullish|squeeze",
        "sample_n": 128,
        "win_rate": 0,
        "avg_pnl_pct": -4.91,
        "median_pnl_pct": -4.65,
        "as_of": "2026-05-27T02:09:02+00:00"
      },
      "paired_inverse": {
        "direction": "bearish",
        "basis": "historical_anti_predictive_cell",
        "implied_avg_pnl_pct": 4.91,
        "flipped_cell_stats": {
          "n": 14,
          "win_rate": 0.93,
          "avg_pnl_pct": 3.92
        },
        "advisory_text": "Historical 0% win rate (128 samples) on bullish regulatory in squeeze regime suggests fade. Not a recommendation — informational only.",
        "citation": "De Bondt & Thaler 1985 JoF; Tetlock 2007 JoF; Chan 2003. Short-term overreaction to dramatic news reverses on horizon of days–weeks. Crypto: PLOS One 2024."
      },
      "disclaimer": "Analytical data only. Not financial advice."
    }
  ],
  "market_opens": {
    "tokyo": {
      "BTC": 81150,
      "ETH": 3200.5,
      "SOL": 96.3,
      "timestamp": 1778539200
    },
    "london": {
      "BTC": 81201.5,
      "ETH": 3205,
      "SOL": 96.48,
      "timestamp": 1778553600
    },
    "new_york": {
      "BTC": 81262.5,
      "ETH": 3210,
      "SOL": 96.55,
      "timestamp": 1778560800
    }
  }
}

Дополнения уровня Pro

Каждый объект сигнала включает эти дополнительные поля:

{
  "sources": [
    "news",
    "whale"
  ],
  "source": "news",
  "channel": "google_crypto"
}

Поля сигнала

Поле	Тип	Описание
`id`	int	Уникальный ID сигнала
`asset`	string\|null	Символ тикера или null, если общерыночный
`signal_type`	string	regulatory, whale, whale_position, sentiment, price, hack, listing, unlock, research, macro, macro_flow, macro_pulse, liquidation, funding, deleverage, other
`direction`	string	bullish, bearish, neutral
`urgency`	string	high, medium, low
`summary`	string	Описание не более 100 символов
`confidence`	float	0.0-1.0, калиброванная P(выигрыша) — эмпирическая доля выигрышей по типу сигнала, разбитая по корзинам, из результатов закрытых сделок (не сырая оценка LLM). Обновляется еженедельно.
`conviction`	string	`strong`, `notable`, `watch`, `none` — наша аналитическая оценка силы сигнала (не торговая инструкция). strong основана на данных: применяется только к типам сигналов, чей измеренный послед-доходный рекорд преодолевает нашу статистическую планку (см. /proof), в верхней части распределения оценок этого типа и только когда ожидаемое движение перекрывает издержки полного цикла (движение, слишком малое, чтобы перекрыть комиссии + проскальзывание, понижается до `notable`). Используйте это поле.
`action_hint`	string	Устарело — прежнее имя `conviction` (`trade_signal`↔strong, `alert`↔notable, `monitor`↔watch, `ignore`↔none). Всё ещё выдаётся в этом релизе для обратной совместимости; будет удалено. Перейдите на `conviction`.
`corroborated`	bool	true, когда несколько источников подтверждают актив И недавние прочтения не противоречат направлению в чистом виде (с учётом направления — bullish-вызов не подтверждается bearish-болтовнёй по той же монете)
`score`	float	IC-взвешенный составной: source_weight x urgency x calibrated_confidence x информационный коэффициент типа сигнала
`timestamp`	int	Unix epoch (секунды)
`expires_at`	int	Когда этот сигнал истекает
`sources`	array	Только Pro - Имена источников, внёсших вклад
`source`	string	Только Pro - Имя первичного источника
`channel`	string	Только Pro - Конкретный канал/лента
`trade_quality_score`	float	составное качество сигнала 0.0–1.0 (режим + уверенность + подтверждение)
`trade_quality_band`	string	полоса качества A+/A/B/C/D — A+ ≥ 0.85, A ≥ 0.70, B ≥ 0.55, C ≥ 0.40
`expected_move_pct`	float\|null	Оценочный размер движения как % от цены на основе ближайшей дельты S/R + ATR
`type_performance`	object	Измеренный послужной список этого типа сигнала: `{excess_pct, hit_rate, proven, n}` — послед-доходность против BTC (alpha) на 1ч, доля попаданий, флаг подтверждённости, размер выборки
`reference_price`	float	только trade_signal — алгоритмическая референсная цена (аналитическая, не рекомендация входа)
`invalidation_level`	float	только trade_signal — цена, которая опровергла бы тезис сигнала
`target_level`	float	только trade_signal — ближайшая аналитическая цель в направлении сигнала
`levels_basis`	string	только trade_signal — sr_touches (S/R книги ордеров) или model (выведенный)
`resistance_low` / `resistance_high`	float	Зонная полоса уровня сопротивления (S/R — это область, а не линия) — ценовой диапазон кластера касаний. Целься в край зоны, а не в середину.
`support_low` / `support_high`	float	Зонная полоса уровня поддержки — та же идея со стороны поддержки.
`resistance_flipped` / `support_flipped`	bool	Инверсия полярности: true, когда этот уровень изначально имел противоположную роль, а цена с тех пор пробила его насквозь (старая поддержка теперь действует как сопротивление, или наоборот). Инвертированный уровень реален, но несёт немного меньший вес силы.
`regime_at_signal`	string	Режим рынка при генерации сигнала: risk-on, risk-off, range, squeeze
`manipulation_score`	float	вероятность координации/манипуляции 0.0–1.0 на момент создания сигнала
`wallet_type`	string\|null	Только whale-сигнал — vc_institutional, smart_whale, market_maker, mev_arb, sniper и др.
`smart_money_score`	float\|null	Только whale-сигнал — достоверность исходного кошелька (0.0–1.0)
`trust_score`	float\|null	Сигналы launchpad/токенов — составное доверие к контракту (0.0–1.0)
`rug_probability`	float\|null	Сигналы launchpad/токенов — оценочная вероятность rug/скама (0.0–1.0)
`is_honeypot`	bool\|null	Сигналы launchpad/токенов — флаг honeypot от GoPlus
`historical_edge`	object\|null	Описательная статистика для ячейки `(signal_type × direction × regime_at_signal)` этого сигнала из измеренных послед-доходностей сигналов. Объект: `{cell, sample_n, win_rate, avg_pnl_pct, median_pnl_pct, as_of}`. Обновляется еженедельно. Null, когда режим или тип отсутствуют.
`paired_inverse`	object\|null	Уведомление о противоположном направлении. Присутствует только когда историческая ячейка эмпирически анти-предиктивна (n ≥ 30, win_rate ≤ 30%, avg_pnl ≤ -2%). Объект: `{direction, basis, implied_avg_pnl_pct, flipped_cell_stats, advisory_text, citation}`. Ссылается на рецензируемую литературу о краткосрочном развороте (De Bondt & Thaler 1985, Tetlock 2007, Chan 2003, PLOS One 2024). Информационно; никогда не торговая рекомендация.

Исторический edge и парная инверсия

Каждый сигнал несёт объект historical_edge, описывающий измеренные послед-доходности прошлых сигналов в той же ячейке (signal_type × direction × regime_at_signal). Статистика обновляется еженедельно. Поля описательны — они не фильтруют, не задают размер и не рекомендуют.

Когда ячейка эмпирически анти-предиктивна (n ≥ 30 закрытых сделок, доля выигрышей ≤ 30%, средний PnL ≤ -2%), сигнал также несёт объект paired_inverse. Он выявляет прочтение противоположного направления того же события вместе со ссылкой на рецензируемую литературу о краткосрочном развороте (De Bondt & Thaler 1985, Tetlock 2007, Chan 2003, PLOS One 2024). Представлено как данные, а не рекомендация: поле flipped_cell_stats показывает, как ячейка противоположного направления фактически показывала себя исторически, что часто слабее, чем предположил бы implied_avg_pnl_pct в терминах чистой инверсии.

Используйте эти поля, чтобы интерпретировать качество сигнала в контексте. Сигнал с сильным historical_edge (высокий win_rate, большой avg_pnl_pct, большой sample_n) надёжнее того же сигнала в ячейке, где edge слаб или инвертирован. Статистика ячейки и любое уведомление о парной инверсии предназначены для вашего собственного анализа — это не торговые рекомендации, и мы не предлагаем размеры позиций или плечо.

GET /levels/{coin}

Возвращает ближайшую поддержку/сопротивление из книги ордеров Hyperliquid — как зоны (каждый уровень несёт свою ценовую полосу), с отслеживанием инверсии полярности (пробитая поддержка показывается как сопротивление, и наоборот).

{
  "coin": "BTC",
  "current_price": 81262.5,
  "nearest_resistance": 81450,
  "nearest_support": 80871,
  "all_resistance": [
    81450,
    81800,
    82200,
    82500,
    83000
  ],
  "all_support": [
    80871,
    80500,
    80000,
    79500,
    79000
  ]
}

GET /market-opens

Цены открытия для BTC, ETH и SOL на каждой основной торговой сессии.

{
  "market_opens": {
    "tokyo": {
      "BTC": 81150,
      "ETH": 3200.5,
      "SOL": 96.3,
      "timestamp": 1778539200
    },
    "shanghai": {
      "BTC": 81180,
      "ETH": 3202,
      "SOL": 96.35,
      "timestamp": 1778542800
    },
    "hong_kong": {
      "BTC": 81190,
      "ETH": 3203.5,
      "SOL": 96.4,
      "timestamp": 1778542800
    },
    "london": {
      "BTC": 81201.5,
      "ETH": 3205,
      "SOL": 96.48,
      "timestamp": 1778553600
    },
    "new_york": {
      "BTC": 81262.5,
      "ETH": 3210,
      "SOL": 96.55,
      "timestamp": 1778560800
    }
  }
}

GET /macro

Макро-условия — ежедневный детерминированный композит чистой ликвидности (баланс ФРС − TGA − RRP), индекса доллара, реальных доходностей, кривой 2s10s, M2 и VIX, объединённый с предстоящим высоко-влиятельным календарём и недавней разведкой. Ответ /macro всегда несёт композит и драйверы; уклон по активу включается только когда его поддерживающая модель доступна, иначе явно удерживается.

Объект верхнего уровня current содержит последний отчёт. Добавьте ?history=N (Pro, макс 30), чтобы включить предыдущие снимки; бесплатные аккаунты получают только текущий отчёт. Bias и conviction обнуляемы и явно удерживаются, когда поддерживающих данных недостаточно.

{
  "current": {
    "generated_at": "2026-07-16T07:00:00+00:00",
    "window_days": 7,
    "horizon": "week",
    "regime": "range",
    "calibration": "uncalibrated",
    "btc": {
      "bias": null,
      "conviction": null,
      "status": "insufficient data",
      "sample_size": 3,
      "sufficient_data": false,
      "reason": "Per-asset directional bias withheld until live sample coverage is sufficient."
    },
    "eth": {
      "bias": null,
      "conviction": null,
      "status": "insufficient data",
      "sample_size": 2,
      "sufficient_data": false,
      "reason": "Per-asset directional bias withheld until live sample coverage is sufficient."
    },
    "calendar_risks": [],
    "disclaimer": "AI-generated macro commentary; directional conviction is not calibrated. Not financial advice."
  }
}

Справочник полей

Поле	Тип	Описание
`regime`	string	risk-on, risk-off, range, squeeze
`regime_reason`	string	обоснование ≤120 символов
`current.btc.bias` / `current.eth.bias`	string \| null	bullish, bearish, neutral или null, когда удержано из-за недостатка данных
`current.btc.conviction` / `current.eth.conviction`	float \| null	Заявленная моделью уверенность 0.0–1.0 или null, когда удержано; не калиброванная реализованная вероятность
`btc.reason` / `eth.reason`	string	Основной драйвер, ≤140 символов
`btc.key_levels` / `eth.key_levels`	string	Релевантные макро-пивоты
`btc.invalidation` / `eth.invalidation`	string	Что аннулирует вызов
`calendar_risks`	array	Топ 1–3 предстоящих события, которые могут перевернуть уклон
`window_days`	int	Окно ретроспективы (7 дневное / 30 недельное)
`horizon`	string	Метка будущего горизонта (напр. «week», «next two weeks»)
`generated_at`	string	ISO-8601 UTC. Устаревает через 36ч — клиентам следует перезапросить.

Endpoint'ы аутентификации

POST /auth/register

Создаёт новый аккаунт. Сразу возвращает API-ключ.

{
  "api_key": "intel_sk_a1b2c3d4e5f6...",
  "key_prefix": "intel_sk",
  "tier": "free",
  "message": "Save your API key - it will not be shown again."
}

POST /auth/login

{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "tier": "free",
  "api_keys": [
    {
      "id": 1,
      "prefix": "intel_sk_a1b2",
      "name": "default",
      "created_at": 1778555605
    }
  ]
}

WebSocket /stream

Только уровень Pro. Подключитесь, чтобы получать сигналы в реальном времени.

wss://api.n0brains.com/stream?api_key=intel_sk_...

Signal received:
{"type": "signal", "data": {"id": 195, "asset": "BTC", "signal_type": "whale", "direction": "bullish", "urgency": "high", "summary": "Strategy buys 535 BTC for $43M", "confidence": 0.95, "score": 1.42, "trade_quality_band": "A", "regime_at_signal": "risk-on"}}

Ping/pong:
send: "ping"
recv: {"type": "pong", "timestamp": 1778555605}

Webhooks

Только уровень Pro. Зарегистрируйте URL для получения POST-доставок новых сигналов.

POST /webhooks

{
  "id": 1,
  "url": "https://your-server.com/hooks/n0brains",
  "secret": "a1b2c3d4...",
  "events": "signal.created",
  "note": "Use X-Intel-Signature header to verify deliveries. Secret is shown only once."
}

Формат доставки

Отправьте POST на ваш URL с заголовком X-Intel-Signature:

{
  "event": "signal.created",
  "timestamp": 1778555605,
  "data": {
    "id": 195,
    "asset": "BTC",
    "signal_type": "whale",
    "direction": "bullish",
    "urgency": "high",
    "summary": "Strategy buys 535 BTC for $43M",
    "confidence": 0.95,
    "score": 1.42,
    "trade_quality_band": "A",
    "regime_at_signal": "risk-on"
  }
}

Источники данных и оценка

Pipeline получает данные от перечисленных ниже наблюдателей. Каждый источник несёт вес, который умножается в итоговую оценку сигнала — так что то, что вы читаете, не сырой дамп ленты, а одно подтверждённое, ранжированное число.

score = source_weight × urgency_weight × confidence_decayed

Веса срочности: low: 1.0, medium: 2.0, high: 3.0

Затухание уверенности: уверенность экспоненциально затухает с возрастом. confidence_decayed = confidence₀ × exp(−age / τ), где τ = период полураспада / ln(2) по типу сигнала (liquidation: ~43мин, hack/sentiment/listing: ~2.9ч, whale/price/funding: ~8.7ч, regulatory: ~5.8ч, macro: ~11.5ч, macro_pulse: ~34.6ч). Устаревший сигнал имеет более низкую оценку, чем свежий такого же качества.

Самонастройка веса источника: веса ежедневно корректируются по EMA на основе отслеживаемых долей выигрышей результатов. Источники, срабатывающие верно, усиливаются до 1.4×; отстающие приглушаются до 0.6×. Минимум 10 результатов перед корректировкой.

Активные наблюдатели

Telegram - WatcherGuru, ZachXBT Investigations, yoyodexhaber, sondakikav
News RSS - 15 лент (Reuters, AP, BBC, CNBC, Bloomberg, CoinDesk, CoinTelegraph, Decrypt, Google News и др.)
Government RSS - 11 лент (White House, SEC, CFTC, Fed, Kremlin, Xinhua, TASS, EU и др.)
CoinMarketCap - Ценовые оповещения, трендовые монеты
Macro - Fear and Greed Index, DeFi TVL
Derivatives - Позиционирование funding/открытого интереса на нескольких площадках и публичные отпечатки ликвидаций OKX
Market Opens - Цены BTC/ETH/SOL на открытии сессий Токио, Шанхай, Гонконг, Лондон, Нью-Йорк
Exchange Listings - Реальные катализаторы листингов CEX: launchpad/launchpool Binance & Bybit, плюс обнаружение новых спот-рынков (diff списка символов) на Binance, Upbit (Корея / kimchi premium) и OKX. Запуски мемкоинов Pump.fun / Raydium убраны — они составляли ~98% старой ленты листингов без торгуемого edge.
ETF Flows - Ежедневные чистые потоки спотовых ETF BTC + ETH + SOL в США через SoSoValue (бесплатный публичный API). Выдаётся как контекст (macro_flow, ненаправленный): бэктест показал, что чистый приток в ETF не предсказывает послед-доходности — это совпадающий/запаздывающий отпечаток спроса (притоки SOL были контрарными).
Stablecoin Flows - Deploy/погашение казны USDT/USDC + чистый приток, подготовленный к кошелькам бирж, плюс тренд общего предложения стейблкоинов (DeFiLlama). Опережающее чтение ликвидности (приток стейблкоинов на биржи опережает краткосрочные доходности BTC/ETH в наших данных); совокупное предложение — контекст сухого пороха.
On-Chain Valuation - Coin Metrics (бесплатно): MVRV, притоки/оттоки бирж + резервы, активные адреса (BTC + ETH). Чистый ОТТОК с бирж / снижение резервов = накопление в самостоятельном хранении; MVRV отображает прибыль/пену цикла. Питает on-chain ногу составного Macro Pulse; выдаётся как контекст.
Token Unlocks - Календарь эмиссий DeFiLlama (бесплатно). Существенные ближайшие разблокировки (обрывы инсайдеров/инвесторов) по торгуемым токенам = запланированное предложение, которое продавцы опережают → сигнал unlock, bearish. Самоподтверждается через шлюз послед-доходности.
TradFi & CME - Yahoo Finance (бесплатно): гэп фьючерсов CME BTC/ETH (гэпы выходных склонны закрываться — повторяющееся чтение уровня) плюс контекст межактивной корреляции SPX/золото.
Smart Money - Alchemy ETH WebSocket (alchemy_pendingTransactions) по 408 курируемым кошелькам + резервный вариант подтверждённых tx Etherscan V2. 700+ проверенных помеченных адресов (CEX hot/cold, market maker, институциональный, умный трейдер), еженедельно автообновляемых из облака меток Etherscan + сканирования наибольшего объёма Alchemy. MEV-боты отфильтрованы.
Stealth Accumulation - Фоновый сканер извлекает tokentx из Etherscan V2 по каждому отслеживаемому кошельку каждые 30 мин. Помечает кошелёк, получающий тот же ERC20 в ≥3 фрагментированных покупках на сумму ≥$500K в течение 24 ч — ловит тихое накопление раньше лент whale-оповещений.
On-Chain Whale Tracking - Крупные переводы ETH на/с бирж через Alchemy WebSocket, плюс консенсус лидерборда Hyperliquid от топовых трейдеров.
L/S Ratios - Данные позиционирования Bybit, Binance, Gate.io
S/R Levels - Поддержка/сопротивление в реальном времени из книги ордеров Hyperliquid
Macro Conditions - Ежедневный детерминированный макро-композит FRED и контекст высоко-влиятельного календаря; уклон по активу только когда доступен.
X (Twitter) API - Проверенные живые lane'ы через официальный X API v2: on-chain исследования (@lookonchain, @spotonchain, @arkham), официальные объявления бирж (@binance, @coinbase, @CoinbaseAssets, @upbit_global) и активный макро/новостной контекст (@DBdaily). Ушедшие или молчащие аккаунты исключены из ожиданий здоровья и публичных заявлений об источниках. Ретвиты и ответы отфильтрованы.

Веса источников

Источник	Вес	Обоснование
gov_news	1.3	Двигающие рынок регуляторные/политические события
smart_money	1.2	Отслеживание on-chain адресов (Alchemy + Etherscan, 408 кошельков)
stealth_accumulation	1.4	Фрагментированные тихие покупки (≥3 tx, ≥$500K, окно 24ч)
whale_eth	1.1	Крупные переводы ETH (Alchemy WS, ≥1000 ETH)
telegram:investigations	1.2	Высоко-сигнальная разведка хаков/эксплойтов
x:lookonchain	1.5	On-chain движения кошельков с хешами tx — опережающий индикатор
x:binance / x:coinbase	1.5	Официальные объявления о листингах бирж
x:spotonchain / x:arkham	1.4	On-chain аналитика, помеченные кошельки
x:CoinbaseAssets	1.4	Утечки дорожной карты листингов Coinbase
x:upbit_global	1.3	Листинги в Корее, катализатор kimchi premium
x:DBdaily	0.9	Отслеживание корпоративного принятия
binance_funding	1.0	Первичные данные биржи
liquidation	1.0	Данные ликвидаций с нескольких площадок
cmc_price	0.9	Ценовые оповещения CoinMarketCap
telegram:WatcherGuru	0.9	Быстрые срочные новости
rss:trumpstruth	0.9	Двигающий рынок, но шумный
rss:coindesk	0.8	Устоявшееся издание
cex_listing	0.8	Реальные листинги бирж (Binance/Bybit/Upbit/OKX)
rss:cointelegraph	0.7	Общие крипто-новости
rss:decrypt	0.7	Общие крипто-новости
market_open	0.6	Цены открытия сессий
macro_fearGreed	0.6	Индекс настроений
rss:reddit_crypto	0.5	сигнал сообщества r/CryptoCurrency
rss:reddit_btc	0.5	сигнал сообщества r/Bitcoin
dexscreener	0.2	Только обогащение
По умолчанию (не в списке)	0.5	-

GET /signals/similar

Только уровень Pro. Семантический поиск ближайших соседей по всем сигналам с использованием векторных эмбеддингов BGE-M3. Находите сигналы, связанные по смыслу — не только по совпадению ключевых слов.

Параметры запроса

Param	Тип	Описание
`coin`	string	Опционально — отфильтровать результаты по этому тикеру актива
`q`	string	Свободный текстовый запрос (по умолчанию имя монеты, если опущено)
`k`	int	Число результатов (по умолчанию 5, макс 20)

[
  {
    "id": 182,
    "similarity": 0.97,
    "summary": "BTC whale | bullish | high | Strategy loads 420 BTC at open",
    "metadata": {
      "asset": "BTC",
      "signal_type": "whale",
      "direction": "bullish",
      "urgency": "high",
      "score": 1.38,
      "timestamp": 1778551200
    }
  },
  {
    "id": 178,
    "similarity": 0.94,
    "summary": "BTC whale | bullish | medium | Institutional wallet accumulates 310 BTC",
    "metadata": {
      "asset": "BTC",
      "signal_type": "whale",
      "direction": "bullish",
      "urgency": "medium",
      "score": 1.1,
      "timestamp": 1778548800
    }
  }
]

GET /narrative/{coin}

Только уровень Pro. Непрерывный нарративный моментум для актива — сколько сигналов сработало, с какой скоростью, из скольких независимых источников и обнаружен ли паттерн координации.

{
  "coin": "BTC",
  "narrative_strength": 0.74,
  "narrative_velocity": 3.2,
  "narrative_decay_rate": 0.18,
  "manipulation_probability": 0.12,
  "dominant_direction": "bullish",
  "direction_conviction": 0.81,
  "source_diversity": 4,
  "signal_count_1h": 7,
  "signal_count_4h": 19,
  "signal_count_24h": 42,
  "disclaimer": "Analytical data only. Not financial advice."
}

Справочник полей

Поле	Тип	Описание
`narrative_strength`	float	взвешенный объём сигналов 0.0–1.0 за 24ч
`narrative_velocity`	float	Темп новых сигналов в час в окне 1ч
`narrative_decay_rate`	float	Как быстро падает объём сигналов (0 = растёт, 1 = холодно)
`manipulation_probability`	float	0.0–1.0. Повышается, если ≥3 независимых типа источника срабатывают в одном направлении за 5 мин
`dominant_direction`	string	bullish, bearish или neutral (голосование большинством по окну)
`direction_conviction`	float	Доля сигналов, совпадающих с доминирующим направлением
`source_diversity`	int	Число различных типов источников в окне 1ч
`signal_count_1h` / `4h` / `24h`	int	Сырое число сигналов на скользящее окно

GET /manipulation/{coin}

Только уровень Pro. Составная оценка манипуляции для актива. Объединяет подоценки социального всплеска, координированного пампа и каскада ликвидаций.

{
  "coin": "ETH",
  "manipulation_score": 0.34,
  "social_burst_score": 0.2,
  "coordinated_pump_score": 0.5,
  "liquidation_cascade_score": 0.1,
  "flags": [
    "coordinated_pump"
  ],
  "disclaimer": "Analytical data only. Not financial advice."
}

Справочник полей

Поле	Тип	Описание
`manipulation_score`	float	Составной: social_burst×0.30 + coordinated_pump×0.45 + liq_cascade×0.25
`social_burst_score`	float	Повышается, если число социальных сигналов ≥5× базовой линии за 10 мин
`coordinated_pump_score`	float	Повышается, если ≥4 разных префикса источника срабатывают в одном направлении за 10 мин
`liquidation_cascade_score`	float	Повышается, если ≥3 сигнала ликвидации по монете в течение 15 мин
`flags`	array	Активные флаги: social_burst, coordinated_pump, liquidation_cascade

GET /trust/{coin}

Только уровень Pro. Оценка доверия и скама для тикера токена. Разрешает тикер в адрес контракта через DexScreener, затем проверяет GoPlus Security на флаги контракта. Результаты кэшируются на 6 часов на адрес токена.

{
  "asset": "PEPE",
  "address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
  "chain_id": "1",
  "trust_score": 0.82,
  "rug_probability": 0.18,
  "contract_risk": 0.1,
  "insider_pct": 0.04,
  "is_honeypot": false,
  "is_mintable": false,
  "sell_tax": 0,
  "low_liquidity": false,
  "liquidity_usd": 4820000,
  "flags": [],
  "data_source": "goplus",
  "computed_at": 1778555605,
  "disclaimer": "Analytical data only. Not financial advice."
}

Справочник полей

Поле	Тип	Описание
`trust_score`	float	1.0 − rug_probability. Выше = безопаснее.
`rug_probability`	float	Составной: contract_risk×0.60 + liquidity_risk×0.20 + vol_liq_risk×0.10 + signal_history_risk×0.10
`contract_risk`	float	Выведено из GoPlus. Суммирует: honeypot (+0.50), mintable (+0.20), owner_can_change_balance (+0.25), upgradeable_proxy (+0.10), high_sell_tax, insider_pct
`insider_pct`	float	Совокупный процент токенов у создателя + владельца
`is_honeypot`	bool	Флаг honeypot от GoPlus — токен нельзя продать
`is_mintable`	bool	Контракт может выпускать неограниченное новое предложение
`sell_tax`	float	Налог на транзакцию продажи (0.10 = 10%)
`low_liquidity`	bool	true, если liquidity_usd < $50,000
`flags`	array	Активные флаги риска контракта от GoPlus
`data_source`	string	goplus, dexscreener, signal_history_only, or none

Ответы об ошибках

// 401 Unauthorized
{"detail": "Invalid API key"}

// 429 Rate Limited
{"detail": "Rate limit exceeded (60 req/min for free tier). Upgrade at https://n0brains.com"}

// 404 Not Found
{"detail": "Signal not found"}

// 403 Forbidden
{"detail": "WebSocket requires Pro tier"}