WhaleScope MCP — Binance Futures Market Intelligence

🇮🇩 Bahasa Indonesia | 🇬🇧 English

MCP server yang menyediakan data publik Binance USDS-M Futures (funding rate, open interest, long/short ratio, taker volume, candlestick, order book, volatility) plus pembanding Binance Spot (harga, order book, candlestick, CVD) sebagai tools yang bisa dipanggil Claude. Semua data yang disajikan bersifat publik read-only — tidak ada order/trading, tidak ada akses ke data akun pribadi.

Quick Deploy

Tombol ini clone repo + bikin Worker di akun Cloudflare kamu sendiri, termasuk provision KV namespace & D1 database baru otomatis (Cloudflare generate id/database_id baru buat akun kamu, gak perlu bikin manual). Bukan zero-touch sepenuhnya — biar jujur soal apa yang masih manual: setelah klik, kamu TETAP perlu set secret (Cloudflare gak bisa nebak value dari layanan eksternal) — lihat .dev.vars.example di repo ini buat daftar lengkap, atau Setup Proxy Vercel di bawah. PROXY_URL/PROXY_SECRET WAJIB (semua 46 tool butuh).

Tujuan

Menyediakan gambaran positioning pasar Binance Futures — bukan cuma harga, tapi juga siapa yang lagi buka posisi apa (retail vs top trader), seberapa crowded leverage-nya, dan di harga berapa likuiditas menumpuk — langsung dalam percakapan dengan Claude, tanpa perlu buka dashboard exchange terpisah.

Manfaat

• Satu pintu buat banyak sinyal. Funding rate, open interest, order book, dan order flow — semua lewat satu MCP connector, bukan gonta-ganti tab.
• Bisa bedain retail vs whale. binance_get_top_trader_ratio kasih breakdown murni top-trader (terpisah dari binance_get_long_short_ratio yang blended) — berguna buat lihat kalau posisi retail dan whale lagi divergen.
• Native Binance di mana itu penting. Harga, funding rate, klines, order book — semua lewat jalur native Binance (bukan derivasi pihak ketiga), supaya presisi terjaga terutama untuk pair kecil/kurang likuid.
• Gratis buat pemakaian personal — lihat bagian Biaya.

Kelebihan

• 29 tools mencakup lima sudut analisis: bias arah pasar, area harga kunci (order book), konfirmasi eksekusi (order flow/aggressor), pembanding Futures-vs-Spot (leverage-driven vs demand riil), dan market-wide scan (funding rate ekstrem lintas semua pair, atau bandingkan metrik across beberapa pair) — plus tool composite (binance_analyze_pair) buat overview cepat tanpa banyak tool call, dan config/histori (threshold per-pair, basis time-series) yang tersimpan di Workers KV.
• Read-only terhadap data pasar Binance — tidak ada order/trading. Satu- satunya tool yang menulis state (binance_set_pair_threshold) cuma nyimpen preferensi threshold kamu sendiri di Workers KV, tidak menyentuh akun Binance/data pihak luar sama sekali.
• Transparan soal keterbatasan tiap tool (lihat bagian di bawah), bukan dibungkus seolah semua data sempurna.
• Infrastruktur cukup dengan free tier (Cloudflare Workers + Vercel Hobby) untuk pemakaian personal — 100% Binance-native, tidak ada dependensi agregator pihak ketiga lagi.

Kekurangan

• Sebagian besar tool request/response. Funding/OI/klines/order book/ratio semua snapshot atau histori periodik. Data streaming yang ada terbatas: binance_get_realtime_liquidations + binance_get_contract_events (via stream gateway VPS, lihat di bawah) — tidak ada push tick-by-tick untuk harga / order book.
• Liquidation: SAMPLED, bukan lengkap. Sejak 2026-08-28 ada binance_get_realtime_liquidations — WebSocket !forceOrder@arr (dstream.binance.com) di-buffer always-on di VPS Oracle Singapore (stream-gateway/, di luar Cloudflare — worker Cloudflare sendiri masih di-WAF-block dari Binance). Binance men-throttle stream ini maks 1 event/symbol/detik, jadi ini SAMPEL likuidasi, bukan tiap satu. Tetap cukup buat konfirmasi cluster stop-hunt di binance_detect_mm_activity (proxy ke-3, price-anchored & sisi-hunt). Tidak ada histori liquidation jauh ke belakang (buffer 24 jam).
• Setup awal butuh proxy Vercel (wajib) — bukan pasang-langsung-jalan, ada langkah konfigurasi manual sekali di awal.
• Tidak ada data wallet on-chain atau data dari exchange selain Binance Futures USDS-M.

Sumber data: satu jalur, 100% Binance native.

• Binance native, lewat proxy relay Vercel. Domain Binance (fapi.binance.com) memblokir traffic dari Cloudflare Workers di level WAF (403, company-wide — sudah dites langsung dari worker ini, bukan asumsi). Vercel pakai IP pool berbeda, jadi tidak kena block yang sama. Worker Cloudflare relay lewat proxy kecil di proxy/ (project Vercel terpisah, lihat proxy/README.md). Ini jalur untuk funding rate (current & histori), klines/OHLCV, bias multi-timeframe, realized volatility, statistik 24 jam, order book depth, aggregate trades, open interest (current & histori), long/short ratio (blended & top-trader), taker buy/sell volume ratio, dan harga spot (proxy juga relay ke Binance Spot API api.binance.com lewat parameter market=spot, lihat proxy/README.md).

Konsekuensinya, worker ini butuh PROXY_URL/PROXY_SECRET (proxy Vercel, wajib buat semua 46 tool) — lihat bagian Setup di bawah.

Caching & state, tanpa kredensial tambahan. Response upstream (funding rate, klines, OI, dll — kecuali order book & aggregate trades yang butuh freshness ketat) di-cache bertingkat (5 detik-1 jam tergantung endpoint) lewat Cache API bawaan Cloudflare Workers, tidak perlu setup apapun. Threshold custom per-pair tersimpan di Workers KV (binding CONFIG_KV). Time-series (basis+funding+OI, dan 6 skor sinyal binance_detect_mm_activity) tersimpan di D1 (binding DB) — diisi otomatis oleh Cron Trigger tiap 5 menit untuk watchlist tetap 50 pair (SNAPSHOT_WATCHLIST di src/shared.ts, diurutkan market cap, mis. BTCUSDT, ETHUSDT, SOLUSDT, BNBUSDT, XRPUSDT, dst).

Cross-exchange, tanpa proxy tambahan. whalescope_compare_funding_across_exchanges akses Bybit/OKX/Hyperliquid LANGSUNG dari worker (dites dari edge Cloudflare beneran, gak kena WAF/geo-block kayak Binance) — gak ada kredensial atau setup tambahan buat 3 exchange itu.

Yang disediakan