Smart Money API

Prinsip desain

Empat ide membentuk setiap endpoint dan setiap skor yang dikembalikan API ini. Mereka juga merupakan batasan jujur dari apa yang dijanjikan — dan tidak dijanjikan.

Strategi-pertama, bukan sinyal-pertama. Ini bukan umpan sinyal beli/jual. Anda membawa strategi dan entri; API memberi tahu apakah struktur pasar sekitar — posisi derivatif, pendanaan, open interest, likuidasi, aliran on-chain, dan konsensus paus — setuju dengan trade yang sudah ingin Anda lakukan.

Skor kepercayaan, bukan prediksi biner. Setiap jawaban membawa nilai bertingkat confidence (TINGGI / SEDANG / RENDAH) dan composite dari -1.0 hingga +1.0. Tidak ada jaminan dan tidak ada panggilan oracle — Anda mendapatkan pembacaan terkalibrasi tentang kesepakatan, dengan alasan di baliknya, sehingga Anda dapat menyesuaikan ukuran proporsional dengan keyakinan.

Dukungan keputusan, bukan nasihat eksekusi. API mengembalikan rekomendasi KONFIRMASI / KURANGI / LEWATI dan pengali ukuran untuk Anda logika untuk bertindak. Ini tidak pernah menempatkan pesanan, dan tidak ada di sini yang merupakan nasihat keuangan. Anda tetap bertanggung jawab atas risiko, ukuran, dan eksekusi.

Metrik hidup, bukan jaminan tetap. Tingkat kemenangan, statistik rezim, dan angka akurasi dihitung dari sampel bergulir dan bergerak saat pasar bergerak. Kami mempublikasikannya dengan jujur, termasuk saat mereka biasa-biasa saja. Perlakukan setiap metrik sebagai observasi saat ini, bukan janji tentang masa depan.

Untuk siapa API ini

API ini dibangun untuk pengembang bot, algo, dan agen-AI kripto yang sudah memiliki sinyal long/short — dari strategi TA, model ML, pipa Freqtrade, alert TradingView, atau agen LLM — dan ingin keputusan KONFIRMASI / KURANGI / LEWATI cepat sebelum mengalokasikan modal.

Loop khas: strategi Anda memicu "long BTC" → Anda memanggil GET /v1/confirm?symbol=BTC&direction=long → Anda mengonfirmasi, mengurangi, atau melewatkan entri dan menyesuaikan ukuran dengan size_mult. Satu panggilan, respons JSON latensi rendah tunggal, tidak ada infrastruktur tambahan.

Ini bukan generator sinyal mandiri, produk charting, atau tempat eksekusi. Jika Anda tidak memiliki sinyal sendiri untuk digate, mulailah dengan halaman kinerja untuk melihat bagaimana skor berperilaku sebelum menghubungkannya ke bot live.

Mendapatkan akses

1 — Daftar. Buat akun gratis di signup (email/kata sandi atau Google). Tidak perlu kartu kredit untuk tier gratis.

2 — Buka dashboard Anda. Anda dashboard menunjukkan kunci API, paket saat ini, dan penggunaan live terhadap kuota harian Anda.

3 — Salin kunci API Anda. Kunci diawali sm_. Sertakan sebagai X-API-Key header pada setiap permintaan (lihat Autentikasi). Tingkatkan kapan saja di halaman harga untuk meningkatkan batasan dan membuka lebih banyak simbol dan endpoint.

Spesifikasi, SDK & Buku Resep

Semua yang Anda butuhkan untuk mengintegrasikan dengan cepat, baik Anda menulis kode sendiri atau menyerahkannya ke agen coding.

Mulai cepat dalam 2 menit

Langkah 1 — URL Dasar. Setiap endpoint berada di bawah:

Langkah 2 — Dapatkan kunci API Anda. Daftar gratis (tanpa kartu kredit diperlukan) dan salin kunci Anda dari dashboard. Gunakan sebagai X-API-Key header pada setiap permintaan.

Langkah 3 — Panggilan pertama Anda. Tempelkan ini ke terminal Anda dan ganti sm_your_key dengan kunci dari dashboard Anda:

Respons yang diharapkan:

Ketika confidence adalah HIGH atau MEDIUM dan action adalah CONFIRM, skalakan ukuran posisi Anda dengan size_mult. Itulah seluruh lingkaran integrasi. Lihat Kolom Respons untuk referensi lengkap kolom.

Autentikasi

Semua permintaan memerlukan kunci API yang diberikan sebagai X-API-Key header HTTP.

Kunci API Anda tersedia dari dashboard setelah mendaftar. Jaga kerahasiaan kunci Anda — jangan tampilkan di kode klien atau repositori publik.

Masuk dengan Google (Firebase Auth)

Pengguna dapat mengautentikasi menggunakan akun Google mereka melalui Firebase Authentication. Setelah berhasil masuk dengan Google di klien, tukarkan token ID Firebase untuk sesi API yang terhubung. Sistem secara otomatis menyinkronkan identitas Google Anda dengan sistem kunci API.

Badan Permintaan

Contoh Respons

Batas Laju

Header batas kecepatan disertakan dalam setiap respons: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

URL Dasar

Semua endpoint di bawah ini relatif terhadap URL dasar ini. Semua respons adalah JSON dengan Content-Type: application/json.

Kesalahan

Kesalahan menggunakan kode status HTTP standar dan badan JSON yang konsisten. Selalu cabangkan berdasarkan kode status, bukan teks respons. Tiga yang paling sering Anda temui:

Setiap kesalahan mengembalikan bentuk yang sama:

Untuk daftar lengkap kode status (400 / 403 / 500 / 503 dan lainnya), lihat Kode Kesalahan. Integrasi yang kuat memperlakukan 5xx dan 429 sebagai sementara (coba lagi dengan backoff) dan 401/402/403 sebagai terminal (perbaiki kunci atau paket).

Praktik keamanan terbaik

Kirim kunci dalam header, bukan URL. Selalu kirim X-API-Key sebagai header HTTP. Kunci dalam string kueri (?key=) dicatat oleh proxy, load balancer, dan riwayat browser — autentikasi ?key= legacy tidak lagi diterima di endpoint WebSocket karena alasan ini.

Simpan kunci di sisi server. Jangan pernah menyematkan kunci API di JavaScript sisi klien, bundel aplikasi seluler, atau repositori publik. Muat dari variabel lingkungan atau manajer rahasia. Jika kunci bocor, putar.

Putar kunci secara berkala. Buat ulang kunci Anda dari dashboard sesuai jadwal dan segera jika Anda curiga ada paparan. Kunci lama berhenti bekerja saat kunci baru diterbitkan.

Gunakan tiket untuk soket browser. Untuk aliran real-time dari browser, tukar kunci Anda dengan tiket sekali pakai alih-alih terhubung dengan kunci mentah — lihat Autentikasi WebSocket (tiket).

Penggunaan dengan agen pengkodean / LLM

Membangun dengan Claude Code, Codex, Cursor, atau agen pengkodean LLM? Anda dapat memberikan semua yang diperlukan agen untuk menyambungkan API ini dengan benar sekaligus. Dua referensi yang dapat dibaca mesin diterbitkan:

Arahkan agen Anda ke /llms.txt file (konvensi llms.txt) untuk ikhtisar singkat, lalu spesifikasi OpenAPI untuk bentuk permintaan/respons yang tepat. Satu baris perintah yang berfungsi baik:

Lihat Buku Resep untuk resep agen pengkodean yang sudah dikerjakan.

Endpoint

GET  /confirm

Endpoint inti. Mengembalikan skor kepercayaan komposit dan rekomendasi aksi untuk arah perdagangan tertentu. Panggil ini sebelum memasuki posisi apa pun.

Cakupan, dalam istilah sederhana. /confirm saat ini mencakup BTC, ETH dan SOL — simbol dengan riwayat yang cukup untuk dikonfirmasi dengan jujur. Pemeriksa derivatif secara terpisah memantau ~519 pasar derivatif untuk data pendanaan, OI, dan likuidasi, dan pelacakan paus mencakup 600+ dompet. Pro membuka kunci pemeriksa penuh, ekspor, dan cakupan pasar yang lebih luas; /confirm dukungan simbol diperluas saat setiap pasar mengumpulkan rekam jejak yang andal.

Parameter

Contoh Permintaan

Contoh Respons

Transparan oleh desain. Setiap respons membawa factors objek yang menunjukkan skor × bobot = terbobot kontribusi, sebuah adjustments objek untuk penyesuaian pasca-filter, weights yang digunakan, dan sebuah coverage peta. Kaki on-chain menggunakan data Coin Metrics gratis nyata (MVRV / aliran-pertukaran / alamat-aktif) saat tidak ada kunci Glassnode yang ditetapkan. Ini adalah pertemuan multi-faktor skor — dukungan keputusan, bukan jaminan tingkat kemenangan.

Simbol yang tidak dilacak adalah jujur. Simbol di luar alam semesta derivatif/paus yang dilacak mengembalikan "confidence":"NO_DATA" / "action":"NO_DATA_SKIP" dengan "unsupported":true — bukanlah hasil yang dibuat-buat LOW.

Kolom Respons

GET  /snapshot

Mengembalikan snapshot pasar lengkap termasuk semua sub-skor, metrik mentah, dan nilai indikator untuk simbol tertentu. Berguna untuk dasbor dan pencatatan.

GET  /onchain

Mengembalikan metrik on-chain mentah: MVRV, SOPR, aliran bersih exchange, rasio realized cap, dan klasifikasi posisi siklus.

GET  /v1/derivatives/*

Screener derivatif lintas exchange untuk 500+ simbol: heatmap funding-rate, peringkat open-interest, dan deteksi sinyal long/short-ratio. 10 baris teratas bersifat publik; screener lengkap memerlukan Trader atau Pro. Endpoint: /v1/derivatives/screener, /v1/derivatives/funding, /v1/derivatives/oi, /v1/derivatives/signals.

GET  /v1/options/*

Analitik opsi BTC & ETH sumber Deribit (publik, tanpa autentikasi): rasio put/call, max pain, dan open interest per strike. Endpoint: /v1/options/summary, /v1/options/pcr, /v1/options/oi.

GET  /v1/etf/*

Aliran bersih harian ETF BTC & ETH spot dan rincian per-dana (publik). Endpoint: /v1/etf/flows, /v1/etf/funds.

GET  /v1/historical/*

Data historis funding, open interest, long/short ratio (Binance), dan OHLCV (CoinGecko) untuk backtesting. Endpoint: /v1/historical/funding, /v1/historical/oi, /v1/historical/lsr, /v1/historical/ohlcv.

GET  /v1/dex/*

Pasangan trending berbasis DexScreener, pencarian token, dan detail pasangan (publik, tanpa autentikasi). Endpoint: /v1/dex/trending, /v1/dex/search, /v1/dex/token, /v1/dex/pair.

GET  /v1/news/*

Intelijen berita: berita kebijakan/geopolitik/kripto yang diklasifikasikan ke dalam kategori dampak, plus Fear & Greed (publik, tanpa autentikasi). Endpoint: /v1/news/trump, /v1/news/general, /v1/news/impact, /v1/news/fear-greed.

GET  /whales

Mengembalikan data konsensus dompet paus: pembagian long/short, total eksposur notional, 10 posisi teratas (hanya Pro), dan jumlah dompet.

GET  /signals

Mengembalikan aliran sinyal HIGH/MEDIUM terbaru di semua aset yang dipantau. Berguna untuk pemindaian peluang.

GET  /v1/strategies/*

Rekam jejak transparan dan hanya-baca untuk strategi trading otomatis yang dieksekusi berdasarkan sinyal Smart Money — termasuk deriv40 Strategi SmartMoney Copytrade (account=9). Semua endpoint menerima parameter ?account=<id> query dan mengembalikan JSON. Tidak diperlukan autentikasi (rekam jejak publik).

Endpoint

• GET /v1/strategies/stats?account=9 — metrik utama: total_trades, win_rate, profit_factor, total_pnl_usdt, account_growth_percent, initial_equity, current_equity, max_drawdown_portfolio, max_drawdown_trade.
• GET /v1/strategies/equity?account=9 — kurva ekuitas untuk charting: { initial_equity, curve: [{ time, equity }] }.
• GET /v1/strategies/trades?account=9&limit=500 — ledger trade tertutup: array (atau {trades:[…]}) dari symbol, direction, entry_price, exit_price, pnl_usdt, pnl_percent, pnl_percent_net.
• GET /v1/strategies/active?account=9 — posisi yang saat ini terbuka: array (atau {positions:[…]}) dari symbol, side/direction, entry_price, unrealized_pnl.
• GET /v1/strategies/signals — rincian tipe sinyal yang memberi makan strategi (jumlah / menang / win_rate / avg_pnl per tipe sinyal).

Kinerja masa lalu tidak menjamin hasil di masa depan. Angka di-backfill selama satu rezim ~3 bulan plus trade live dan ditampilkan sebelum biaya jika dicatat.

GET  /export

Unduh data sinyal historis sebagai CSV untuk backtesting. Parameter: symbol, from (unix ts), to (unix ts).

GET  /health

Pemeriksaan kesehatan sistem. Mengembalikan kesegaran data untuk setiap sumber dan status API secara keseluruhan. Tidak diperlukan autentikasi.

GET  /usage

Mengembalikan statistik penggunaan API Anda saat ini: panggilan hari ini, total bulanan, batas kuota, dan waktu reset.

POST  /webhooks

Daftarkan URL HTTPS untuk menerima push event bertanda real-time saat sinyal terpicu di aset yang Anda pantau. Pengiriman membawa header X-SmartMoney-Event dan tanda tangan HMAC-SHA256 di X-SmartMoney-Signature, dan akan diulang hingga 3× dengan backoff.

Bodi Permintaan

Memverifikasi tanda tangan

Kunci HMAC adalah hex digest SHA-256 dari secret yang terdaftar. Hitung HMAC-SHA256 dari bodi permintaan mentah dengan kunci tersebut dan bandingkan (constant-time) dengan X-SmartMoney-Signature. Lihat Panduan Implementasi Webhook.

Kecerdasan

GET  /analysis

Mengembalikan klasifikasi rezim pasar berbasis AI dengan deteksi konflik sinyal. Menganalisis kesepakatan lintas-sinyal, mengidentifikasi divergensi antara data derivatif, on-chain, dan data paus, serta menghasilkan ringkasan bahasa alami dengan faktor risiko ke depan dan rekomendasi berorientasi waktu.

Parameter

Contoh Respons

GET  /liquidations

Mengembalikan dua pandangan komplementer: (1) proyeksi leverage levels — perkiraan di mana kluster likuidasi berada; dan (2) sebuah realized_heatmap — REAL dieksekusi intensitas likuidasi paksa (harga × waktu), diagregasi langsung dari feed WebSocket bursa publik: Binance, OKX, Bybit, Bitget, BitMEX. Heatmap hadir ketika aliran memiliki data untuk simbol (tidak ada di pasar yang sangat tenang atau baru saja dimulai).

Parameter

Contoh Respons

GET  /liquidations/heatmap

Publik heatmap likuidasi tingkat harga. Mengembalikan matriks harga × waktu gaya Coinglass dari REAL dieksekusi likuidasi paksa, dikelompokkan berdasarkan harga di mana setiap likuidasi tercatat — diagregasi langsung dari feed WebSocket bursa publik: Binance, OKX, Bybit, Bitget, BitMEX. Array clusters adalah output praktis: kelompok harga yang diurutkan berdasarkan notional yang dilikuidasi, masing-masing diberi tag dengan sisi dominannya. Data tergantung pada aliran langsung — simbol yang sangat sepi atau gateway yang baru dimulai mengembalikan struktur kosong yang terbentuk dengan baik ditambah note. Level yang ditampilkan hanya likuidasi nyata, tidak pernah perkiraan.

Parameter

Contoh Respons

GET  /liquidations/onchain

Dieksekusi likuidasi pinjaman DeFi on-chain ditangkap langsung dari node lokal kami sendiri BSC + Avalanche full nodes — independen dari bot trading apa pun. Mencakup Venus/Cream dan Moolah di BSC, serta AAVE V3/V2, Benqi, BankerJoe, Granary, dan Vinium di Avalanche. Tingkat Pro juga mengembalikan at_risk posisi (tergantung bot, mungkin tidak ada).

Parameter

Contoh Respons

GET  /smart-stop

Menghitung level stop-loss cerdas berdasarkan heatmap likuidasi saat ini, pita volatilitas, dan struktur pasar. Memberikan rekomendasi stop bertingkat dan saran take-profit yang disesuaikan dengan harga masuk dan toleransi risiko Anda.

Parameter

Contoh Respons

GET  /funding-arb

Mengidentifikasi peluang arbitrase tingkat funding lintas bursa secara real-time. Mengembalikan peluang yang diurutkan dengan perkiraan hasil tahunan, pasangan bursa optimal, dan tindakan lindung nilai yang diperlukan untuk menangkap spread.

Parameter

Contoh Respons

Varian publik gratis Tanpa auth

Endpoint publik tanpa kunci mengembalikan 10 peluang teratas dengan screener lintas bursa langsung, ideal untuk embedding atau pengecekan cepat. Tidak termasuk riwayat spread per simbol dan field berat, serta disajikan dari cache 120 detik. Ketika tidak ada spread funding lintas bursa dalam jangka waktu kesegaran, mengembalikan opportunities array kosong dengan note — tidak pernah data palsu.

"GET"  "/smart-money/flow"

"Indeks arah terimbang kualitas" "indeks arah paus" "per simbol, dinilai" -100 "(uang paus cenderung short) hingga" +100 "(cenderung long). Dibangun dari ribuan dompet paus Hyperliquid yang dilacak — masing-masing diberi bobot berdasarkan tingkat kemenangan historis dan PnL serta diperbarui berdasarkan kebaruan. Ini adalah" "indeks posisi, bukan sinyal beli/jual atau prediksi harga." "Simbol dengan sedikit dompet kontributor diberi label" thin "dan dinilai dengan jujur. Halaman live:" "smart-money-flow.html".

"Parameter"

"Contoh Respons"

"GET"  "/v1/whales/crowding"

"Gabungan" "konteks posisi & kepadatan paus" "per simbol, digabungkan dari" "Hyperliquid + GMX v2 + Jupiter Perps"". Mengembalikan notional kotor/bersih, skew arah, jumlah dompet & venue, konsentrasi posisi (bagian top-3 + HHI), leverage rata-rata tertimbang, dan" "ember kedekatan likuidasi" "(notional $ yang berada dalam 5% dan 10% dari perkiraan harga likuidasinya, dibagi long/short). Ini adalah" "konteks, bukan sinyal arah." "Bidang yang tidak dapat diturunkan adalah" null "dan dirender sebagai" — "— misalnya" lev_wavg/crowding_index "ketika tidak ada posisi yang memiliki leverage. Jarak likuidasi adalah perkiraan margin terisolasi ("pct_to_liq ≈ 1/lev + upnl/notional − mmr, mmr = 0.01), "bukan" "harga likuidasi yang dilaporkan bursa."

"Parameter"

"Contoh Permintaan"

"Contoh Respons"

GET  /v1/options/gex

Dealer gamma exposure (GEX) analitik untuk BTC & ETH, dihitung secara real-time dari rantai opsi publik Deribit (tanpa auth). Mengembalikan GEX dealer bersih per strike (konvensi dealer-short SpotGamma), level gamma-flip (strike di mana GEX bersih kumulatif melewati nol), struktur jangka IV (volatilitas tersirat ATM berdasarkan hari-jatuh-tempo), dan skew IV front-expiry (proxy 25Δ risk reversal). Rezim GEX adalah positive (dealer long gamma → menekan volatilitas) atau negative (menguatkan volatilitas). Mandiri penuh — dihitung ulang setiap panggilan, tidak bergantung pada DB yang disimpan.

Parameter

Contoh Permintaan

Contoh Respons

GET  /v1/liquidations/simulate

Interaktif uji stres kaskade likuidasi. Dengan asumsi pergerakan harga hipotetis, mengembalikan estimasi posisi leverage yang akan dilikuidasi, volume paksa berdasarkan level harga / sisi / bursa, dan pembacaan kedalaman kaskade. Pergerakan ke bawah melikuidasi long yang harga likuidasinya berada di/atas target; pergerakan ke atas melikuidasi short yang harga likuidasinya berada di/bawahnya. Dua metode independen digabungkan: harga likuidasi tepat dari paus Hyperliquid yang dilacak nyata leverage/masuk, ditambah klaster band OI statistik per bursa (leverage kerumunan disimpulkan dari pendanaan). Semuanya diberi label jelas estimated: true — tidak dapat mengetahui margin per-akun, cross vs isolated, margin tambahan, atau ADL.

Parameter

Contoh Permintaan

Contoh Respons

GET  /v1/wallet/{addr}/profile

Profil lintas tempat profil dompet dibangun sepenuhnya dari snapshot posisi paus yang dilacak langsung. Untuk paus Hyperliquid yang dilacak, mengembalikan posisi terbuka saat ini, deret waktu PnL tidak terealisasi / eksposur / jumlah posisi deret waktu, garis waktu aktivitas garis waktu aktivitas (direkonstruksi dengan membandingkan snapshot berturut-turut), label papan peringkat HL yang diterjemahkan, dan ringkasan buku terbuka. Halaman langsung: wallet-profiler.html.

Parameter

Contoh Permintaan

Contoh Respons

GET  /flows

Mengembalikan data aliran modal lintas aset yang menunjukkan pola rotasi antara BTC, ETH, dan SOL di berbagai jendela waktu. Berguna untuk mengidentifikasi aset mana yang mengakumulasi modal dan yang didistribusikan pada momen tertentu.

Contoh Respons

GET  /whale-events

Mengembalikan perubahan posisi paus signifikan — pembukaan, penutupan, dan pembalikan arah — yang terdeteksi di dompet dan alamat on-chain yang dilacak dalam jendela look-back yang ditentukan.

Parameter

Contoh Respons

GET  /regimes/history

Mengembalikan data klasifikasi rezim historis untuk aset tertentu. Gunakan ini untuk menguji kembali bagaimana jenis rezim tertentu telah berkinerja secara historis, berapa lama setiap jenis rezim biasanya bertahan, dan bagaimana transisi rezim berkembang dari waktu ke waktu.

Parameter

Contoh Respons