Smart Money API
Egy profi szintű intelligencia API, amely a derivatív adatokat, on-chain metrikákat és bárca tárcatevékenységet egyetlen megbízhatósági pontszámmá összesíti a kereskedési botod számára.
https://api.smartmoneyapi.com/v1Tervezési elvek
Négy ötlet alakítja minden végpontot és minden pontszámot, amit ez az API visszaad. Ezek egyben az őszinte határai annak, mit ígér – és mit nem.
Stratégia első, nem jel első. Ez nem egy vétel/eladás jel feed. Te hozod a stratégiát és a belépést; az API megmondja, hogy a környező piaci struktúra – derivatív pozicionálás, finanszírozás, nyitott kamat, likvidációk, on-chain áramlás és bálnák konszenzusa – egyetért-e a már meglevő kereskedési szándékoddal.
Megbízhatósági pontozás, nem bináris előrejelzés. Minden válasz tartalmaz egy fokozatú confidence (HIGH / MEDIUM / LOW) és egy composite -1.0-től +1.0-ig terjedő értéket. Nincsenek garanciák és oracle hívások – egy kalibrált értékelést kapsz az egyetértésről, az okokkal együtt, hogy arányosan méretezhess a meggyőződésedhez.
Döntéstámogatás, nem végrehajtási tanács. Az API egy CONFIRM / REDUCE / SKIP ajánlást és egy méret-szorzót ad vissza, hogy a te logikád cselekedhessen. Soha nem helyez el rendeléseket, és semmi sem pénzügyi tanács. Te maradsz felelős a kockázatért, méretezésért és végrehajtásért.
Élő metrikák, nem fix garanciák. A nyerési arányok, rezsim statisztikák és pontossági adatok egy mozgó mintából számítottak és változnak a piacok mozgásával. Őszintén közzétesszük őket, akkor is, ha középszerűek. Kezeld minden metrikát jelenlegi megfigyelésként, nem jövőbeli ígéretként.
Kinek szól ez az API
Ez az API krypto bot, algo és AI-ügynök fejlesztőknek készült, akik már rendelkeznek egy long/short jellel – egy TA stratégiából, egy ML modellből, egy Freqtrade folyamatból, egy TradingView riasztásból vagy egy LLM ügynökből – és egy gyors, kereskedés előtti CONFIRM / REDUCE / SKIP döntést szeretnének kapni tőke elköltése előtt.
Tipikus ciklus: a stratégiád jelez „menj long BTC-be” → meghívod a GET /v1/confirm?symbol=BTC&direction=long → megerősíted, csökkented vagy kihagyod a belépést és méretezed a méretet size_multszerint. Egy hívás, egyetlen alacsony késleltetésű JSON válasz, nincs extra infrastruktúra.
Ez nem önálló jelgenerátor, charting termék vagy végrehajtási hely. Ha nincs saját jeled, amit ellenőriznél, kezdd a teljesítmény oldallal , hogy lásd, hogyan viselkedett a pontszám, mielőtt élő botba építenéd.
Hozzáférés kérése
1 — Regisztrálj. Hozz létre egy ingyenes fiókot a signup oldalon (email/jelszó vagy Google). Nem szükséges bankkártya az ingyenes szinthez.
2 — Nyisd meg az irányítópultod. Az irányítópultod megmutatja az API kulcsodat, jelenlegi csomagodat és élő felhasználásodat a napi kvótádhoz képest.
3 — Másold az API kulcsodat. A kulcsok előtagja sm_. Add át a X-API-Key fejlécben minden kérésnél (lásd Hitelesítés). Bármikor frissíthetsz az díjszabás oldal a korlátok növeléséhez és további szimbólumok és végpontok feloldásához.
Specifikáció, SDK & Konyha
Minden, amire szükséged van a gyors integrációhoz, akár magad írod a kódot, akár egy kódoló ügynökre bízod.
| Erőforrás | Mi ez |
|---|---|
| Konyha | Másolható-beilleszthető receptek a leggyakoribb integrációkhoz — megerősítés belépés előtt, Freqtrade jelző átjáró, méret szorzóval, 402/429 kezelése, és bekötése egy kódoló ügynökbe. |
| OpenAPI specifikáció | Géppel olvasható OpenAPI definíció minden végponthoz. Importálás Postman/Insomnia-ba, kliens generálás, vagy LLM-be táplálás. Itt: github.com/tashiardit/smartmoneyapi-docs. |
| Python kliens | Hivatalos Python kliens könyvtár itt: github.com/tashiardit/smartmoneyapi-python. |
| /llms.txt | Egy LLM-barát egyszerű szöveges összefoglaló az API-ról. Mutasd Claude-nak, Codex-nak vagy Cursor-nak (lásd Kódoló Ügynökök). |
Gyorsindítás 2 perc alatt
1. lépés — Alap URL. Minden végpont itt található:
2. lépés — Szerezd meg az API kulcsod. Regisztrálj ingyen (nincs szükség bankkártyára) és másold a kulcsod a vezérlőpultról. Add meg minden kérésnél a X-API-Key fejlécben.
3. lépés — Az első hívásod. Másold be ezt a terminálba és cseréld ki sm_your_key a vezérlőpultról kapott kulcsra:
Várt válasz:
"ts": 1710940821,
"symbol": "BTC",
"direction": "long",
"composite": 0.74,
"confidence": "HIGH",
"action": "CONFIRM",
"size_mult": 1.5,
"deriv_score": 0.81,
"onchain_score": 0.68,
"whale_score": 0.73,
"reasons": ["Funding rate pozitív minden platformon", "Bálnák: 67%-os long konszenzus"]
}
Amikor confidence a HIGH vagy MEDIUM és action a CONFIRM, méretezd a pozíció méretét a size_multEz az egész integrációs ciklus. Lásd Válaszmezők a teljes mezőreferenciaért.
Hitelesítés
Minden kéréshez szükség van egy API kulcsra, amelyet X-API-Key HTTP fejlécben kell átadni.
Az API kulcsod elérhető a irányítópulton a regisztráció után. Tartsd titokban a kulcsodat — ne tedd közzé kliensoldali kódban vagy nyilvános tárolókban.
/v1/ws/ticket a X-API-Key fejléccel, majd kapcsolódj a visszaadott jeggyel. Lásd WebSocket hitelesítés (jegyek).Google Bejelentkezés (Firebase Auth)
A felhasználók hitelesíthetik magukat Google-fiókkal Firebase Authentication segítségével. A sikeres Google bejelentkezés után a kliensoldalon cseréld le a Firebase ID tokent egy kapcsolt API munkamenetre. A rendszer automatikusan szinkronizálja a Google identitásodat az API kulcsrendszerrel.
Kérés Törzse
| Mező | Típus | Leírás |
|---|---|---|
| id_tokenkötelező | string | Firebase ID token, amely a kliensoldali Google bejelentkezés után érhető el |
Példa Válasz
"api_key": "sm_your_linked_key",
"uid": "firebase_uid_abc123",
"email": "[email protected]",
"plan": "trader",
"synced": true
}
Korlátok
| Csomag | Hívások/Nap | Burst Korlát | Adatkésleltetés |
|---|---|---|---|
| Ingyenes | 50 | 2/perc | 60 másodperc |
| Trader | 1,000 | 20/perc | Valós időben |
| Pro | 5,000 | 60/perc | Valós idejű |
| Vállalati | 100,000 | 400/perc | Valós idejű |
A válaszokban mindig szerepelnek a sávszélesség-korlát fejlécek: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
Alap URL
Az alábbi végpontok mind ehhez az alap URL-hez viszonyítva értendők. Minden válasz JSON formátumban érkezik Content-Type: application/json.
Hibák
A hibák szabványos HTTP státuszkódokat és egységes JSON törzset használnak. Mindig a státuszkód alapján dönts, ne a válasz szövege alapján. A leggyakoribb három:
| Státusz | Kód | Jelentés és teendők |
|---|---|---|
| 401 | unauthorized | Hiányzó vagy érvénytelen API kulcs. Ellenőrizd, hogy a X-API-Key fejléc helyes és jelen van. |
| 402 | payment_required | A végpont vagy szimbólum magasabb csomagot igényel, mint amit a kulcsod tartalmaz (pl. ingyenes kulccsal hívod a WebSocket firehose-t). Frissíts vagy visszaléphetsz egy nyilvános végpontra. |
| 429 | rate_limit_exceeded | A napi vagy burst korlátot elérted. Várj és próbáld újra X-RateLimit-Resetután; ne bombázd a szervert. |
Minden hiba ugyanazt a formátumot adja vissza:
"error": "rate_limit_exceeded",
"message": "A napi 100 hívás limit elérve. 00:00 UTC-kor frissül.",
"status": 429
}
A teljes státuszkód listaért (400 / 403 / 500 / 503 és mások) lásd Hibakódok. A robosztus integráció a 5xx és 429 kódokat átmenetinek kezeli (újrapróbálkozás backoff-fal), míg a 401/402/403 kódokat véglegesnek (javítsd a kulcsot vagy csomagot).
Biztonsági ajánlott eljárások
A kulcsot mindig fejlécben küldd, soha az URL-ben. Mindig add át X-API-Key HTTP fejlécben. A query stringben lévő kulcsok (?key=) proxyk, load balancerek és böngésző előzmények által naplózódnak — az örökölt ?key= auth már nem elfogadott WebSocket végpontokon pont emiatt.
Tartsd a kulcsokat szerver oldalon. Soha ne ágyazz be API kulcsot kliens oldali JavaScriptbe, mobil alkalmazás csomagba vagy nyilvános tárolóba. Töltsd be környezeti változóból vagy titkosító kezelőből. Ha egy kulcs kiszivárog, cseréld le.
Forgasd a kulcsokat időszakosan. Generáld újra a kulcsod a dashboardról időzítve vagy azonnal, ha gyanítod, hogy kiszivárgott. A régi kulcs a pillanatban megszűnik működni, amint az új kiadásra kerül.
Használj jegyet böngészős socketekhez. Valós idejű streamekhez böngészőből cseréld be a kulcsod egy egyszer használatos jegyre, ahelyett, hogy nyers kulccsal csatlakoznál — lásd WebSocket hitelesítés (jegyek).
Használat kódoló ügynökökkel / LLM-ekkel
Claude Code, Codex, Cursor vagy bármely LLM kódoló ügynökkel építesz? Egy lépésben átadhatod mindazt, amire az ügynöknek szüksége van az API helyes bekötéséhez. Két géppel olvasható referencia érhető el:
| Erőforrás | URL |
|---|---|
| LLM összefoglaló | https://smartmoneyapi.com/llms.txt |
| OpenAPI specifikáció | github.com/tashiardit/smartmoneyapi-docs |
Mutasd az ügynöködnek a /llms.txt fájlt (a llms.txt konvenció) a tömör áttekintésért, majd az OpenAPI specifikációt a pontos kérés/válasz formákért. Egy jól működő egysoros prompt:
Olvasd el a https://smartmoneyapi.com/llms.txt-t és az OpenAPI specifikációt itt:
github.com/tashiardit/smartmoneyapi-docs, majd adj hozzá egy előzetes kereskedési
ellenőrzést a botomhoz, ami meghívja a GET /v1/confirm-t és kihagyja a bejegyzéseket,
hacsak a művelet nem CONFIRM.
Lásd a Receptkönyv egy kidolgozott kódoló-ügynök receptért.
Végpontok
GET /confirm
A fő végpont. Összetett bizalmi pontszámot és művelet ajánlást ad vissza egy adott kereskedési irányhoz. Hívd meg bármely pozícióba lépés előtt.
Lefedettség, egyszerűen. /confirm jelenleg pontozza a BTC, ETH és SOL szimbólumokat — ezek rendelkeznek elég feloldott előzménnyel a becsületes megerősítéshez. A derivatív szűrő külön ~519 derivatív piacot figyel finanszírozás, nyitott kamat és likvidációs adatokért, és a bálna követés 600+ pénztárcát fed le. A Pro feloldja a teljes szűrőt, exportálást és szélesebb piaci lefedettséget; /confirm a szimbólum támogatás bővül, ahogy minden piac megbízható nyomon követhető előzményt halmoz fel.
Paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| szimbólumkötelező | string | Eszköz szimbólum. Az egyik: BTC, ETH, SOL (Trader+) |
| iránykötelező | string | Kereskedési irány: long vagy short |
| forrásopcionális | string | Címke a jelződ forrásához (analitikához naplózva). Max 32 karakter. |
Példa kérés
"https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"
Példa válasz
"ts": 1710940821,
"symbol": "BTC",
"direction": "long",
"composite": 0.74,
"confidence": "MAGAS",
"action": "TELJES_MEGEROSITES",
"size_mult": 1.5,
deriv_score: 0.81,
onchain_score: 0.68,
whale_score: 0.73,
x_score: 0.0,
tényezők: {
derivatívák: { pontszám: 0.81, súly: 0.40, súlyozott: 0.324 },
onchain: { pontszám: 0.68, súly: 0.35, súlyozott: 0.238, forrás: coinmetrics, elérhető: True },
whale: { pontszám: 0.73, súly: 0.25, elavulási_tényező: 1.0, súlyozott: 0.183 }
},
kiigazítások: { egyezés: 0.0, irányzat: 0.0, hírek_makro: 0.0 },
súlyok: { derivatívák: 0.40, onchain: 0.35, whale_intel: 0.25 },
lefedettség: { derivatívák: True, whale: True, onchain: True },
indokok: [
A finanszírozási ráta minden platformon pozitív,
LSR a hosszú pozíciókat részesíti előnyben: 1.42,
Whale-ek: 67%-os hosszú konszenzus,
MVRV 1.0 felett — on-chain bullish
]
}
Transzparens a tervezés. Minden válasz tartalmaz egy factors objektumot, amely megmutatja az egyes lábak pontszám × súly = súlyozott hozzájárulást, egy adjustments objektumot a szűrő utáni finomhangoláshoz, a weights használt, és egy coverage térképet. Az on-chain láb a valós, ingyenes Coin Metrics adatokat használ (MVRV / exchange-flow / active-address) ha nincs Glassnode kulcs beállítva. Ez egy többtényezős konfluencia pontszám — döntéstámogatás, nem garantált nyerési arány..
A nem követett szimbólumok őszinték. Egy szimbólum, ami a követett derivatívák/whale univerzumon kívül esik, explicit "confidence":"NO_DATA" / "action":"NO_DATA_SKIP" visszatér "unsupported":true — soha nem egy kitalált LOW.
Válaszmezők
| Mező | Típus | Leírás |
|---|---|---|
| ts | integer | A számítás Unix időbélyege |
| szimbólum | string | Eszköz szimbólum (BTC/ETH/SOL) |
| irány | string | Kért irány (long/short) |
| kompozit | float | Kompozit konfluencia pontszám -1.0 (extrém ellentétes) és +1.0 (erős megerősítés) között. Nem nyerési arány. |
| alap_kompozit | float | Kompozit a szűrő utáni kiigazítások alkalmazása előtt |
| bizalom | string | HIGH / MEDIUM / LOW / VETO / NO_DATA |
| művelet | string | CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP |
| méret_szorzó | float | Javasolt pozícióméret-szorzó (pl. 0.0 – 1.5) |
| nem_támogatott | bool | true amikor a szimbólum kívül esik a lefedettségen (NO_DATA párosítva) |
| deriv_score | float | Derivatívák al-pontszám (-1-től 1-ig) |
| onchain_score | float | On-chain al-pontszám (-1-től 1-ig) |
| whale_score | float | Whale konszenzus al-pontszám (-1-től 1-ig) |
| x_score | float | X/szociális érzelmi al-pontszám (-1-től 1-ig); 0 ha nem használt |
| tényezők | objektum | Lábonkénti bontás: score × weight = weighted derivatívák / onchain / whale / x_sentiment (onchain tartalmazza source) |
| kiigazítások | objektum | Előjeles szűrő utáni kiigazítások (egyezés, irányzat, rsi_1h, hírek_makro, lendület, napszak, sorozat_csökkenés) |
| súlyok | objektum | A ténylegesen használt súlykészlet ehhez az értékeléshez |
| lefedettség | objektum | {derivatives, whale, onchain} — mely lábak rendelkeztek valós adatokkal |
| indokok | tömb | Emberi nyelven olvasható magyarázó szövegek a pontszámhoz |
GET /snapshot
Egy teljes piaci pillanatképet ad vissza, beleértve az összes al-pontszámot, nyers metrikákat és mutató értékeket egy adott szimbólumhoz. Hasznos irányítópultokhoz és naplózáshoz.
GET /onchain
Nyers láncon belüli metrikákat ad vissza: MVRV, SOPR, tőzsdei nettó áramlás, realizált kapitalizációs arány és cikluspozíció-osztályozás.
GET /v1/derivatives/*
Több tőzsde közötti derivatív szűrő 500+ szimbólumra: finanszírozási ráta hőtérkép, nyitott pozíció rangsor és hosszú/rövid arány jelzésfelismerés. Az első 10 sor nyilvános; a teljes szűrőhöz Kereskedő vagy Pro szükséges. Végpontok: /v1/derivatives/screener, /v1/derivatives/funding, /v1/derivatives/oi, /v1/derivatives/signals.
GET /v1/options/*
Deribit-ból származó BTC & ETH opció elemzések (nyilvános, hitelesítés nélkül): put/call arány, max pain és nyitott pozíció strike szerint. Végpontok: /v1/options/summary, /v1/options/pcr, /v1/options/oi.
GET /v1/etf/*
Spot BTC & ETF napi nettó áramlások és alapok szerinti bontás (nyilvános). Végpontok: /v1/etf/flows, /v1/etf/funds.
GET /v1/historical/*
Történelmi finanszírozás, nyitott pozíció, hosszú/rövid arány (Binance) és OHLCV (CoinGecko) backtesteléshez. Végpontok: /v1/historical/funding, /v1/historical/oi, /v1/historical/lsr, /v1/historical/ohlcv.
GET /v1/dex/*
DexScreener által működtetett trendi párok, token keresés és pár részletek (nyilvános, hitelesítés nélkül). Végpontok: /v1/dex/trending, /v1/dex/search, /v1/dex/token, /v1/dex/pair.
GET /v1/news/*
Hírintelligencia: politikai/geopolitikai/kriptó hírek hatáskategóriákba sorolva, plusz Félelem & Kapzsiság (nyilvános, hitelesítés nélkül). Végpontok: /v1/news/trump, /v1/news/general, /v1/news/impact, /v1/news/fear-greed.
GET /whales
Visszaadja a bárca pénztár konszenzus adatokat: hosszú/rövid felosztás, teljes nominális kitettség, top 10 pozíció (csak Pro) és pénztár számláló.
GET /signals
Visszaadja a legutóbbi HIGH/MEDIUM jelek folyamát az összes figyelt eszközön. Hasznos lehetőség felderítéshez.
GET /v1/strategies/*
Átlátható, csak olvasható teljesítmény nyilvántartás az automatizált kereskedési stratégiákhoz, amelyek a Smart Money jelekre alapozva működnek — beleértve a deriv40 SmartMoney Copytrade stratégia (account=9). Minden végpont egy ?account=<id> query paramétert vesz fel és JSON-t ad vissza. Nincs hitelesítés szükséges (nyilvános teljesítmény nyilvántartás).
Végpontok
GET /v1/strategies/stats?account=9— főbb mutatók: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— tőke görbe ábrázoláshoz:{ initial_equity, curve: [{ time, equity }] }.GET /v1/strategies/trades?account=9&limit=500— lezárt kereskedési napló: tömb (vagy{trades:[…]}) asymbol,direction,entry_price,exit_price,pnl_usdt,pnl_percent,pnl_percent_net.GET /v1/strategies/active?account=9— jelenleg nyitott pozíciók: tömb (vagy{positions:[…]}) asymbol,side/direction,entry_price,unrealized_pnl.GET /v1/strategies/signals— stratégia által használt jel típusok bontása (darab / győzelmek / győzelmi arány / átlagos pnl jel típusonként).
A múltbeli teljesítmény nem jelenti a jövőbeli eredményeket. Az adatok egy ~3 hónapos időszakot fednek le plusz élő kereskedéseket, és ahol jelzett, díjak előtti értékek láthatók.
GET /export
Történelmi jeladatok letöltése CSV formátumban backtesteléshez. Paraméterek: symbol, from (unix ts), to (unix ts).
GET /health
Rendszer állapot ellenőrzés. Visszaadja az egyes források adatfrissességét és az API általános állapotát. Nincs hitelesítés szükséges.
"status": "ok",
"uptime_s": 1209600,
"sources": {
"bybit": { "lag_s": 42, "ok": true },
"binance": { "lag_s": 38, "ok": true },
"hyperliquid": { "lag_s": 61, "ok": true },
"onchain": { "lag_s": 290, "ok": true }
}
}
GET /usage
Visszaadja az aktuális API használati statisztikákat: mai hívások, havi összesítések, kvóta korlátok és visszaállítási idők.
POST /webhooks
Regisztráljon egy HTTPS URL-t valós idejű, aláírt esemény küldések fogadására, amikor jelzés történik a figyelt eszközökön. A kézbesítések tartalmaznak egy X-SmartMoney-Event fejlécet és egy HMAC-SHA256 aláírást a X-SmartMoney-Signature, és legfeljebb 3× újrapróbálkoznak backoff-al.
Kérés Törzse
| Mező | Típus | Leírás |
|---|---|---|
| urlkötelező | string | HTTPS végpont, ahova eseményeket küldünk POST-tal (el kell kezdődnie https://) |
| eventskötelező | tömb | Esemény nevek, pl. ["HIGH","MEDIUM","VETO"] vagy ["*"] |
| symbolskötelező | tömb | Szimbólumok szűréshez, pl. ["BTC","ETH"] vagy ["*"] |
| secretkötelező | string | Az aláíró titkos kulcsod, ≥ 16 karakter (tárolva hash-elve) |
Az aláírás ellenőrzése
Az HMAC kulcs a regisztrált titkos kulcs SHA-256 hex digest-je. Számítsd ki az HMAC-SHA256-t a nyers kérés törzséből ezzel a kulccsal és hasonlítsd össze (konstans időben) a X-SmartMoney-Signature. See the Webhook Implementation guide.
Intelligencia
GET /analysis
AI-alapú piaci rezsimbesorolást ad vissza jelütközések észlelésével. Elemzi a jelek közötti egyetértést, az eltéréseket a derivatív, on-chain és bálnák adatai között, valamint természetes nyelvű összefoglalót készít előrejelző kockázati tényezőkkel és időhorizontos ajánlással.
Paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| symbolkötelező | string | Eszköz szimbóluma: BTC, ETH, vagy SOL |
Példa válasz
"ts": 1710940821,
"symbol": "BTC",
"regime": "late_cycle_divergence",
"regime_label": "Late Cycle — Signal Divergence",
"summary": "BTC egy késői bull ciklusban van, az on-chain erősség ellentmond a derivatív túlterheltségnek. A bálnák csökkentik a kitettséget, miközben a kiskereskedelmi LSR növekszik.",
"signal_conflicts": [
"Bálnák pontszáma medvehangulatú, miközben az onchain pontszám bull",
"A funding ráta 3 hónapos csúcson — potenciális squeeze kockázat"
],
"risk_factors": ["Magas funding", "OI eltérés", "Bálnák csökkentése"],
"recommendation": "Csökkentsd a long pozíciókat, szigorítsd a stop-okat. Kerüld az új long pozíciókat a jelenlegi ár felett.",
"time_horizon": "4h–12h"
}
GET /liquidations
Visszaad két kiegészítő nézetet: (1) leverage-projected levels — becslés arra, ahol a likvidációs klaszterek vannak; és (2) egy realized_heatmap — a REAL végrehajtott kényszerlikvidációs intenzitás (ár × idő), valós időben aggregálva a nyilvános tőzsdék WebSocket feedjeiből: Binance, OKX, Bybit, Bitget, BitMEX. A hőtérkép akkor látható, ha a streamnek van adata a szimbólumról (hiányozhat egy nagyon nyugodt piacon vagy indítás után rövid ideig).
Paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| szimbólumopcionális | string | Eszköz szimbólum (alapértelmezett BTC). A valós hőtérkép az aktívan kereskedett perp szimbólumokat fedi le. |
Példa válasz
"symbol": "BTC",
"cascade_risk": "HIGH",
"nearest_long_liq_pct": -3.2,
"nearest_short_liq_pct": 4.1,
// VALÓS végrehajtott likvidációk – élőben 5 tőzsdéről
"realized_heatmap": {
"window_minutes": 240, "price_min": 91000.0, "price_max": 99000.0,
"clusters": [ { "price": 93250.0, "notional": 4820000.0, "count": 37, "dominant_side": "long" } ],
"by_side": { "long": 6100000.0, "short": 2400000.0 },
"totals": { "total_notional": 8500000.0, "count": 214 },
"exchanges": { "binance": 120, "okx": 40, "bybit": 34, "bitget": 12, "bitmex": 8 }
}
}
cascade_risk, legközelebbi távolságok és realizált összesítések/oldalanként. Pro csomag: teljes vetített levels plusz a teljes realized_heatmap (mátrixok, ár szerinti klaszterek, tőzsde szerinti számok). A vetített becslés azt válaszolja, "hol vannak a stopok"; a valós hőtérkép azt mutatja, "mi likvidálódott valójában."GET /liquidations/heatmap
Nyilvános ár-szintű likvidációs hőtérkép. Egy Coinglass-stílusú ár × idő mátrixot ad vissza VALÓS végrehajtott kényszerlikvidációk, ár szerint csoportosítva – élőben aggregálva nyilvános tőzsde WebSocket feedekből: Binance, OKX, Bybit, Bitget, BitMEX. A clusters tömb a gyakorlati kimenet: a likvidált névérték szerint rangsorolt ár kosarak, mindegyik domináns oldallal címkézve. Az adatok az élő streamektől függenek – egy nagyon csendes szimbólum vagy egy épp újraindított átjáró a jól formált üres struktúrát adja vissza plusz egy őszinte note. A megjelenített szintek kizárólag valós likvidációk, soha nem becsült értékek.
Paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| symbolopcionális | string | Eszköz szimbóluma (alapértelmezett BTC). |
| window_minutesopcionális | int | Visszatekintő ablak percekben (alapértelmezett 240, korlátozva 5–1440-re). |
| price_bucketsopcionális | int | Árkosarak száma (alapértelmezett 50, korlátozva 5–100-ra). |
Példa válasz
"symbol": "BTC", "window_minutes": 240, "price_buckets": 50,
"price_min": 91000.0, "price_max": 99000.0, "price_bucket_size": 160.0,
"price_levels": [ 91080.0, 91240.0, … ], "time_buckets": [ … ],
"matrix": [ [ … ] ], "long_matrix": [ [ … ] ], "short_matrix": [ [ … ] ],
"clusters": [
{ "price": 93250.0, "notional": 4820000.0, "long_notional": 4100000.0,
"short_notional": 720000.0, "count": 37, "dominant_side": "long" }
],
"by_side": { "long": 6100000.0, "short": 2400000.0 },
"totals": { "long_liq_notional": 6100000.0, "short_liq_notional": 2400000.0, "total_notional": 8500000.0, "count": 214 },
"exchanges": { "binance": 120, "okx": 40, "bybit": 34, "bitget": 12, "bitmex": 8 },
"generated_at": 1710940200, "public": true
}
totals.count is 0, clusters üres, és a note mező megmagyarázza, miért. Ez a végrehajtott likvidációk nyilvántartása — nem pedig előrejelzés. A "hol vannak a stopok" becsléshez használd a hitelesített /liquidations végpontot.GET /liquidations/onchain
Végrehajtott on-chain DeFi hitel likvidációk közvetlenül saját helyi BSC + Avalanche teljes csomópontjainkból rögzítve — független bármilyen kereskedő bottól. Lefedi a Venus/Cream és Moolah-t a BSC-n, valamint AAVE V3/V2, Benqi, BankerJoe, Granary és Vinium-ot az Avalanche-on. A Pro szint emellett visszaadja at_risk pozíciókat (bot-függő, lehet hiányzó).
Paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| chainopcionális | string | bsc vagy avax. Hagyd üresen az összes lánchoz. |
| limitopcionális | integer | Max sorok (alapértelmezett 100, max 500). Legújabbak előre. |
Példa válasz
"chain": "bsc", "count": 2,
"liquidations": [
{ "chain": "bsc", "protocol": "Venus", "borrower": "0x2be6…8dfa",
"debt_symbol": "DAI", "repay_usd": 426.15,
"collateral_symbol": "WBNB", "tx_hash": "0x718c…7c0e", "block": 89170816, "ts": 1710940200 }
],
"summary": {
"window_hours": 24, "enabled": true,
"by_protocol": { "bsc:Venus": { "count": 61, törlesztett_usd_ismeretlen: 148230.55 } },
csomópontok: { bsc: { elérhető: true, fej_blokk: 89173010, események_összesen: 61 } }
}
}
GET /smart-stop
Intelligens stop-loss szinteket számol ki a jelenlegi likvidációs hőtérkép, volatilitási sávok és piaci struktúra alapján. Visszaadja a réteges stop ajánlásokat és a belépési árhoz és kockázattűréshez igazított take-profit javaslatokat.
Paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| symbolkötelező | string | Eszköz szimbólum: BTC, ETH, vagy SOL |
| directionkötelező | string | Pozíció iránya: long vagy short |
| entry_priceopcionális | float | A belépési ár. Alapértelmezés szerint a jelenlegi piaci ár lesz használva, ha nincs megadva. |
| risk_pctopcionális | float | Maximálisan elfogadható kockázat számla %-ban. Alapértelmezett: 2.0 |
Példa válasz
"symbol": "BTC",
"direction": "long",
"entry_price": 96420,
"stops": {
"tight": { "price": 95100, "note": "1h struktúra alatt. Legjobb scalpokhoz." },
"recommended": { "price": 93800, "note": "94K$-os fő likvidációs klaszter alatt. Standard swing stop." },
"wide": { "price": 91200, "note": "4h keresleti zóna alatt. Pozíciós kereskedés stop." }
},
"avoid_zones": [
{ "low": 94200, "high": 94800, "reason": "Sűrű likvidációs klaszter — magas slippage kockázat" }
],
"take_profit_suggestions": [
{ "tp1": 98500, "tp2": 101000, "tp3": 104200 }
]
}
recommended stop csak. Pro csomag: Mindhárom stop szint, avoid_zones, és teljes take-profit javaslatok.GET /funding-arb
Valós időben azonosítja a kereszt-tőzsdei finanszírozási ráta arbitrázs lehetőségeket. Visszaadja rangsorolt lehetőségeket becsült évesített hozammal, optimális tőzsdepárral és a spread eléréséhez szükséges hedge művelettel.
Paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| min_spreadopcionális | float | Minimális finanszírozási ráta spread a listázáshoz (tizedesként). Alapértelmezett: 0.01 |
| symbolopcionális | string | Szűrés egy adott eszközre. Hagyd üresen az összes támogatott eszköz vizsgálatához. |
Példa válasz
"ts": 1710940821,
"opportunities": [
{
"symbol": "BTC",
"spread": 0.032,
"apr": 84.2,
"long_exchange": "hyperliquid",
"short_exchange": "bybit",
"action": "Long HYPE / Short BYBIT",
"estimated_profit_8h_usd": 26.4
}
]
}
Ingyenes nyilvános változat Nincs hitelesítés
Egy kulcs nélküli nyilvános végpont visszaadja a legjobb 10 lehetőséget egy élő kereszt-tőzsdei szűrővel, ideális beágyazáshoz vagy gyors ellenőrzéshez. Elhagyja az eszközönkénti spread történetet és a nehéz mezőket, és 120 másodperces gyorsítótárból szolgál. Ha nincs kereszt-tőzsdei finanszírozási spread a frissességi ablakban, üres opportunities tömböt ad vissza egy note — soha nem hamisított adat.
"opportunities": [
{
szimbólum: OGN,
spread_százalék: 0.297667,
éves_apr: 325.95,
hosszú_tőzsde: bybit,
rövid_tőzsde: hyperliquid,
becsült_nyereség_10k_ért: 29.77,
kockázati_megjegyzések: Alacsony spread — győződjön meg arról, hogy a díjak nem fogyasztják el az arbitrázs margót.
}
],
vizsgált_szimbólumok: 222,
ts: 1783268753,
nyilvános: True,
korlátozott: True
}
GET /smart-money/flow
A minőséggel súlyozott bálna irányindex szimbólumonként, pontozva -100 (bálna pénz rövidre hajló) a +100 (hosszúra hajló). Több ezer nyomon követett Hyperliquid bálna tárca alapján készült — mindegyik súlyozva saját történelmi nyerési arányával és PnL-jével, valamint frissesség szerint csökkentve. Ez egy pozicionálási index, nem vétel/eladási jelzés vagy árelőrejelzés. A kevés hozzájáruló tárca szimbólumok címkézve vannak thin és őszintén pontozva. Élő oldal: smart-money-flow.html.
Paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| szimbólumopcionális | string | Egyetlen szimbólum (pl. BTC). Hagyja üresen az összes nyomon követett szimbólum lekéréséhez |pontszám| szerint rangsorolva. |
| ablak_óraopcionális | int | Pontozási ablak, korlátozva 1..168. Alapértelmezett 24. |
Példa Válasz
szimbólumok: [
{
szimbólum: SPX,
pontszám: -90.93,
irány: erős_rövid,
n_tárcák: 26,
hosszú_usd: 184200.0, rövid_usd: 2410000.0,
minőséggel_súlyozott: True,
minta_minőség: gazdag,
top_közreműködők: [ { tárca: 0x31ca…974b, irány: rövid, érték_usd: 5338.25, súly: 0.4948 } ]
}
],
ablak_óra: 24,
minőséggel_súlyozott: True,
ts: 1783270000,
megjegyzés: Minőséggel súlyozott bálna iránypozicionálási index (-100..+100). Nem árelőrejelzés vagy vétel/eladási jelzés.
}
top_contributors. A tárca súlyok korlátozva vannak [0.25,1.0]; a PnL egy realizálatlan proxy a legújabb pozíció pillanatképeiből.GET /v1/whales/crowding
Kombinált bálna pozicionálás és zsúfoltsági kontextus szimbólumonként, egyesítve Hyperliquid + GMX v2 + Jupiter Perps. Visszaadja a bruttó/netto névértéket, iránytorzítást, tárca és helyszín számokat, pozíciókoncentrációt (top-3 részesedés + HHI), súlyozott átlagos tőkeáttételt, és likvidáció-közelségi kosarak ($ névérték, amely 5% és 10% között van a becsült likvidációs ártól, hosszú/rövidre osztva). Ez kontextus, nem irányjelzés. A származtathatatlan mezők null és megjelennek mint — — pl. lev_wavg/crowding_index amikor egyik pozíció sem hordoz tőkeáttételt. A likvidációs távolságok egy izolált margó becslés (pct_to_liq ≈ 1/lev + upnl/notional − mmr, mmr = 0.01), nem tőzsde által jelentett likvidációs árak.
Paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| min_névértékopcionális | float | Minimális kombinált bruttó névérték (USD) egy szimbólum bevonásához. Alapértelmezett: 1000000. |
Példa Kérés
Példa Válasz
"ok": True, "ts": 1783423500, min_notional: 1000000, n_symbols: 92,
symbols: [
{
symbol: BTC,
gross_usd: 2447900000.0, net_usd: -51000000.0, skew: -0.021,
n_whales: 414, n_venues: 3,
venues: {
hl: { gross: 1900000000.0, net: -40000000.0, n_whales: 272 },
gmx: { gross: 320000000.0, net: -6000000.0, n_whales: 59 },
jupiter: { gross: 227900000.0, net: -5000000.0, n_whales: 83 }
},
conc_top3: 0.159, hhi: 0.011, lev_wavg: 19.1,
liq_within_5pct: { long: 621700000.0, short: 665600000.0 },
liq_within_10pct: { long: 840000000.0, short: 910000000.0 },
crowding_index: 0.003
}
],
caveats: [ A likvidációs távolságok izolált margóbecslések, nem tőzsdei jelentések. ]
}
skew is net/gross ∈ [-1,1]; crowding_index = |skew|·conc_top3·min(lev/20,1). Csak a ténylegesen jelen lévő helyszínek szerepelnek venues. A tőkeáttétel nélküli pozíciók kizárásra kerülnek a likvidációs kosarakból, nem pedig feltételezésre. A névtelen hívók a legnagyobb bruttó értékű 10 szimbólumot kapják ( gated: true); a Trader+ a teljes listát.GET /v1/options/gex
Kereskedő gamma expozíció (GEX) elemzések BTC & ETH, élőben számítva a nyilvános Deribit opciós láncból (nincs hitelesítés). Visszaadja a kereskedők nettó GEX-ét strike-onként (SpotGamma kereskedő-rövid konvenció), a gamma-forduló szint (a strike, ahol a kumulatív nettó GEX nullát keresztez), a IV időstruktúra (ATM implikált volatilitás lejáratig hátralévő napok szerint), és egy front-lejárati IV ferdeség (25Δ-proxy kockázati fordítás). A GEX rezsim positive (kereskedők hosszú gamma → volatilitáscsökkentő) vagy negative (volatilitásfokozó). Teljesen önálló — minden híváskor újraszámítva, nincs tárolt adatbázis-függőség.
Paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| szimbólumopcionális | karakterlánc | BTC vagy ETH csak. Alapértelmezett: BTC. |
Példa kérés
Példa válasz
symbol: BTC, available: true, spot: 63203.0,
net_gex: 18240000.0, regime: positive,
gamma_flip: 64919.82, gamma_flip_pct: 2.72,
call_gex: 31200000.0, put_gex: -12960000.0,
by_strike: [
{ strike: 60000, net_gex: -2100000.0 },
{ kibocsátási ár: 65000, nettó_pozíció: 4800000.0 }
],
időszerkezet: [
{ lejárat: 8JUL26, napok_lejáratig: 0.76, atm_implikált_volatilitás: 62.1 },
{ lejárat: 27MAR26, napok_lejáratig: 14.2, atm_implikált_volatilitás: 58.4 }
],
ferdeség: {
lejárat: 8JUL26, napok_lejáratig: 0.76,
put_iv: 69.69, atm_iv: 62.1, call_iv: 55.34,
risk_reversal: 14.35, bias: downside_fear
}
}
available: false üres panelekkel tér vissza — soha nem gyártott GEX. Az IV ferdeség egy rögzített ±10%-os strike proxyt használ a 25Δ-hoz (a valódi 25-delta megoldáshoz szükséges a delta kiszámítása strike-enként); megfelelő a megjelenítéshez, dokumentálva közelítésként.GET /v1/liquidations/simulate
Interaktív likvidációs kaszkád stressz-teszt. Adott egy feltételezett ármozgás esetén visszaadja a becsült tőkeáttételes pozíciókat, amelyek likvidálódnának, a kényszerített volumen ár szerint / oldal / tőzsde szerint, és egy kaszkádmélység-kiolvasást. Egy lefelé irányuló mozgás a long pozíciókat likvidálja, amelyek likvidációs ára a cél felett/felett van; egy felfelé irányuló mozgás a short pozíciókat likvidálja, amelyek likvidációs ára a cél alatt/alatt van. Két független módszer egyesítve: pontos likvidációs árak a nyomon követett Hyperliquid bálnák valós tőkeáttétel/belépési árból, plusz statisztikai OI-sáv klaszterek tőzsdénként (a tömeg tőkeáttételét a finanszírozásból következtetik). Minden egyértelműen fel van címkézve estimated: true — nem tudja a számlánkénti margót, kereszt vs izolált, hozzáadott margót, vagy ADL-t.
Paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| symbolopcionális | string | Eszköz szimbólum. Alapértelmezett: BTC. |
| move_pctopcionális | float | Feltételezett ármozgás százalékban (negatív = lefelé, pozitív = felfelé). Alapértelmezett: -5. |
Példa Kérés
Példa Válasz
"ok": true, "estimated": true, "symbol": "BTC",
"ref_price": 63000.0, "move_pct": -5.0, "target_price": 59850.0,
"triggered_notional_usd": 380000000.0,
"cascade_depth": 0.029, "cascade_bucket": "low",
"by_exchange": { "hyperliquid": 260000000.0, "binance": 80000000.0, "bybit": 40000000.0 },
"by_side": { "long": 380000000.0, "short": 0.0 },
"clusters": [
{ "price": 60100.0, "side": "long", "notional_usd": 42000000.0, "whale_usd": 18000000.0, "oi_usd": 24000000.0 }
],
"whale_positions_used": 272, "exchanges": 3,
"realized_context": { "available": igaz, fedezeti_órák: 17.8, oldalanként_24h: { hosszú: 6100000.0, rövid: 2400000.0 } },
metodológia: { felelősségi nyilatkozat: Becsült — nem lehet tudni számlánkénti margót, kereszt vs izolált, pótmargót vagy ADL-t. }
}
ok: true, empty: true egy egyszerű, érthető üzenettel, nem pedig hamisított értékekkel. realized_context egy fiatal, növekvő minta az élő kényszerlikvidációs adatfolyamból, csak összefüggésként feltárt — soha nem teszi a becslést "megvalósulttá".GET /v1/wallet/{addr}/profile
Egy többpiacos tárca-profil teljesen élő, nyomon követett bálnapozíciók pillanatképeiből építve. Egy nyomon követett Hyperliquid bálnánál visszaadja a jelenlegi nyitott pozíciókat, a realizálatlan nyereség/veszteség, kitettség, pozíciószám idősor, egy NYITÁS/ZÁRÁS/VÁLTÁS tevékenység idővonala (egymást követő pillanatképek különbségének felhasználásával rekonstruálva), a dekódolt HL-ranglistás címke, és egy nyitott könyv összegzés. Élő oldal: wallet-profiler.html.
Paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| addrkötelező | string | Pénztárca cím (útvonal szegmens), pl. /v1/wallet/0x3bcae23e…/profile. |
| napopcionális | integer | Visszatekintő ablak a sorozathoz és idővonalhoz. Alapértelmezett: 30. |
Példa kérés
Példa válasz
ok: true, pénztárca: 0x3bcae23e…, nyomon követve: true,
első_látás_ts: 1782827733, legutóbbi_pillanatkép_ts: 1783418468, állapot szerint: 1783418468,
hyperliquid: {
címke: { név: Andre is back, pontszám: 74,
ablak_pnl_usd: 1307000, nyerési_ráta_százalék: 71, kereskedések: 42 },
pozíciók: [
{ platform: hyperliquid, szimbólum: ETH, irány: short,
méret: 1200.0, belépési_ár: 1800.0, realizálatlan_nyereség_veszteség: 34800.0,
tőkeáttétel: 20.0, érték_usd: 2160000.0 }
],
sorozat: [ { időbélyeg: 1783330000, realizálatlan_nyereség_veszteség: 42000.0, kitettség_usd: 18400000.0, pozíciók: 5 } ],
idővonal: [ { időbélyeg: 1783400000, esemény: váltás, szimbólum: ETH,
irány: short, korábbi_irány: long, érték_usd: 2160000.0 } ],
összefoglaló: {
nyitott_pozíciók: 5, nyereséges: 3, veszteséges: 2, longok: 0, shortok: 5,
összes_realizálatlan_nyereség_veszteség: -12000.0, teljes_kitettség_usd: 21000000.0, átlagos_tőkeáttétel: 19.9,
ablak_napokban: 30, pillanatképek_az_ablakban: 474,
realizált_nyereség_veszteség: None, realizált_nyereség_veszteség_megjegyzés: Nem származtatható — csak nyitott pillanatképek láthatók, soha lezáró tranzakciók.
}
}
}
pnl HL saját realizálatlan piaci értékelése, value_usd nyitott névérték. A teljes körforgásra jutó realizált nyereség/veszteség nem elérhető (csak nyitott pillanatképeket látunk, soha lezáró tranzakciókat) és így jelenik meg null / —; a idővonal CLOSE eseményei nem tartalmaznak nyereség/veszteség igényt. Egy érvényes, de nem követett cím visszatér tracked: false egy megjegyzéssel; egy érvénytelen cím visszatér ok: false, error: "invalid_address" (HTTP 400). A HL-ranglista címke HL saját ablakbeli helyzetét mutatja a felfedezéskor, nem általunk számított.GET /flows
Visszaadja a kereszt-eszkoz tőkeáramlási adatokat, amelyek a BTC, ETH és SOL közötti rotációs mintákat mutatják több időablakban. Hasznos annak azonosításához, hogy melyik eszköz gyűjt tőkét és melyik osztja szét egy adott pillanatban.
Példa válasz
időbélyeg: 1710940821,
áramlások: {
BTC: { 1h: 142000000, 4h: 380000000, 12h: -90000000, 24h: 220000000 },
ETH: { 1h: -38000000, 4h: -110000000, 12h: 55000000, 24h: -80000000 },
SOL: { 1h: 12000000, 4h: 29000000, 12h: 18000000, 24h: 44000000 }
},
észlelt_rotációk: [
Tőke rotálása ETH-ről BTC-re 4 órás ablakban,
SOL felhalmozás konzisztens minden ablakban
]
}
GET /whale-events
Visszaadja a jelentős bálna pozícióváltozásokat — nyitásokat, lezárásokat és irányváltásokat — amelyeket a követett pénztárcák és on-chain címek között észleltek a megadott visszatekintő ablakban.
Paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| szimbólumopcionális | string | Szűrés eszköz szerint. Hagyd üresen az összes figyelt eszközhöz. |
| jelentőségopcionális | string | Szűrés esemény jelentősége szerint: high, medium, vagy all. Alapértelmezett: all |
| óraopcionális | integer | Visszatekintő ablak órákban. Alapértelmezett: 24 |
Példa válasz
szimbólum: BTC,
összefoglaló: {
váltások_longra: 3,
váltások_shortra: 1,
új_nyitások: 7,
lezárások: 2
},
események: [
{
típus: flip_long,
tárca: 0xWhale...a4f2,
irány: long,
size_usd: 4200000,
ts: 1710938400
}
]
}
summary objektumot csak. Pro terv: Teljes events adatfolyam tárca azonosítókkal, méretekkel és időbélyegekkel.GET /regimes/history
Visszaadja a történelmi rezsim besorolási adatokat egy adott eszközhöz. Használható annak tesztelésére, hogy a különböző rezsimtípusok hogyan teljesítettek a múltban, mennyi ideig tartottak jellemzően, és hogyan alakultak a rezsimváltások időben.
Paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| symbolopcionális | string | Eszköz szimbólum. Alapértelmezett: BTC |
| regimeopcionális | string | Szűrés egy adott rezsimtípusra, pl. late_cycle_divergence. Hagyd üresen az összes rezsimhez. |
| daysopcionális | integer | Visszatekintő ablak napokban. Alapértelmezett: 30. Maximum: 365 |
Példa válasz
"symbol": "BTC",
"current_regime": "late_cycle_divergence",
"regime_summary": {
"late_cycle_divergence": { "occurrences": 4, "avg_duration_h": 38, "avg_return_pct": -2.1 },
"accumulation": { "occurrences": 6, "avg_duration_h": 72, "avg_return_pct": 5.4 },
"breakout": { "occurrences": 3, "avg_duration_h": 18, "avg_return_pct": 9.2 }
},
"transitions": [
{ "from": "accumulation", "to": "breakout", "ts": 1710850000 },
{ "from": "breakout", "to": "late_cycle_divergence", "ts": 1710915000 }
]
}
/analysis val, hogy ellenőrizd a stratégiai feltételezéseket a történelmi rezsim teljesítményadatokkal.GET /exchange-health
Valós idejű állapotjelzést ad minden figyelt tőzsde számára, beleértve a tőzsdénkénti késleltetést, hibákat és az adatok frissességét. Nincs hitelesítés szükséges – nyilvánosan elérhető végpont.
Példa válasz
"overall_status": "ok",
"ts": 1710940821,
"exchanges": {
"bybit": { "status": "ok", "latency_ms": 42, "error_rate_1h": 0.0, "last_data_age_s": 18 },
"binance": { "status": "ok", "latency_ms": 38, "error_rate_1h": 0.0, "last_data_age_s": 22 },
"hyperliquid": { "status": "degraded", "latency_ms": 310, "error_rate_1h": 0.04, "last_data_age_s": 95 },
"okx": { "status": "ok", "latency_ms": 55, "error_rate_1h": 0.0, "last_data_age_s": 30 }
}
}
GET /sentiment
Valós idejű Félelem és Kapzsiság indexet (0-100) ad vissza, amely a derivatív szentimentum, bálna tevékenység, volatilitás és közösségi jelek alapján számított. Tartalmaz komponens lebontást és 24 órás előzményt trendelemzéshez.
Paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| symbolopcionális | string | Eszköz szimbólum. Alapértelmezett: BTC |
Példa válasz
"symbol": "BTC",
"score": 72,
"label": "Mohóság",
"components": {
"volatilitás": 65,
"momentum": 78,
"derivatívák": 70,
"whale_activity": 75,
"közösségi": 68
},
"history_24h": [
{ "ts": 1710940800, "score": 68, "label": "Mohóság" },
{ "ts": 1710937200, "score": 65, "label": "Mohóság" }
],
"ts": 1710940821
}
Integrációk
GET /tradingview/setup
Visszaadja a személyre szabott TradingView integrációs beállításokat: webhook URL-t, ellenőrzési titkot, és azonnal használható Pine Script indikátorokat, amelyek közvetlenül csatlakoznak a Smart Money API-hoz. Másold be a Pine Script kódot a TradingView-ba, hogy rátegyük a jeleinket bármelyik chartra.
Példa válasz
"webhook_url": "https://api.smartmoneyapi.com/v1/tradingview/webhook",
"webhook_secret": "tvs_a1b2c3...",
"pine_scripts": {
"composite_indicator": "// Smart Money Composite v1 //@version=5 indicator(...)...",
"whale_activity": "// Whale Activity Overlay v1 ...",
"funding_dashboard": "// Funding Rate + LSR Dashboard v1 ..."
}
}
POST /tradingview/webhook
Fogad egy TradingView riasztást, feldolgozza a /confirm, és visszaadja a megerősítést. A TradingView nem tud egyéni fejléceket küldeni, ezért hitelesítsd a webhookodat secret a JSON törzsben (ez a végpont nem használ X-API-Key-t). A válasz becsomagolja a megerősítést és hozzáad egy legfelső szintű action a CONFIRMED (daemon confidence HIGH/MEDIUM) vagy VETOED.
Kérés törzse
"secret": "your_webhook_secret",
"symbol": "BTC",
"direction": "long",
"timeframe": "1h",
"strategy": "EMA crossover",
"price": 67500.0
}
Kötelező: secret, symbol, direction (long|short). Opcionális: source, timeframe, strategy, price.
Személyre szabás
GET /preferences
Visszaadja a jelenlegi személyre szabott beállításokat, beleértve az alapértelmezett kereskedési paramétereket, kockázati profilt, figyelőlistát és értesítési preferenciákat.
Frissíti a preferenciákat egy JSON törzs küldésével, amely az alábbi mezők bármely részhalmazát tartalmazza. A kihagyott mezők megtartják jelenlegi értéküket.
Preferencia mezők
| Mező | Típus | Leírás |
|---|---|---|
| default_trade_size_usd | float | Alapértelmezett pozíció méret USD-ben Kelly és smart-stop számításokhoz |
| risk_tolerance | string | conservative, moderate, vagy aggressive |
| default_risk_pct | float | Alapértelmezett kockázat kereskedésenként számla %-ban. Használja a /smart-stop amikor risk_pct kihagyva |
| watchlist | array | Rendezett lista eszköz szimbólumokból, pl. ["BTC","ETH","SOL"] |
| notification_email | string | Email cím riasztások kézbesítéséhez |
| timezone | string | IANA időzóna string, pl. America/New_York |
"default_trade_size_usd": 5000,
"risk_tolerance": "mérsékelt",
"default_risk_pct": 1.5,
"watchlist": ["BTC", "ETH", "SOL"]
}
GET /watchlist
Visszaadja a megerősítési állapot pillanatképét és a legfontosabb kockázati mutatókat a beállított figyelőlistán szereplő összes szimbólumhoz. Több eszköz áttekintését nyújtja anélkül, hogy minden szimbólumra külön-külön kellene hívást kezdeményezni. /confirm külön minden szimbólumra.
Példa válasz
"ts": 1710940821,
"watchlist": [
{
"symbol": "BTC",
"confidence": "HIGH",
"action": "CONFIRM",
"regime": "accumulation",
"cascade_risk": "LOW"
},
{
"symbol": "ETH",
"confidence": "MEDIUM",
"action": "REDUCE",
"regime": "late_cycle_divergence",
"cascade_risk": "HIGH"
},
{
"symbol": "SOL",
"confidence": "HIGH",
"action": "CONFIRM",
"regime": "breakout",
"cascade_risk": "MEDIUM"
}
]
}
Valós idejű streamelés (élő swapok)
Streamelje a valós időben észlelt, 500 USD feletti DEX swapokat saját BSC és Avalanche csomópontjainkból. Két átviteli mód érhető el: egy nyilvános Server-Sent Events (SSE) stream ingyenes/böngészős klienseknek, és egy kis késleltetésű WebSocket firehose a fizetős csomagoknak. Az események másodperceken belül kerülnek közvetítésre, miután bekerültek egy blokkba.
Nyilvános SSE stream (ingyenes)
Nincs hitelesítés szükséges. Natív EventSource támogatás minden modern böngészőben. A szerver swap eseményeket és periodikus szívveréseket küld a kapcsolat életben tartásához.
es.addEventListener("swap", e => {
const swap = JSON.parse(e.data);
console.log(swap.chain, swap.pair, swap.amount_usd);
});
WebSocket Firehose (fizetős)
Hitelesítés (ajánlott): soha ne helyezze el a hosszú élettartamú kulcsát az URL-ben — a proxyk naplózzák és a böngésző előzményeibe kerül. Ehelyett POST-olja a kulcsát a /v1/ws/ticket a biztonságos X-API-Key fejléc használatával, majd nyissa meg a szoftvercsatornát a visszakapott egyszer használatos ticket érvényes ~60 másodpercig, egyszer váltható be). A fejlécet beállítani képes szerveroldali kliensek közvetlenül is átadhatják a X-API-Key kézfogáskor. Az ingyenes csomag kulcsai egy 402 payment_required választ kapnak. Egy hello keret érkezik csatlakozáskor a csomaggal és a közvetítési küszöbértékkel.
const r = await fetch("https://api.smartmoneyapi.com/v1/ws/ticket", {
method: "POST", headers: { "X-API-Key": "sm_xxx" }
});
const { ticket } = await r.json();
// 2. Nyissa meg a szoftvercsatornát az egyszer használatos jeggyel
const ws = new WebSocket(`wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=${ticket}`);
ws.onmessage = e => {
const swap = JSON.parse(e.data);
if (swap.type === "swap") console.log(swap);
};
WebSocket hitelesítés (jegyek)
Miért: soha ne helyezze el az API kulcsát egy WebSocket URL-ben — a lekérdezési karakterláncokat a proxyk, terheléselosztók naplózzák, és a böngésző előzményeibe kerülnek. Ehelyett cserélje le a kulcsát egy rövid élettartamú, egyszer használatos jegyre egy normál hitelesített POST segítségével, majd csatlakozzon ezzel a jeggyel.
Folyamat: POST a /v1/ws/ticket a X-API-Key fejlécével → kapja meg a { "ticket": "…", "expires_in": 60 }. Ezután nyissa meg wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=<ticket>. A jegy egyszer használatos és lejár ~60 másodperc múlva. A kiszolgálóoldali kliens, amely kérelmi fejléceket állíthat be, helyette átadhatja X-API-Key közvetlenül a WebSocket kézfogáskor – nincs szükség jegyre.
Létrehoz egy egyszer használatos jegyet egy hitelesített WebSocket kézfogáshoz. Hitelesítés a X-API-Key fejléc segítségével (a kulcsod soha nem hagyja el a kérelem fejléceit). A visszaadott jegyet egyszer lehet beváltani a /v1/ws/live-swaps címen, mielőtt lejár.
"https://api.smartmoneyapi.com/v1/ws/ticket"
Példa válasz
"ticket": "wst_9f3c1a8e4b2d…",
"expires_in": 60
}
Válasz mezők
| Mező | Típus | Leírás |
|---|---|---|
| ticket | string | Egyszer használatos token, amely a ?ticket= WebSocket URL-hez csatolható. Egyszer beváltva, majd érvénytelenítve. |
| expires_in | number | Másodpercek a jegy lejáratáig (~60). Új jegyet kell kérni minden kapcsolati kísérletnél. |
Megjegyzés: a régi ?key= query-param hitelesítés már nem elfogadott a WebSocket végpontokon biztonsági okokból. Használj jegyet (böngészős kliensek) vagy a X-API-Key kézfogási fejlécet (kiszolgálóoldali kliensek).
REST Pillanatkép
Visszaadja az utolsó N közvetített swapot a gyűjtőpufferből. Hasznos irányítópultok első megjelenítéséhez, mielőtt a stream kapcsolat megnyílik. Szintén elérhető: /v1/live-swaps/status a közvetítő statisztikáihoz.
Eséma séma
| Mező | Típus | Leírás |
|---|---|---|
| chain | string | bsc vagy avalanche |
| dex | string | Router neve (pl. pancakeswap_v2, traderjoe) vagy unknown_dex |
| swapper | string | A swapot végrehajtó pénztárca teljes 0x címe |
| swapper_short | string | Rövidített forma megjelenítéshez (pl. 0xb300…028d) |
| swapper_url | string | Közvetlen link a swapperhez a lánc blokkfelfedezőjén |
| tx_hash | string | Tranzakció hash |
| explorer_url | string | Közvetlen link a tranzakcióhoz a BscScan / Snowtrace oldalon |
| token_in | string | Az eladott token szimbóluma (pl. USDT) |
| token_out | string | A megvásárolt token szimbóluma |
| amount_usd | number | A swap USD értéke (minimum: $500) |
| pair | string | Formázott pár címke (pl. USDT → USDC) |
| block | number | A blokk száma, ahol a swapot bányászták |
| timestamp | number | Unix epoch másodpercek |
| significance | string | low / medium / high / critical USD méret alapján |
| seq | number | Monoton növekvő közvetítési sorszám – használható hézag észlelésére |
POST /alerts/conditions
Hozz létre egyéni riasztási szabályokat, amelyek akkor aktiválódnak, ha egy megadott metrika átlép egy küszöbértéket. A riasztások webhookon, e-mailen vagy az irányítópult értesítési feedjén keresztül érkeznek, a beállításaidtól függően.
Visszaadja az összes konfigurált riasztási feltételedet az azonosítóikkal, definícióikkal és aktuális állapotukkal.
Véglegesen eltávolít egy riasztási feltételt az azonosítója alapján.
Visszaadja a legutóbbi riasztási eseményeket időbélyeggel, illeszkedő feltételekkel és a metrika értékével a riasztás idején.
Riasztás létrehozása – Kérés törzse
| Mező | Típus | Leírás |
|---|---|---|
| névkötelező | string | Emberi által olvasható címke ehhez a riasztáshoz (max 64 karakter) |
| metricrequired | string | A figyelni kívánt metrika. Lásd az elérhető metrikákat az alábbi táblázatban. |
| symboloptional | string | Eszköz kontextus. Szükséges a szimbólumhoz kötött metrikákhoz, mint például funding_rate. |
| operatorrequired | string | Összehasonlító operátor: gt, lt, eq, crosses_above, crosses_below |
| thresholdrequired | float | Numerikus érték, amellyel a metrikát összehasonlítjuk |
| deliveryoptional | string | Kézbesítési csatorna, pl. telegram (alapértelmezett) vagy webhook |
| cooldown_minutesoptional | integer | Minimális perc az újraindítások között (alapértelmezett 60) |
Az érvényes metrikák és operátorok élő listáját visszaadja GET /v1/alerts/conditions as available_metrics and available_operators.
Elérhető metrikák
| Metric | Leírás |
|---|---|
| funding_rate | Aktuális finanszírozási ráta a szimbólumra (tizedes törtként) |
| global_lsr | Globális long/short arány a szimbólumra |
| long_pct | A szimbólumot nettó long pozícióban tartó számlák százaléka |
| top_trader_lsr | Top-kereskedő long/short arány a szimbólumra |
| taker_ratio | Taker vétel/eladás arány a szimbólumra |
| mvrv | Piaci érték a realizált értékhez viszonyítva (BTC/ETH) |
| sopr | Spent Output Profit Ratio (BTC/ETH) |
| exchange_net_flow | On-chain tőzsdei net-flow jelzés |
| accumulation | On-chain akkumulációs jelzés |
| whale_long_pct | A nyomon követett bálna pénztárak százaléka, amelyek long pozíciót tartanak a szimbólumban |
| whale_n_wallets | A nyomon követett bálna pénztárak száma, amelyek pozícióval rendelkeznek a szimbólumban |
| composite_long | Összetett pontszám a szimbólumra long irányban lekérdezve |
| composite_short | Összetett pontszám a szimbólumra short irányban lekérdezve |
| funding_spread | Kereszt-intézményi finanszírozási különbség a szimbólumra |
"name": "BTC finanszírozási ráta ugrás",
"metric": "funding_rate",
"symbol": "BTC",
"operator": "gt",
"threshold": 0.05
}
GET /kelly
Kelly-kritérium pozícióméretezési ajánlásokat ad vissza, amelyek a történelmi jel teljesítményéhez vannak kalibrálva az adott szimbólum, megbízhatósági szint és irány alapján. A pozíció méretét empirikus nyerési arányokra alapozza, hogy elkerülje a túlzott tőkeáttételt.
Paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| symbolrequired | string | Eszköz szimbólum: BTC, ETH, vagy SOL |
| confidenceoptional | string | A modellezendő jel megbízhatósági szintje: HIGH, MEDIUM, vagy LOW. Alapértelmezett: HIGH |
| directionoptional | string | Kereskedési irány: long vagy short. Alapértelmezett: long |
| account_sizeoptional | float | Számla mérete USD-ben a kiszámításhoz suggested_size_usd. Alapértelmezett: 10000 |
Példa válasz
"symbol": "BTC",
"confidence": "HIGH",
"direction": "long",
"win_rate": 0.68,
"avg_reward_risk_ratio": 2.1,
"kelly_fraction": 0.36,
"half_kelly": 0.18,
"suggested_size_usd": 1800,
"samples": 142,
"note": "A Half-Kelly ajánlott élő kereskedéshez a becslési hiba figyelembe vétele miatt."
}
GET /performance
Visszaadja az API által kiadott jelek történelmi pontossági statisztikáit, bontva bizalmi szint szerint. Hasznos a jel megbízhatóságának megértéséhez tőke elkötelezése előtt.
Paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| szimbólumopcionális | string | Szűrés eszköz szerint. Hagyja üresen az összes szimbólumra vonatkozó összesített statisztikákhoz. |
| napokopcionális | integer | Visszatekintő ablak napokban. Alapértelmezett: 30 |
Példa Válasz
"szimbólum": "BTC",
"period_days": 30,
"by_confidence": {
"HIGH": { "win_rate": 0.71, "samples": 58, "avg_return_pct": 3.4 },
"MEDIUM": { "win_rate": 0.54, "samples": 84, "avg_return_pct": 1.2 }
}
}
Statisztikák & Jelek
GET /v1/stats
Az egész oldalra vonatkozó őszinte teljesítménystatisztikák forrása smart_money_confirm különböző hívási eredmények. Visszaadja a nyerési arányokat a HIGH és MEDIUM bizalmi szinteken, az összesített pontosságot, a profit faktort és egy szimbólumonkénti bontást. Minden adat a pontozási ablakon belüli mintán alapul; tekintse meg a calibration.html további kontextusért és a előretekintő tartási módszertanért.
Példa Válasz
"high_winrate": 0.714,
"high_winrate_n": 14,
"medium_winrate": 0.530,
"medium_winrate_n": 34,
"overall_accuracy": 0.613,
"overall_accuracy_n": 48,
"profit_factor": 1.77,
"avg_win_pct": 4.2,
"winrate_horizon": "24h",
"winrate_basis": "különböző megerősítő hívások, 24 óránként feloldott eredmények",
"winrate_by_symbol": {
"BTC": { "win_rate": 0.68, "n": 22 },
"ETH": { "win_rate": 0.55, "n": 18 },
"SOL": { "win_rate": 0.60, "n": 8 }
},
"forward_holdout": {
"win_rate": 0.59,
"high_win_rate": 0.70,
"high_n": 10,
"is_distinct_from_insample": false
}
}
forward_holdout objektum az egyetlen szám, amely olyan adatokon alapul, amelyeket a pontozó még soha nem látott – figyelje, hogyan növekszik idővel. Tekintse meg a calibration.html teljes módszertanért és a mintán belüli / előretekintő teszt határért.GET /v1/signals/performance
Jel eredmények nyomon követése több felbontási horizonton (4h, 12h, 24h, 72h). Visszaadja az egyes horizontokonkénti találati arányokat, a teljes jel számokat és a jel típus szerinti bontást.
Paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| napokopcionális | integer | Visszatekintő ablak napokban. Alapértelmezett: 30 |
| jel_típusopcionális | string | Szűrés típus szerint, pl. smart_money_confirm vagy regime_flip. Hagyja üresen az összes típushoz. |
| szimbólumopcionális | string | Szűrés eszköz szimbólum szerint, pl. BTC. Hagyja üresen az összes szimbólumra vonatkozó összesítéshez. |
Példa Válasz
"jel_típus": "smart_money_confirm",
"szimbólum": "BTC",
"napok": 30,
"total_signals": 48,
horizontok: {
4h: { találati arány: 0.65, lezárt: 46 },
12h: { találati arány: 0.61, lezárt: 44 },
24h: { találati arány: 0.58, lezárt: 40 },
72h: { találati arány: 0.54, lezárt: 32 }
},
típus szerinti bontás: {
smart_money_confirm: { darabszám: 35, 24h találati arány: 0.61 },
rezsimváltás: { darabszám: 13, 24h találati arány: 0.47 }
}
}
GET /v1/signals/recent
Az összes figyelt szimbólumon közzétett HIGH és MEDIUM jelek friss listája. Minden bejegyzés tartalmazza a jel típusát, megbízhatósági szintjét, irányát és a rendelkezésre álló lezárási állapotot.
Példa válasz
signals: [
{
id: 1042,
symbol: BTC,
direction: long,
signal_type: smart_money_confirm,
confidence: HIGH,
composite: 0.74,
ts: 1710940821,
resolved: true,
outcome_24h: win
}
],
count: 50
}
GET /v1/signals/{id}/outcome
Egy jel numerikus ID alapján történő lezárt eredménye. Visszaadja a találat/hibát minden felbontási horizonton (4h, 12h, 24h, 72h) a jelzés időpontjában és a lezáráskor érvényes árakkal együtt.
Paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| idkötelező | integer | Jelzés ID (útvonal rész), pl. /v1/signals/1042/outcome |
Példa válasz
id: 1042,
symbol: BTC,
direction: long,
confidence: HIGH,
entry_price: 63200.0,
ts: 1710940821,
outcomes: {
4h: { result: win, price: 64100.0, pct: 1.41 },
12h: { result: win, price: 65200.0, pct: 3.16 },
24h: { result: win, price: 65800.0, pct: 4.11 },
72h: { result: pending, price: null, pct: null }
}
}
GET /v1/confirm-winrate
A hitelesített felhasználó saját API kulcsára vonatkozó confirm-jel win-rate bontás. Visszaadja a különböző hívások win rate értékeit minden megbízhatósági szinten, profit faktort és szimbólumonkénti adatokat. Szükséges egy érvényes X-API-Key fejléc.
Példa kérés
"https://api.smartmoneyapi.com/v1/confirm-winrate"
Példa válasz
high_winrate: 0.714,
high_n: 14,
medium_winrate: 0.530,
medium_n: 34,
overall_accuracy: 0.613,
overall_n: 48,
profit_factor: 1.77,
winrate_horizon: 24h,
by_symbol: {
BTC: { win_rate: 0.68, n: 22 },
ETH: { win_rate: 0.55, n: 18 }
}
}
Shadow Gate
Egy változtathatatlan, csak hozzáfűzhető személyes döntési nyilvántartás. Küldje el kereskedési döntéseit azok végrehajtása előtt vagy után; a rendszer kiszámítja a megerősítési pontszámot a Smart Money motorral szemben, és végleges sort fűz hozzá. Használja egy időbélyegzett, őszite nyomon követésére annak, hogy mennyire egyezett az API jelzése a saját belépéseivel – teljesen függetlenül a globális nyerési arány gyűjtőtől. Az Ingyenes és Trader szintek válaszaiban a bizonyíték mezők el vannak távolítva; a Pro szint teljes részletezést ad vissza. Az Ingyenes szint adataira késleltetés vonatkozik.
Döntés beküldése. Idempotens a Idempotency-Key kérés fejlécén – ugyanazon kulcs újraküldése esetén a meglévő sort adja vissza, duplikáció nélkül. A rendszer azonnal meghívja a megerősítő motort, és az eredményt változtathatatlan nyilvántartási sorként fűzi hozzá.
Kérés törzse
| Mező | Típus | Leírás |
|---|---|---|
| symbolkötelező | string | Eszköz szimbóluma, pl. BTC |
| sidekötelező | string | Kereskedési irány: long vagy short |
| strategy_idopcionális | string | Hívó által definiált stratégia címke (max 64 karakter). Csoportosításhoz és szűréshez tárolva. |
Példa kérés
-H "X-API-Key: sm_your_key" \
-H "Idempotency-Key: my-signal-20260701-001" \
-H "Content-Type: application/json" \
-d '{"symbol":"BTC","side":"long","strategy_id":"ema_crossover"}' \
"https://api.smartmoneyapi.com/v1/shadow-gate/decisions"
Példa válasz
"id": 318,
"symbol": "BTC",
"side": "long",
"strategy_id": "ema_crossover",
"decision": "CONFIRM",
"confidence": "HIGH",
"composite": 0.74,
"size_mult": 1.5,
"ts": 1710940821,
"resolved": false
}
factors / adjustments bizonyíték mezőket. A Pro szint teljes megerősítési részletezést ad vissza. Az Ingyenes szintre késleltetés vonatkozik – a sor azonnal íródik, de a megerősítési pontszám akár 60 másodpercig elavult adatokat is tartalmazhat.Listázza saját shadow-gate döntéseit, legújabbtól kezdve. Tulajdonos-hatókörű – csak az Ön API kulcsával beküldött döntések kerülnek visszaadásra.
Paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| limitopcionális | integer | Visszaadandó sorok maximális száma. Alapértelmezett: 50, max: 200 |
| cursoropcionális | string | Átlátszatlan lapozó kurzor egy előző válasz next_cursor mezőjéből. Hagyja üresen az első oldalhoz. |
Példa válasz
"decisions": [
{ "id": 318, "symbol": "BTC", "side": "long", "decision": "CONFIRM", "confidence": "HIGH", "composite": 0.74, "size_mult": 1.5, "ts": 1710940821, "resolved": false },
{ "id": 317, "symbol": "ETH", "side": short, döntés: SKIP, bizalom: LOW, összetett: -0.12, size_mult: 0.0, ts: 1710937000, megoldva: True }
],
szám: 2,
next_cursor: None
}
Egyedi döntés ID alapján, teljes megerősítő bizonyítékkal a Pro szinten. A Free és Trader szintek válaszai factors és adjustments eltávolítva. Visszaadja 403 ha a döntés egy másik API kulcshoz tartozik.
Példa válasz (Pro)
id: 318,
szimbólum: BTC,
oldal: long,
stratégia azonosító: ema_crossover,
döntés: CONFIRM,
bizalom: HIGH,
összetett: 0.74,
size_mult: 1.5,
tényezők: {
derivatívák: { pontszám: 0.81, súly: 0.40, súlyozott: 0.324 },
onchain: { pontszám: 0.68, súly: 0.35, súlyozott: 0.238 },
whale: { pontszám: 0.73, súly: 0.25, súlyozott: 0.183 }
},
ts: 1710940821,
megoldva: False,
eredmény: None
}
Döntés eredményének manuális rögzítése. Hívd meg a kereskedés lezárása után, hogy rögzítsd a végső eredményt a főkönyv sorában. Miután megoldották, a sor módosíthatatlan és nem változtatható meg újra.
Kérés törzse
| Mező | Típus | Leírás |
|---|---|---|
| eredménykötelező | string | Kereskedés eredménye: win vagy loss |
| exit_priceopcionális | float | Kereskedés záró ára. Referenciaként tárolva; használatos a P&L % kiszámításához, ha meg van adva. |
| pnl_pctopcionális | float | Realizált nyereség/veszteség százalékban a pozíció méretéhez viszonyítva, pl. 3.5 vagy -1.2 |
Példa válasz
id: 318,
megoldva: True,
eredmény: nyertes,
exit_price: 65800.0,
pnl_pct: 4.1,
resolved_at: 1711027200
}
Hibakódok
| Állapot | Kód | Leírás |
|---|---|---|
| 400 | invalid_params | Hiányzó vagy érvénytelen lekérdezési paraméterek |
| 401 | unauthorized | Hiányzó vagy érvénytelen API kulcs |
| 403 | plan_restriction | Végpont nem elérhető az aktuális csomagban |
| 429 | rate_limit_exceeded | Napi vagy burst limit elérve |
| 500 | internal_error | Szerverhiba – ellenőrizd a /health állapotát |
| 503 | data_stale | Adatforrás nem elérhető; visszaadva az utolsó ismert adattal |
Kódpéldák
Python
r = requests.get(
https://api.smartmoneyapi.com/v1/confirm,
params={szimbólum: BTC, irány: long},
headers={X-API-Key: sm_your_key}
)
data = r.json()
print(data["confidence"]) # HIGH / MEDIUM
print(data["size_mult"]) # 1.5 / 1.0
API_KEY = "sm_your_key"
BASE_URL = "https://api.smartmoneyapi.com/v1"
def confirm_trade(symbol, direction):
resp = requests.get(
f"{BASE_URL}/confirm",
params={"symbol": symbol, "direction": direction},
headers={"X-API-Key": API_KEY},
timeout=5
)
resp.raise_for_status()
return resp.json()
# A kereskedési ciklusban:
signal = confirm_trade("BTC", "long")
if signal["confidence"] not in ["HIGH", "MEDIUM"]:
print("Kihagyás – elégtelen bizalom")
else:
size = base_size * signal["size_mult"]
place_order(symbol, direction, size)
JavaScript / Node.js
async function confirmTrade(symbol, direction) {
const params = new URLSearchParams({ symbol, direction });
const res = await fetch(
`https://api.smartmoneyapi.com/v1/confirm?${params}`,
{ headers: { 'X-API-Key': API_KEY } }
);
if (!resok) throw new Error(`API hiba: ${resstatus}`);
return res.json();
}
// Használat
confirmTrade('BTC', 'long').then(data => {
console.log(dataconfidence, datasize_mult);
});
cURL
curl -X GET \
-H "X-API-Key: sm_your_key" \
"https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"
# Whale adatok lekérése
curl -X GET \
-H "X-API-Key: sm_your_key" \
"https://api.smartmoneyapi.com/v1/whales?symbol=BTC"
# Használat ellenőrzése
curl -X GET \
-H X-API-Key: sm_your_key \
https://api.smartmoneyapi.com/v1/usage
Freqtrade integráció
Adjon hozzá Smart Money megerősítést bármely Freqtrade stratégiához a metódus felülírásával. confirm_trade_entry metódus.
from freqtrade.strategy import IStrategy
class SmartMoneyStrategy(IStrategy):
SM_API_KEY = "sm_your_key"
SM_BASE = "https://api.smartmoneyapi.com/v1"
def confirm_trade_entry(self, pair, order_type,
amount, rate, time_in_force,
current_time, entry_tag, **kwargs):
symbol = pair.split("/")[0]
if symbol not in ["BTC", "ETH", "SOL"]:
return True # Skip check for unsupported
try:
r = requests.get(
f"{self.SM_BASE}/confirm",
params={"symbol": symbol, "direction": "long"},
headers={"X-API-Key": self.SM_API_KEY},
timeout=3
).json()
return r.get("confidence") in ["HIGH", "MEDIUM"]
except:
return True # API hiba esetén folytatás
CCXT + Smart Money
exchange = ccxt.bybit({
"apiKey": "YOUR_BYBIT_KEY",
"secret": "YOUR_BYBIT_SECRET"
})
SM_KEY = "sm_your_key"
def smart_trade(symbol, side, amount):
# Először ellenőrizze a megerősítést
conf = requests.get(
"https://api.smartmoneyapi.com/v1/confirm",
params={"symbol": symbol, "direction": side},
headers={"X-API-Key": SM_KEY}
).json()
if conf["confidence"] not in ["HIGH", "MEDIUM"]:
print(f"Kihagyás {symbol} {side} — elégtelen bizalom.")
return None
adj_amount = amount * conf["size_mult"]
order = exchange.create_market_order(
f"{symbol}/USDT", side, adj_amount
)
print(f"Megrendelés leadva: {adj_amount} {symbol} {side}")
return order
Nézze meg a API állapotoldalt valós idejű állapotinformációkért, vagy használja a kapcsolatfelvételi űrlapunkat.