Smart Money API

Prinsip reka bentuk

Empat idea membentuk setiap titik akhir dan setiap skor yang dikembalikan oleh API ini. Ia juga merupakan batasan jujur tentang apa yang dijanjikan — dan tidak dijanjikan.

Strategi pertama, bukan isyarat pertama. Ini bukan suapan isyarat beli/jual. Anda membawa strategi dan kemasukan; API memberitahu anda sama ada struktur pasaran sekitarnya — penentuan posisi derivatif, pembiayaan, minat terbuka, pelupusan, aliran on-chain, dan konsensus ikan paus — bersetuju dengan dagangan yang anda sudah mahu lakukan.

Skor keyakinan, bukan ramalan binari. Setiap jawapan membawa gred confidence (TINGGI / SEDERHANA / RENDAH) dan composite dari -1.0 hingga +1.0. Tiada jaminan dan tiada panggilan oracle — anda mendapat bacaan terkawal tentang persetujuan, dengan alasan di sebaliknya, supaya anda boleh menyesuaikan saiz mengikut keyakinan.

Sokongan keputusan, bukan nasihat pelaksanaan. API mengembalikan cadangan CONFIRM / REDUCE / SKIP dan pengganda saiz untuk anda logik untuk bertindak. Ia tidak pernah meletakkan pesanan, dan tiada apa di sini adalah nasihat kewangan. Anda tetap bertanggungjawab untuk risiko, saiz, dan pelaksanaan.

Metrik hidup, bukan jaminan tetap. Kadar kemenangan, statistik rejim, dan angka ketepatan dikira dari sampel bergulir dan berubah mengikut pergerakan pasaran. Kami menerbitkannya dengan jujur, termasuk apabila ia sederhana. Anggap setiap metrik sebagai pemerhatian semasa, bukan janji tentang masa depan.

Untuk siapa API ini

API ini dibina untuk pembangun bot kripto, algo, dan ejen AI yang sudah mempunyai isyarat panjang/pendek — dari strategi TA, model ML, saluran Freqtrade, amaran TradingView, atau ejen LLM — dan mahukan keputusan CONFIRM / REDUCE / SKIP pantas sebelum melaburkan modal.

Gelung tipikal: strategi anda mencetuskan "beli panjang BTC" → anda memanggil GET /v1/confirm?symbol=BTC&direction=long → anda mengesahkan, mengurangkan, atau melangkau kemasukan dan menyesuaikan saiz mengikut size_mult. Satu panggilan, respons JSON berlatensi rendah tunggal, tiada infrastruktur tambahan.

Ia bukan penjana isyarat berdiri sendiri, produk carta, atau tempat pelaksanaan. Jika anda tidak mempunyai isyarat sendiri untuk dikawal, mulakan dengan halaman prestasi untuk melihat bagaimana skor berkelakuan sebelum menyambungkannya ke bot langsung.

Mendapatkan akses

1 — Daftar. Buat akaun percuma di signup (e-mel/kata laluan atau Google). Tiada kad kredit diperlukan untuk peringkat percuma.

2 — Buka papan pemuka anda. Anda papan pemuka menunjukkan kunci API anda, pelan semasa, dan penggunaan langsung berbanding kuota harian anda.

3 — Salin kunci API anda. Kunci diawali sm_. Luluskannya sebagai X-API-Key header pada setiap permintaan (lihat Pengesahan). Naik taraf bila-bila masa pada halaman harga untuk meningkatkan had dan membuka lebih banyak simbol dan endpoint.

Spesifikasi, SDK & Buku Resipi

Semua yang anda perlukan untuk integrasi pantas, sama ada anda menulis kod sendiri atau menyerahkannya kepada ejen pengekodan.

Panduan Pantas dalam 2 minit

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

Langkah 2 — Dapatkan kunci API anda. Daftar percuma (tiada kad kredit diperlukan) dan salin kunci anda dari papan pemuka. Gunakannya sebagai X-API-Key header pada setiap permintaan.

Langkah 3 — Panggilan pertama anda. Tampal ini ke terminal anda dan gantikan sm_your_key dengan kunci dari papan pemuka anda:

Respons yang dijangkakan:

Apabila confidence adalah HIGH atau MEDIUM dan action adalah CONFIRM, skala saiz posisi anda dengan size_mult. Itu keseluruhan gelung integrasi. Lihat Medan Respons untuk rujukan medan penuh.

Pengesahan

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

Kunci API anda boleh didapati dari papan pemuka selepas mendaftar. Rahsiakan kunci anda — jangan dedahkan dalam kod pelayan atau repositori awam.

Log Masuk Google (Firebase Auth)

Pengguna boleh mengesahkan menggunakan akaun Google melalui Firebase Authentication. Selepas log masuk Google berjaya pada klien, tukar token ID Firebase untuk sesi API yang dikaitkan. Sistem ini menyegerakkan identiti Google anda dengan sistem kunci API secara automatik.

Badan Permintaan

Contoh Respons

Had Kadar

Had kadar disertakan dalam setiap respons: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

URL Asas

Semua titik akhir di bawah adalah relatif kepada URL asas ini. Semua respons adalah dalam format JSON dengan Content-Type: application/json.

Ralat

Ralat menggunakan kod status HTTP standard dan badan JSON yang konsisten. Sentiasa cabut berdasarkan kod status, bukan pada teks respons. Tiga yang paling kerap anda temui:

Setiap ralat mengembalikan bentuk yang sama:

Untuk senarai lengkap kod status (400 / 403 / 500 / 503 dan lain-lain), lihat Kod Ralat. Integrasi yang kukuh menganggap 5xx dan 429 sebagai sementara (cuba semula dengan berundur) dan 401/402/403 sebagai terminal (betulkan kunci atau pelan).

Amalan keselamatan terbaik

Hantar kunci dalam header, bukan dalam URL. Sentiasa hantar X-API-Key sebagai header HTTP. Kunci dalam rentetan pertanyaan (?key=) dicatat oleh proksi, penyeimbang beban, dan sejarah penyemak imbas — autentikasi ?key= tidak lagi diterima pada titik akhir WebSocket atas sebab ini.

Simpan kunci di sebelah pelayan. Jangan sesekali menyematkan kunci API dalam JavaScript sebelah pelanggan, bundle aplikasi mudah alih, atau repositori awam. Muatkannya dari pemboleh ubah persekitaran atau pengurus rahsia. Jika kunci bocor, putarkannya.

Putar kunci secara berkala. Hasilkan semula kunci anda dari papan pemuka mengikut jadual dan serta-merta jika anda mengesyaki pendedahan. Kunci lama berhenti berfungsi sebaik sahaja kunci baru dikeluarkan.

Gunakan tiket untuk soket penyemak imbas. Untuk strim masa nyata dari penyemak imbas, tukar kunci anda dengan tiket sekali guna dan bukannya menyambung dengan kunci mentah — lihat Autentikasi WebSocket (tiket).

Menggunakan dengan ejen pengekodan / LLM

Membina dengan Claude Code, Codex, Cursor, atau ejen pengekodan LLM? Anda boleh memberikan ejen semua yang diperlukan untuk menyambung API ini dengan betul dalam satu langkah. Dua rujukan mesin boleh baca diterbitkan:

Arahkan ejen anda ke /llms.txt fail (konvensyen llms.txt) untuk gambaran ringkas, kemudian spesifikasi OpenAPI untuk bentuk permintaan/respons yang tepat. Petikan satu baris yang berfungsi dengan baik:

Lihat Buku Resipi untuk resipi ejen pengekodan yang telah diolah.

Titik Akhir

GET  /confirm

Titik akhir teras. Mengembalikan skor keyakinan komposit dan cadangan tindakan untuk arah dagangan tertentu. Panggil ini sebelum memasuki sebarang posisi.

Liputan, dalam istilah mudah. /confirm kini menilai BTC, ETH dan SOL — simbol dengan sejarah yang cukup untuk disahkan dengan jujur. Pemeriksa derivatif secara berasingan memantau ~519 pasaran derivatif untuk pembiayaan, data OI dan pelupusan, dan penjejakan ikan paus meliputi 600+ dompet. Pro membuka kunci pemeriksa penuh, eksport dan liputan pasaran yang lebih luas; /confirm sokongan simbol diperluas apabila setiap pasaran mengumpul rekod prestasi yang boleh dipercayai.

Parameter

Contoh Permintaan

Contoh Respons

Telus secara reka bentuk. Setiap respons membawa factors objek yang menunjukkan setiap bahagian skor × berat = sumbangan berwajaran sumbangan, satu adjustments objek untuk pelarasan pasca-tapis, yang weights digunakan, dan satu coverage peta. Bahagian on-chain menggunakan data percuma Coin Metrics sebenar (MVRV / aliran pertukaran / alamat aktif) apabila tiada kunci Glassnode ditetapkan. Ini adalah pertemuan pelbagai faktor skor — sokongan keputusan, bukan kadar kemenangan yang dijamin.

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

Medan Respons

GET  /snapshot

Mengembalikan snapshot pasaran penuh termasuk semua sub-skor, metrik mentah, dan nilai penunjuk untuk simbol tertentu. Berguna untuk papan pemuka dan log.

GET  /onchain

Mengembalikan metrik on-chain mentah: MVRV, SOPR, aliran bersih pertukaran, nisbah modal direalisasikan, dan klasifikasi kedudukan kitaran.

GET  /v1/derivatives/*

Penyaring derivatif silang pertukaran merentas 500+ simbol: peta haba kadar pembiayaan, kedudukan minat terbuka, dan pengesanan isyarat nisbah panjang/pendek. 10 baris teratas adalah awam; penyaring penuh memerlukan Pedagang atau Pro. Titik akhir: /v1/derivatives/screener, /v1/derivatives/funding, /v1/derivatives/oi, /v1/derivatives/signals.

GET  /v1/options/*

Analisis pilihan BTC & ETH bersumberkan Deribit (awam, tiada pengesahan): nisbah put/call, kesakitan maksimum, dan minat terbuka mengikut strike. Titik akhir: /v1/options/summary, /v1/options/pcr, /v1/options/oi.

GET  /v1/etf/*

Aliran bersih harian ETF BTC & ETH spot dan pecahan setiap dana (awam). Titik akhir: /v1/etf/flows, /v1/etf/funds.

GET  /v1/historical/*

Pembiayaan sejarah, minat terbuka, nisbah panjang/pendek (Binance), dan OHLCV (CoinGecko) untuk ujian balik. Titik akhir: /v1/historical/funding, /v1/historical/oi, /v1/historical/lsr, /v1/historical/ohlcv.

GET  /v1/dex/*

Pasangan trending berkuasa DexScreener, carian token, dan butiran pasangan (awam, tiada pengesahan). Titik akhir: /v1/dex/trending, /v1/dex/search, /v1/dex/token, /v1/dex/pair.

GET  /v1/news/*

Kecerdasan berita: berita dasar/geopolitik/krypto diklasifikasikan ke dalam kategori impak, ditambah Ketakutan & Ketamakan (awam, tiada pengesahan). Titik akhir: /v1/news/trump, /v1/news/general, /v1/news/impact, /v1/news/fear-greed.

GET  /whales

Mengembalikan data konsensus dompet paus: pecahan panjang/pendek, pendedahan notional total, 10 kedudukan teratas (Pro sahaja), dan kiraan dompet.

GET  /signals

Mengembalikan aliran isyarat HIGH/MEDIUM terkini merentas semua aset yang dipantau. Berguna untuk pengimbasan peluang.

GET  /v1/strategies/*

Rekod prestasi telus, baca sahaja untuk strategi perdagangan automatik yang dilaksanakan berdasarkan isyarat Smart Money — termasuk deriv40 Strategi SmartMoney Copytrade (account=9). Semua titik akhir mengambil parameter ?account=<id> dan mengembalikan JSON. Tiada pengesahan diperlukan (rekod prestasi awam).

Titik akhir

• 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 — lengkung ekuiti untuk carta: { initial_equity, curve: [{ time, equity }] }.
• GET /v1/strategies/trades?account=9&limit=500 — lejar perdagangan tertutup: tatasusunan (atau {trades:[…]}) bagi symbol, direction, entry_price, exit_price, pnl_usdt, pnl_percent, pnl_percent_net.
• GET /v1/strategies/active?account=9 — kedudukan terbuka semasa: tatasusunan (atau {positions:[…]}) bagi symbol, side/direction, entry_price, unrealized_pnl.
• GET /v1/strategies/signals — pecahan jenis isyarat yang memberi makan strategi (kiraan / kemenangan / kadar_kemenangan / purata_pnl setiap jenis isyarat).

Prestasi lalu tidak menunjukkan hasil masa depan. Angka diisi balik lebih satu rejim ~3 bulan ditambah perdagangan langsung dan ditunjukkan pra-fi seperti yang dinyatakan.

GET  /export

Muat turun data isyarat sejarah sebagai CSV untuk ujian balik. Parameter: symbol, from (unix ts), to (unix ts).

GET  /health

Semakan kesihatan sistem. Mengembalikan kesegaran data untuk setiap sumber dan status API keseluruhan. Tiada pengesahan diperlukan.

GET  /usage

Mengembalikan statistik penggunaan API semasa anda: panggilan hari ini, jumlah bulanan, had kuota, dan masa tetapan semula.

POST  /webhooks

Daftarkan URL HTTPS untuk menerima tolakan acara bertanda masa nyata apabila isyarat dicetuskan merentas aset yang dipantau. Penghantaran membawa X-SmartMoney-Event header dan tanda tangan HMAC-SHA256 dalam X-SmartMoney-Signature, dan cuba semula sehingga 3× dengan backoff.

Badan Permintaan

Mengesahkan tandatangan

Kunci HMAC ialah heks digest SHA-256 rahsia berdaftar anda. Kira HMAC-SHA256 badan permintaan mentah dengan kunci itu dan bandingkan (masa tetap) terhadap X-SmartMoney-SignatureLihat Panduan Pelaksanaan Webhook.

Kecerdasan

GET  /analysis

Mengembalikan klasifikasi rejim pasaran berkuasa AI dengan pengesanan konflik isyarat. Menganalisis persetujuan silang isyarat, mengenal pasti perbezaan antara derivatif, on-chain, dan data paus, dan menghasilkan ringkasan bahasa semula jadi dengan faktor risiko yang memandang ke hadapan dan cadangan berasaskan jangka masa.

Parameter

Contoh Respons

GET  /liquidations

Mengembalikan dua pandangan pelengkap: (1) leverage-projected levels — anggaran di mana kelompok pelupusan berada; dan (2) a realized_heatmap — REAL dilaksanakan intensiti pelupusan paksa (harga × masa), dikumpulkan secara langsung dari feed WebSocket pertukaran awam: Binance, OKX, Bybit, Bitget, BitMEX. Heatmap hadir apabila aliran mempunyai data untuk simbol (tiada dalam pasaran yang sangat tenang atau selepas permulaan).

Parameter

Contoh Respons

GET  /liquidations/heatmap

Awam heatmap pelarasan tahap harga. Mengembalikan matriks harga × masa gaya Coinglass bagi PELAKSANAAN SEBENAR pelarasan paksa, dikumpulkan mengikut harga di mana setiap pelarasan dicetak — dikumpulkan secara langsung dari suapan WebSocket pertukaran awam: Binance, OKX, Bybit, Bitget, BitMEX. Array clusters adalah output praktikal: baldi harga disusun mengikut notional yang dilaraskan, setiap satu ditanda dengan sisi dominannya. Data bergantung pada strim langsung — simbol yang sangat senyap atau pintu masuk yang baru dimulakan mengembalikan struktur kosong yang terbentuk dengan baik ditambah dengan note. Tahap yang ditunjukkan hanyalah pelarasan sebenar, tidak pernah dianggarkan.

Parameter

Contoh Respons

GET  /liquidations/onchain

Dilaksanakan likuidasi pinjaman DeFi on-chain ditangkap terus dari nod penuh BSC + Avalanche kami — bebas daripada sebarang bot dagangan. Meliputi Venus/Cream dan Moolah di BSC, dan AAVE V3/V2, Benqi, BankerJoe, Granary dan Vinium di Avalanche. Tahap Pro tambahan mengembalikan at_risk posisi (bergantung pada bot, mungkin tiada).

Parameter

Contoh Respons

GET  /smart-stop

Mengira tahap henti-rugi pintar berdasarkan peta haba pelupusan semasa, jalur turun naik, dan struktur pasaran. Mengembalikan cadangan henti berperingkat dan cadangan ambil-untung yang dikalibrasi kepada harga kemasukan dan toleransi risiko anda.

Parameter

Contoh Respons

GET  /funding-arb

Mengenal pasti peluang arbitraj kadar pembiayaan antara pertukaran secara masa nyata. Mengembalikan peluang berperingkat dengan anggaran hasil tahunan, pasangan pertukaran optimum, dan tindakan lindung nilai yang diperlukan untuk menangkap spread.

Parameter

Contoh Respons

Varian awam percuma Tiada pengesahan

Titik akhir awam tanpa kunci mengembalikan 10 peluang teratas dengan penyaring antara pertukaran langsung, sesuai untuk disematkan atau semakan pantas. Ia menggugurkan sejarah spread per-simbol dan medan berat dan dihidangkan dari cache 120-saat. Apabila tiada spread pembiayaan antara pertukaran wujud dalam tetingkap kesegaran, ia mengembalikan opportunities array dengan note — tiada data palsu.

GET  /smart-money/flow

Indeks arah berat kualiti indeks arah paus per simbol, dinilai -100 (wang paus condong pendek) kepada +100 (condong panjang). Dibina daripada ribuan dompet paus Hyperliquid yang dikesan — setiap satu diberi berat berdasarkan kadar kemenangan sejarah dan PnL serta dikurangkan oleh kebaruan. Ini adalah indeks kedudukan, bukan isyarat beli/jual atau ramalan harga. Simbol dengan sedikit dompet penyumbang dilabel thin dan dinilai dengan jujur. Laman langsung: smart-money-flow.html.

Parameter

Contoh Respons

GET  /v1/whales/crowding

Gabungan konteks kedudukan & kesesakan paus per simbol, digabungkan merentasi Hyperliquid + GMX v2 + Jupiter Perps. Mengembalikan notional kasar/bersih, kecenderungan arah, kiraan dompet & venue, kepekatan kedudukan (bahagian top-3 + HHI), purata leveraj berwajaran, dan baldi kedekatan pelupusan (notional USD yang berada dalam 5% dan 10% daripada harga pelupusan yang dianggarkan, dibahagi panjang/pendek). Ini adalah konteks, bukan isyarat arah. Medan yang tidak boleh diperoleh adalah null dan dipaparkan sebagai — — cth. lev_wavg/crowding_index apabila tiada kedudukan membawa leveraj. Jarak pelupusan adalah anggaran margin terpencil (pct_to_liq ≈ 1/lev + upnl/notional − mmr, mmr = 0.01), bukan harga pelupusan yang dilaporkan oleh pertukaran.

Parameter

Contoh Permintaan

Contoh Respons

GET  /v1/options/gex

Dealer pendedahan gamma (GEX) analitik untuk BTC & ETH, dikira secara langsung daripada rantaian pilihan awam Deribit (tiada pengesahan). Mengembalikan GEX peniaga bersih setiap strike (konvensyen peniaga-pendek SpotGamma), tahap flip gamma (strike di mana GEX bersih kumulatif melintasi sifar), struktur jangka IV (vol tersirat ATM mengikut hari-hingga-tamat), dan kecondongan IV hadapan-tamat (proksi 25Δ risiko terbalik). Rejim GEX adalah positive (peniaga panjang gamma → penekan vol) atau negative (penguat vol). Lengkap berdikari — dikira semula pada setiap panggilan, tiada kebergantungan pada pangkalan data tersimpan.

Parameter

Contoh Permintaan

Contoh Respons

GET  /v1/liquidations/simulate

Interaktif ujian tekanan lata pelikuidanDiberikan pergerakan harga hipotesis, mengembalikan anggaran posisi berleveraj yang akan dilikuidasi, volum paksaan mengikut tahap harga/sisi/bursa, dan bacaan kedalaman lata. Pergerakan ke bawah melikuidasi long yang harga liq-nya berada pada/atas sasaran; pergerakan ke atas melikuidasi short yang harga liq-nya berada pada/bawahnya. Dua kaedah bebas digabungkan: harga pelikuidan tepat dari ikan paus Hyperliquid yang dijejaki nyata leveraj/kemasukan, ditambah kelompok jalur OI statistik setiap bursa (leveraj ramai disimpulkan dari pembiayaan). Semua dilabel dengan jelas estimated: true — ia tidak dapat mengetahui margin setiap akaun, cross vs isolated, margin tambahan, atau ADL.

Parameter

Contoh Permintaan

Contoh Respons

GET  "/v1/wallet/{addr}/profile"

Profil dompet merentas venue dibina sepenuhnya dari snapshot posisi paus yang dijejaki secara langsung. Untuk paus Hyperliquid yang dijejaki, mengembalikan posisi terbuka semasa, siri masa PnL tidak direalisasikan / pendedahan / kiraan posisi siri masa, garis masa aktiviti BUKA/TUTUP/FLIP (dibina semula dengan membezakan snapshot berturut-turut), label papan pemimpin HL yang dinyahkod, dan ringkasan buku terbuka. Halaman langsung: "wallet-profiler.html".

Parameter

Contoh Permintaan

Contoh Respons

GET  /flows

Mengembalikan data aliran modal merentas aset yang menunjukkan corak putaran antara BTC, ETH, dan SOL merentas pelbagai window masa. Berguna untuk mengenal pasti aset mana yang mengumpul modal dan yang sedang diagihkan pada setiap masa.

Contoh Respons

GET  /whale-events

Mengembalikan perubahan posisi paus yang signifikan — pembukaan, penutupan, dan flip arah — dikesan merentas dompet dan alamat on-chain yang dikesan dalam window look-back yang ditentukan.

Parameter

Contoh Respons

GET  /regimes/history

Mengembalikan data klasifikasi rejim sejarah untuk aset tertentu. Gunakan ini untuk menguji prestasi jenis rejim tertentu secara sejarah, berapa lama setiap jenis rejim biasanya bertahan, dan bagaimana peralihan rejim berlaku dari masa ke masa.

Parameter

Contoh Respons