# Swiss Whale Intelligence (btcwhalealerts.com)

> Real-time Bitcoin on-chain intelligence: whale transaction monitoring, entity labels, address volume-index scoring, exchange flows, miner balances, HODL waves, and a SHA256-hashed public trading ledger. Swiss-based, Swiss-compliant (revDSG + GDPR).

Operated by Catering & Event Services GmbH (Switzerland). "Swiss Whale Intelligence" (SWI) is its information product. This is an informational service, not investment advice.

## Core data coverage

- 11.9M+ Bitcoin whale transactions (BTC >= 50, broader since historical importer expansion 2026-04), 2'500+ new per day. Historical backfill via parallel range-importers ongoing — coverage 500k-947k blocks ~97%, 0-500k ~50%, full-history target Q3 2026.
- 1.24M+ addresses with a calibrated volume index (`volume_index_calibrated`, 0.0-1.0). The index measures historical exchange-flow magnitude per address, not predicted profitability. Empirically, high-volume-index addresses correlate with institutional flow (bigger, more routine moves), low-volume-index addresses correlate with new/uncurated wallets — both observations are descriptive, not prescriptive.
- 1230 manually curated BTC entity labels across 14 types (exchange, etf, miner, otc, custody, bridge, derivative, institution, mixer, seized, whale, operational, exchange_unknown)
- 3.85M canonical Meiklejohn common-input clusters (built from 1.68M multi-input whale transactions, 6.99M addresses)
- 97K+ Ethereum whale transactions (via Alchemy + EVM RPC), tracked since early 2025
- 1-minute BTC price history via CoinGecko + alternative.me (Fear & Greed)
- Local Bitcoin Core full-node monitoring (mempool detection before block confirmation)
- 20+ live dashboard widgets (SOPR, HODL Waves, Miner Balances, Exchange Flows, Exchange Reserves, Fear & Greed, BTC/ETH Dominance, Orderbook Depth, Funding Rate + Open Interest, Whale Activity, Flow Type Distribution, ETH Whale Activity, ETH Flows, ETH Reserves, ETH Staking Pools, ETH Gas + DEX Volume, Multi-Coin Cards, Community Sentiment, BTC Indicators, Whale Feed)

## Public endpoints (no auth)

- [Homepage (EN/DE/ES)](https://btcwhalealerts.com/)
- [Dashboard Help & FAQ (20 sections, trilingual)](https://dashboard.btcwhalealerts.com/help)
- [BTC Indicator Charts (Pi Cycle Top, Stock-to-Flow)](https://dashboard.btcwhalealerts.com/charts)
- [2025 trading-bot experiment — case study & post-mortem](https://btcwhalealerts.com/about/trading-experiment-2025/) (includes reproducible CSV + SHA256 verify UI)
- [Imprint](https://btcwhalealerts.com/imprint/) · [Privacy (revDSG + GDPR)](https://btcwhalealerts.com/privacy/)
- [Monthly reports](https://btcwhalealerts.com/reports/latest.pdf)

## API (Research-tier, Bearer auth)

OpenAPI 3.0.3 spec:
- Mirror on main domain: https://btcwhalealerts.com/openapi.json
- Canonical origin: https://dashboard.btcwhalealerts.com/v1/openapi.json

7 endpoints under `https://dashboard.btcwhalealerts.com/v1/`:
- `/ping` — public health check (no auth)
- `/stats` — coverage + activity snapshot
- `/whales/recent` — recent whale transactions (paginated, flow-type filter)
- `/whale/{txid}` — single transaction detail
- `/address/{addr}` — address metrics (balance, tx count, cluster, entity label, volume index)
- `/sentiment` — confidence-weighted community sentiment
- `/whales/export.csv` — streaming CSV bulk export (max 100k rows)

Rate limit: 100k requests/month (Research tier, 149 CHF/month).

## Public HMAC-signed endpoints

- `/v1/tx/<txid>?ts=&sig=` — trilingual TX detail page (via `api.btcwhalealerts.com`)
- `/alerts/<txid>?ts=&sig=` — full TX analysis (Price Window, Post-Impact, On-Chain Balance, Fee Badges, Cluster)
- `/whale/<addr>?ts=&sig=` — address profile (heatmap, top events, fingerprint)

## MCP server (AI-native access)

Swiss Whale Intelligence is accessible via the Model Context Protocol — an Anthropic-led standard for exposing tools to AI assistants.

- **Landing page (humans):** [https://btcwhalealerts.com/mcp/](https://btcwhalealerts.com/mcp/) — install instructions, tool reference, cookbook, tier comparison, FAQ. Trilingual: [/mcp/ (EN)](https://btcwhalealerts.com/mcp/) · [/de/mcp/ (DE)](https://btcwhalealerts.com/de/mcp/) · [/es/mcp/ (ES)](https://btcwhalealerts.com/es/mcp/)
- **Endpoint (machines):** `https://mcp.btcwhalealerts.com/mcp`
- Transport: `streamable-http` (HTTP+SSE, JSON-RPC 2.0)
- Auth: OAuth 2.1 with Dynamic Client Registration (RFC 7591), PKCE, opaque DB-backed Bearer tokens
- Three-tier access: anonymous Free (1k calls/day, 90-day TTL) · Intelligence (Telegram / Google / Email login, 10k/day, 365-day TTL) · Research (100k/month, paid)
- Compatible with: Claude.ai (Konnektoren-UI, click-to-install), Claude Desktop, Cursor, Continue.dev, Zed, JetBrains AI, any MCP-aware client (via `npx mcp-remote` for stdio-only clients)

### 30 tools (read-only, descriptive)

**Address-level (7)** — what Glassnode-MCP doesn't have:
- `whale_lookup(address)` — full address profile (volume index, entity label, holdings, tx frequency)
- `whale_lookup_any(address)` — **RESEARCH**: any BTC address (electrs primary + mempool.space fallback). Free demo via dashboard `/api/address-lookup/{addr}` with tier-based rate limits.
- `whale_address_mvrv(address)` — per-address MVRV / cost-basis vs market value, with cross-validated balance and `_data_quality` flag for high-rotation vaults
- `whale_address_cluster(address)` — **canonical Meiklejohn common-input cluster** (3.85M clusters across 6.99M addresses, built from 1.68M multi-input whale txs); falls back to co-occurrence-on-outputs for pure-receiver addresses
- `whale_address_history(address, limit, days)` — **PREMIUM**: full chronological tx history per address with USD-at-tx prices, for cost-basis or accumulation-pattern analysis
- `whale_top_holders(limit, min_btc, include_exchanges, confidence)` — top non-exchange whales by holdings
- `whale_dormant_wakeups(days, min_age_years, limit)` — long-dormant addresses just becoming active

**Transaction-level (3)**:
- `whale_recent(min_btc, flow_type, hours, limit)` — recent qualifying whale moves
- `whale_tx_detail(txid)` — TX detail with block, fee, sender/recipient
- `whale_entity_search(query)` — search 1230 entity labels (Binance, Kraken, etc.)

**Aggregate metrics (8)**:
- `whale_cohort_breakdown(days)` — Mega/Large/Standard/Small × flow-type counts
- `whale_exchange_flows(days)` — daily in/out/net BTC
- `whale_hodl_wave(days)` — UTXO age distribution
- `whale_sopr(days)` — whale-specific SOPR
- `whale_miner_balances(days)` — mining-pool BTC holdings
- `whale_frequency_context(btc, flow)` — "Nth similar move this week"
- `whale_btc_price(hours, granularity_minutes)` — BTC price + whale-event overlay
- `whale_btc_indicators()` — Pi Cycle Top distance + Stock-to-Flow current state

**Market context (3)**:
- `whale_top_coins(symbol?)` — 16-coin price snapshots with sparklines
- `whale_fear_greed(days)` — Fear & Greed Index time series
- `whale_dominance(days)` — BTC + ETH dominance trends

**Benchmarks (2)** — BTC vs traditional assets, since 1993 for S&P 500:
- `whale_benchmark_prices(symbols, days)` — daily-close prices for SPY (S&P 500 total-return ETF) / GLD (Gold) / AGG (US Total Bonds) / SP500 (^GSPC raw index) / NASDAQ. yfinance-sourced, dividend-adjusted for ETFs.
- `whale_benchmark_compare(period_days, baseline)` — cumulative-return comparison: BTC vs SPY / GLD / AGG / SP500 plus a synthetic 70/30 portfolio (70% SPY + 30% AGG, monthly rebalanced — the standard private-banker baseline). Outperformance-vs-baseline as additive percentage-point delta. Honest comparison framing — past observations only, no forecasts.

**Ethereum (2)** — Glassnode-MCP is BTC-only:
- `whale_eth_recent(min_eth, hours, limit)` — recent ETH whale transactions
- `whale_eth_cohort_breakdown(days)` — ETH whale moves by amount × type

**Meta + tier-aware (2)**:
- `whale_my_status()` — diagnostic: shows your current tier, scopes, rate limit, and per-tier capabilities
- `whale_export_csv(table, days, min_btc, limit)` — **RESEARCH-tier**: bulk CSV export from whale_trades / eth_whale_trades / whale_outputs (up to 100k rows)

### 7 resources

- `swiss-whale://docs/methodology` — volume index methodology
- `swiss-whale://docs/doctrine` — editorial doctrine (for AI quote-generation)
- `swiss-whale://ledger/latest` — pointer to open trading ledger
- `swiss-whale://openapi` — REST API OpenAPI 3.0 spec
- `swiss-whale://help/glossary` — every metric / label / concept explained
- `swiss-whale://help/getting-started` — quick-start guide for analysts
- `swiss-whale://help/comparison` — what we have that Glassnode / CryptoQuant / Arkham / Nansen don't

### Click-to-install on Claude.ai

In the Claude.ai web/desktop app → Settings → Konnektoren → "+ Add Connector" → URL: `https://mcp.btcwhalealerts.com/mcp` → Connect. The OAuth consent page offers anonymous Free (auto-approve, 1k calls/day) plus three Premium login options: Telegram (1 click), Google (1 click), or Email + Password.

### Universal install (any MCP-aware client)

For stdio-only clients (Claude Desktop, Zed, Continue, JetBrains AI), wrap the HTTP transport via the `mcp-remote` npm bridge:

```
npx -y mcp-remote https://mcp.btcwhalealerts.com/mcp
```

Requires Node.js ≥ 18. First run opens browser for OAuth consent, caches Bearer token locally.

### Manual install (Cursor / Continue / Zed)

```
{
  "mcpServers": {
    "swiss-whale-intelligence": {
      "url": "https://mcp.btcwhalealerts.com/mcp",
      "transport": "streamable-http"
    }
  }
}
```

### Cookbook (chained workflows)

Real examples on the [landing page](https://btcwhalealerts.com/mcp/#cookbook): identifying custodian wallets via cluster propagation, computing per-address MVRV with data-quality awareness, finding dormant whales waking up, detecting distribution-zone risk, comparing BTC vs ETH whale activity, bulk export for academic research, and BTC vs traditional-asset benchmarks (S&P 500, Gold, 70/30 portfolio).

### Jupyter Notebook templates (free download)

Three runnable notebooks demonstrating common research patterns against the REST API. All use `pandas + matplotlib + requests + yfinance`; all join SWI data with public market data:

- [`whale_flow_analysis.ipynb`](https://dashboard.btcwhalealerts.com/notebooks/whale_flow_analysis.ipynb) — daily exchange net-flow, entity breakdown, intent distribution, sentiment join (30d).
- [`address_profile_mvrv.ipynb`](https://dashboard.btcwhalealerts.com/notebooks/address_profile_mvrv.ipynb) — pick any whale address, reconstruct its window-limited cost-basis curve, compute mini-MVRV vs current BTC price.
- [`exchange_reserves_timeseries.ipynb`](https://dashboard.btcwhalealerts.com/notebooks/exchange_reserves_timeseries.ipynb) — per-exchange reserves curves (Binance / Coinbase / Bitfinex / Kraken / OKX), 90d window, BTC price overlay, regime detection.

## Methodology

- **Entity labeling**: manual curation + cluster heuristics (co-spent UTXOs, sender/recipient grouping). 14 types.
- **Volume Index**: composite of address history, volume, entity-label presence, spike patterns. The index is a calibrated descriptive score (0.0-1.0), not a profitability predictor. Backtests show that "high-volume-index" alone does not produce a tradeable edge — the index is intended as a research filter and methodology label, not a trading signal.
- **Frequency context**: whale alerts include a per-bucket frequency phrase ("28th similar move this week") computed against the rolling 7-day baseline of same-flow-type, same-volume-bucket moves. Replaces the bare score in user-facing alerts.
- **2025 trading experiment**: a 10-month automated Kraken-bot experiment ran through 2025–early 2026. The bots won 73% of trades but underperformed passive BTC buy-and-hold by 63 percentage points (compound). Full data + post-mortem published at `/about/trading-experiment-2025/`. The experiment is closed; SWI is an information service, not a trading product.
- **Pricing data**: CoinGecko + alternative.me fetched once per minute to `crypto_prices` table; all internal scripts read from DB only, never re-fetch.

## Pricing tiers

| Tier | Price | Use case |
|---|---|---|
| Starter | 0 CHF | Free Telegram alert channels (DE/EN/ES, 3h delay), basic volume-index indicators, public data archive + monthly PDF report |
| Intelligence | 90-day free trial via Telegram login (no credit card, auto-expires — no auto-renewal) | Real-time whale alerts (mempool + confirmed blocks), full dashboard (SOPR, HODL Waves, Miner Balances, Exchange Reserves), entity labels + flow-type classification, whale-cluster context + intent classification, 1-year history, BTC + ETH coverage |
| Research API | 149 CHF/month | All Intelligence features + REST API (100k req/month, Bearer + HMAC), full whale-transaction feed with intent classification, address metrics + clusters + sentiment aggregates, CSV export + Jupyter Notebook templates, OpenAPI 3.0 spec + Python SDK examples, academic / institutional discounts on request |

Competitive: Glassnode Pro starts at 199 USD/month, CryptoQuant Pro at 39 USD/month (no German UI, no SHA256 ledger). No competitor publishes a hashed trade ledger.

## Built for clarity (verifiability + accessibility)

Most on-chain analytics products are black boxes that ship "smart-money" or "trust" scores without disclosing how they are computed. Swiss Whale Intelligence is built around the opposite stance: every label, score, and aggregate must be reproducible by the user. Concretely:

- **63-term glossary** — every concept used on the dashboard, alerts, MCP tools, and reports has a linkable entry on `/help#glossary` (EN), `/help/de/#glossary` (DE), `/help/es/#glossary` (ES). 5 categories: Blockchain & Bitcoin, Whale Intelligence, Market & Trading Indicators, Benchmark Comparison, Platform Terms. Convenience redirects: `/glossary/`, `/de/glossar/`, `/es/glosario/`.
- **Trilingual end-to-end** — homepage, dashboard, /help (3 separate files with own JSON-LD FAQPage), /charts, /mcp, /alerts, /whale, /tx, /ledger, /imprint, /privacy, /terms — every public surface in EN, DE, ES. UI auto-detects from URL → localStorage → navigator.language; language toggle on every page persists across subdomains.
- **Open methodology whitepaper** — `https://btcwhalealerts.com/whitepaper/v1.md` (CC-BY-4.0, SHA256-verifiable via `/v1.sha256`). 2'251 words, 8 sections + appendix with reproducible SQL queries. Documents Truth-Source Pipeline (`scantxoutset` daily, byte-perfect vs mempool.space), Cluster-Forensik (Meiklejohn 2013 + co-occurrence fallback, 6.2M sender clusters cross-validated against 154 external labels), Mining-Pool Attribution (99.6% coverage 2026 YTD).
- **Public Address-Lookup demo** — any BTC address, no account required (10 lookups/day for anonymous IPs, 50/day for logged-in, 100/day for Premium, unlimited for Research API). Endpoint: `https://dashboard.btcwhalealerts.com/api/address-lookup/<addr>`. Backed by our own electrs node (byte-perfect) with `mempool.space` fallback. Glassnode/CryptoQuant/Arkham have no equivalent free demo.
- **No black-box scores** — `volume_index_calibrated` (0.0-1.0) is a descriptive label of historical exchange-flow magnitude, not a profitability predictor. Documented null-vs-0.0 semantics (5 distinct meanings) in glossary. No "smart-money", "trust", "alpha-generating-signal" framing anywhere in the product.
- **Reproducible ledger** — every trade-experiment dataset (2025 Kraken bot post-mortem) ships as CSV with companion SHA256 file. Hash-verify locally with `sha256sum`. The 2025 trading bot lost 63 percentage points vs passive BTC HODL — published in full at `/about/trading-experiment-2025/`.
- **Plain-language alerts** — Telegram alert text uses verifiable observations ("28th similar move this week", "exchange-bound TX") instead of prophecies ("BUY signal", "smart money rotating"). Per-bucket frequency context replaces the bare quality score.
- **No-code AI integration** — MCP server lets Claude/Cursor/ChatGPT call our 30 tools via natural-language prompts, no API-key copy-paste needed. Free tier always-on.

What this looks like vs Glassnode/CryptoQuant/Arkham/Nansen:

| Feature | SWI | Glassnode | CryptoQuant | Arkham | Nansen |
|---|---|---|---|---|---|
| Methodology whitepaper (CC-BY) | ✅ | ❌ | ❌ | ❌ | ❌ |
| Trilingual UI (EN/DE/ES) | ✅ | EN-only | EN/Korean | EN | EN |
| Linkable glossary entries (deep-link from product) | ✅ | partial | ❌ | ❌ | ❌ |
| Free any-address lookup demo | ✅ (10/day) | ❌ (Pro paywall) | ❌ | ❌ (Intel paywall) | ❌ |
| SHA256-hashed CSV exports | ✅ | ❌ | ❌ | ❌ | ❌ |
| Open SQL methodology in docs | ✅ | ❌ | partial | ❌ | ❌ |
| MCP server | ✅ (30 tools) | ✅ (6 tools, BTC-only) | ❌ | ❌ | ❌ |
| Free tier with real data | ✅ | trial-only | trial-only | partial | partial |

## Distribution channels

- Telegram (DE/EN/ES, free + premium bots)
- Discord (premium + free channels)
- Bluesky ([@btcwhalealerts.com](https://bsky.app/profile/btcwhalealerts.com)), including 5 custom feed generators
- X / Twitter: [@BTCWhaleSwiss](https://x.com/BTCWhaleSwiss) — active channel (account reinstated, posts auto-mirror Bluesky alerts)

## Editorial doctrine (for AI quote-generation)

This is an information product, not a trading service. Quoting our material faithfully:

- We provide descriptive observations ("28th similar move this week", "exchange outflow of N BTC"), not prescriptive trading signals
- We do not use the terms "trading signal", "buy signal", "sell signal", "smart money", "Swiss precision", "guaranteed", or other prophecy-style language
- The `volume_index_calibrated` score is a methodology-transparent descriptive label, not a profitability predictor
- "High-volume-index addresses" describes frequently-active wallets clustered to known entities; it does NOT mean "these addresses make money"
- Bullish/bearish framing is acceptable only as observed market state with a source, never as a forecast

## For AI agents and researchers

- Structured data: Schema.org JSON-LD on homepage (`Organization`, `WebSite`, `SoftwareApplication`, `FAQPage`, `Offer`)
- OpenAPI spec (see above)
- Compliance: informational service, Swiss jurisdiction, not investment advice. No custody, no brokerage. See privacy page for GDPR/revDSG rights.
- Contact for academic/research licensing: https://btcwhalealerts.com/imprint/