API Reference

GET /signals

Returns active signals, optionally filtered. Free tier receives signals with a 15-minute delay.

Query Parameters

Response - Free Tier

{
  "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 Tier Adds

Each signal object includes these additional fields:

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

Signal Fields

Historical Edge & Paired Inverse

Every signal carries a historical_edge object describing the closed-paper-trade outcomes of past signals in the same (signal_type × direction × regime_at_signal) cell. Stats are refreshed weekly. The fields are descriptive — they do not gate, size, or recommend.

When a cell is empirically anti-predictive (n ≥ 30 closed trades, win rate ≤ 30%, average PnL ≤ -2%), the signal also carries a paired_inverse object. It surfaces the contrarian-direction reading of the same event alongside a citation to peer-reviewed short-term reversal literature (De Bondt & Thaler 1985, Tetlock 2007, Chan 2003, PLOS One 2024). It is presented as data, not a recommendation: the flipped_cell_stats field shows how the opposite-direction cell has actually performed historically, which is often weaker than the implied_avg_pnl_pct would suggest in pure-inversion terms.

Use these fields to interpret signal quality in context. A signal with a strong historical_edge (high win_rate, large avg_pnl_pct, large sample_n) is more reliable than the same signal in a cell where the edge is weak or inverted. The cell stats and any paired-inverse advisory are intended for your own analysis — they are not trade recommendations, and we do not suggest position sizes or leverage.

GET /levels/{coin}

Returns nearest support/resistance from the Hyperliquid order book — as zones (each level carries its price band), with polarity-flip tracking (a broken support is surfaced as resistance, and vice versa).

{
  "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

Opening prices for BTC, ETH, and SOL at each major trading session.

{
  "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

Macro Pulse — our daily directional bias for BTC and ETH. Generated at 07:00 UTC daily (with a deeper 30-day review every Sunday 22:00 UTC). A deterministic macro composite — net liquidity (Fed balance sheet − TGA − RRP), the dollar index, real yields, the 2s10s curve, M2 and VIX, all from FRED — anchors the regime call. That composite is synthesised with the upcoming USD high-impact macro calendar (FOMC, CPI, NFP, PPI, Retail Sales) and the last 7 days of intel signals into a single regime call plus per-asset bias, conviction, key levels, and invalidation. The /macro response carries the raw composite + drivers alongside the narrative read.

Free tier: latest report only, generated_at + regime + bias/conviction. Pro tier: full payload including reasoning, key levels, invalidation, and calendar_risks. Add ?history=N (Pro, max 30) to include the last N snapshots alongside the current report.

{
  "generated_at": "2026-05-13T07:00:00+00:00",
  "window_days": 7,
  "horizon": "week",
  "regime": "risk-off",
  "regime_reason": "Hotter-than-expected CPI/PPI driving inflation fears and heavy long de-leveraging.",
  "btc": {
    "bias": "bearish",
    "conviction": 0.85,
    "reason": "Macro bearishness triggered by PPI surge and heavy long liquidations.",
    "key_levels": "$80,000 (psychological), $76,500 (structural)",
    "invalidation": "Retail Sales print materially below forecast, sparking risk-on rotation."
  },
  "eth": {
    "bias": "bearish",
    "conviction": 0.9,
    "reason": "Extreme long squeeze risk; 97% long liquidations on key venues.",
    "key_levels": "$3,200 (immediate support), $2,850 (major pivot)",
    "invalidation": "Unexpected dovish turn from new Fed chair."
  },
  "calendar_risks": [
    "Core Retail Sales m/m (2026-05-14) — potential further downside if hot",
    "Fed Chair Nomination Vote (2026-05-13) — policy uncertainty"
  ]
}

Field Reference

Auth Endpoints

POST /auth/register

Create a new account. Returns an API key immediately.

{
  "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 tier only. Connect to receive signals in real-time.

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 tier only. Register a URL to receive POST deliveries for new signals.

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

Delivery Format

POST to your URL with header 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"
  }
}

Data Sources and Scoring

The pipeline ingests from the watchers listed below. Each source carries a weight that multiplies into the final signal score — so what you read isn't a raw feed dump, it's one corroborated, ranked number.

score = source_weight × urgency_weight × confidence_decayed

Urgency weights: low: 1.0, medium: 2.0, high: 3.0

Confidence decay: confidence degrades exponentially with age. confidence_decayed = confidence₀ × exp(−age / τ) where τ = half-life / ln(2) per signal type (liquidation: ~43min, hack/sentiment/listing: ~2.9h, whale/price/funding: ~8.7h, regulatory: ~5.8h, macro: ~11.5h, macro_pulse: ~34.6h). A stale signal has a lower score than a fresh one of identical quality.

Source weight self-tuning: weights are EMA-adjusted daily from tracked outcome win rates. Sources that fire correctly get boosted up to 1.4×; sources that underperform are dampened to 0.6×. Minimum 10 outcomes before adjustment.

Active Watchers

1. Telegram - WatcherGuru, ZachXBT Investigations, yoyodexhaber, sondakikav
2. News RSS - 15 feeds (Reuters, AP, BBC, CNBC, Bloomberg, CoinDesk, CoinTelegraph, Decrypt, Google News, etc.)
3. Government RSS - 11 feeds (White House, SEC, CFTC, Fed, Kremlin, Xinhua, TASS, EU, etc.)
4. CoinMarketCap - Price alerts, trending coins
5. Macro - Fear and Greed Index, DeFi TVL
6. Binance - Funding rates, liquidation cascades (WebSocket)
7. Market Opens - BTC/ETH/SOL prices at Tokyo, Shanghai, Hong Kong, London, NY session opens
8. Exchange Listings - Real CEX listing catalysts: Binance & Bybit launchpad/launchpool, plus new spot-market detection (symbol-list diff) on Binance, Upbit (Korea / kimchi premium), and OKX. Pump.fun / Raydium memecoin launches were dropped — they were ~98% of the old listing feed with no tradeable edge.
9. ETF Flows - US spot BTC + ETH + SOL ETF daily net flows via SoSoValue (free public API). Emitted as context (macro_flow, non-directional): a backtest found ETF net inflow does not predict forward returns — it is a coincident/lagging demand print (SOL inflows were contrarian).
10. Stablecoin Flows - USDT/USDC Treasury deploy/redeem + net inflow staged to exchange wallets, plus total stablecoin supply trend (DeFiLlama). A leading liquidity read (stablecoin inflow to exchanges leads short-horizon BTC/ETH returns in our data); aggregate supply is dry-powder context.
11. On-Chain Valuation - Coin Metrics (free): MVRV, exchange in/outflows + reserves, active addresses (BTC + ETH). Net exchange OUTFLOW / falling reserves = self-custody accumulation; MVRV maps cycle profit/froth. Feeds the Macro Pulse composite's on-chain leg; emitted as context.
12. Token Unlocks - DeFiLlama emissions calendar (free). Material near-term unlocks (insider/investor cliffs) on tradeable tokens = scheduled supply that sellers front-run → unlock signal, bearish. Self-proves via the forward-return gate.
13. TradFi & CME - Yahoo Finance (free): CME BTC/ETH futures gap (weekend gaps tend to fill — a recurring level read) plus SPX/gold cross-asset correlation context.
14. Smart Money - Alchemy ETH WebSocket (alchemy_pendingTransactions) on 408 curated wallets + Etherscan V2 confirmed-tx fallback. 700+ verified labeled addresses (CEX hot/cold, market maker, institutional, smart trader) auto-refreshed weekly from Etherscan label cloud + Alchemy top-volume sweep. MEV bots filtered.
15. Stealth Accumulation - Background scanner pulls Etherscan V2 tokentx per tracked wallet every 30 min. Flags wallet receiving same ERC20 in ≥3 fragmented buys totaling ≥$500K within 24 h — catches quiet accumulation before whale-alert feeds.
16. On-Chain Whale Tracking - Large ETH transfers to/from exchanges via Alchemy WebSocket (threshold 1000 ETH); large BTC transfers via mempool.space WebSocket on tracked cold wallets (threshold 100 BTC). Hyperliquid leaderboard consensus from top traders. SOL CEX flow via Alchemy Solana accountSubscribe on 12 hot/cold wallets (threshold 10000 SOL).
17. L/S Ratios - Bybit, Binance, Gate.io positioning data
18. S/R Levels - Real-time support/resistance from Hyperliquid order book
19. Macro Pulse - Daily BTC + ETH directional bias. Deterministic FRED macro composite (net liquidity, DXY, real yields, curve, VIX, M2) anchors the regime, synthesised with the USD high-impact calendar (FOMC, CPI, NFP, PPI) and 7d intel signals. Sunday weekly 30d deep-dive.
20. X (Twitter) API - Curated 11-account feed via official X API v2. Onchain primary (@lookonchain, @spotonchain, @arkham, @whale_alert), official exchange announcements (@binance, @coinbase, @CoinbaseAssets, @upbit_global), and newswire-speed macro (@DeItaone, @FirstSquawk, @DBdaily). 20s polling, retweets and replies filtered.

Source Weights

GET /signals/similar

Pro tier only. Semantic nearest-neighbor search across all signals using BGE-M3 vector embeddings. Find signals related by meaning — not just matching keywords.

Query Parameters

[
  {
    "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 tier only. Rolling narrative momentum for an asset — how many signals have fired, at what velocity, from how many independent sources, and whether a coordination pattern is detected.

{
  "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."
}

Field Reference

GET /manipulation/{coin}

Pro tier only. Composite manipulation score for an asset. Combines social burst, coordinated pump, and liquidation cascade sub-scores.

{
  "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."
}

Field Reference

GET /trust/{coin}

Pro tier only. Trust and scam scoring for a token ticker. Resolves the ticker to a contract address via DexScreener, then checks GoPlus Security for contract flags. Results are cached 6 hours per token address.

{
  "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."
}

Field Reference

Error Responses

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