Smart Money API
Profesionální inteligenční API, které agreguje data o derivátech, on-chain metriky a aktivitu velrybích peněženek do jediného skóre důvěry pro váš trading bot.
https://api.smartmoneyapi.com/v1Principy návrhu
Čtyři myšlenky formují každý koncový bod a každé skóre, které toto API vrací. Jsou také upřímnými hranicemi toho, co slibuje — a co ne.
Strategie na prvním místě, ne signály. Toto není feed s nákupními/prodejními signály. Vy přinášíte strategii a vstup; API vám řekne, zda okolní struktura trhu — pozice v derivátech, funding, open interest, likvidace, on-chain flow a konsenzus velryb — souhlasí s obchodem, který již chcete provést.
Skórované důvěryhodnosti, ne binární předpovědi. Každá odpověď nese stupňované confidence (VYSOKÁ / STŘEDNÍ / NÍZKÁ) a composite od -1.0 do +1.0. Nejsou zde žádné záruky ani volání oracle — dostanete kalibrované čtení souhlasu s důvody, abyste mohli velikost přizpůsobit přesvědčení.
Podpora rozhodování, ne rady k provedení. API vrací doporučení POTVRDIT / SNÍŽIT / PŘESKOČIT a multiplikátor velikosti pro vaši logiku, na kterou můžete reagovat. Nikdy neumisťuje objednávky a nic zde není finanční radou. Zůstáváte zodpovědní za riziko, velikost a provedení.
Živé metriky, ne pevné záruky. Úspěšnost, statistiky režimů a údaje o přesnosti se počítají z pohyblivého vzorku a mění se s trhy. Publikujeme je upřímně, včetně případů, kdy jsou průměrné. Zacházejte s každou metrikou jako s aktuálním pozorováním, ne jako s příslibem budoucnosti.
Pro koho je toto API určeno
Toto API je určeno pro vývojáře crypto botů, algoritmů a AI agentů kteří již mají long/short signál — z TA strategie, ML modelu, Freqtrade pipeline, TradingView alertu nebo LLM agenta — a chtějí rychlé rozhodnutí POTVRDIT / SNÍŽIT / PŘESKOČIT před vložením kapitálu.
Typický cyklus: vaše strategie vydá "jdi long BTC" → zavoláte GET /v1/confirm?symbol=BTC&direction=long → potvrdíte, snížíte nebo přeskočíte vstup a upravíte velikost podle size_mult. Jedno volání, jediná nízkolatence JSON odpověď, žádná další infrastruktura.
Není to samostatný generátor signálů, produkt pro charting nebo místo provedení. Pokud nemáte vlastní signál k bránění, začněte na stránce výkonu abyste viděli, jak se skóre chovalo, než jej zapojíte do živého botu.
Získání přístupu
1 — Zaregistrujte se. Vytvořte si bezplatný účet na signup (e-mail/heslo nebo Google). Bez kreditní karty pro volnou úroveň.
2 — Otevřete svůj dashboard. Váš dashboard zobrazuje váš API klíč, aktuální plán a živé využití proti vašemu dennímu limitu.
3 — Zkopírujte svůj API klíč. Klíče mají předponu sm_. Předávejte jej jako X-API-Key hlavičku v každém požadavku (viz Autentizace). Vylepšete kdykoli na stránka s cenami pro zvýšení limitů a odemčení dalších symbolů a endpointů.
Specifikace, SDK & Kuchařka
Vše, co potřebujete pro rychlou integraci, ať už píšete kód sami nebo jej předáte kodérskému agentovi.
| Zdroj | Co to je |
|---|---|
| Kuchařka | Recepty pro nejčastější integrace — potvrďte před vstupem, zabezpečte Freqtrade signál, velikost podle multiplikátoru, zpracujte 402/429 a připojte jej ke kodérskému agentovi. |
| OpenAPI specifikace | Strojově čitelná definice OpenAPI každého endpointu. Importujte do Postman/Insomnia, generujte klienty nebo ji předáte LLM. github.com/tashiardit/smartmoneyapi-docs. |
| Python klient | Oficiální knihovna Python klienta na github.com/tashiardit/smartmoneyapi-python. |
| /llms.txt | LLM-přátelský souhrn API ve formátu prostého textu. Namiřte na něj Claude, Codex nebo Cursor (viz Kodérští agenti). |
Rychlý start za 2 minuty
Krok 1 — Základní URL. Každý endpoint se nachází pod:
Krok 2 — Získejte svůj API klíč. Zaregistrujte se zdarma (bez nutnosti kreditní karty) a zkopírujte svůj klíč z nástěnky. Předávejte jej jako X-API-Key hlavičku v každém požadavku.
Krok 3 — Váš první volání. Vložte toto do vašeho terminálu a nahraďte sm_your_key klíčem z vaší nástěnky:
Očekávaná odpověď:
"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 positive across all venues", "Whales: 67% long consensus"]
}
Když confidence je HIGH nebo MEDIUM a action je CONFIRM, škálujte velikost své pozice podle size_mult. To je celý integrační cyklus. Viz Pole odpovědi pro úplný odkaz na pole.
Autentizace
Všechny požadavky vyžadují API klíč předaný jako X-API-Key HTTP hlavička.
Váš API klíč je k dispozici na nástěnce po registraci. Uchovávejte svůj klíč v tajnosti — nezveřejňujte jej v klientském kódu nebo veřejných repozitářích.
/v1/ws/ticket s X-API-Key hlavičkou, pak se připojte s vráceným ticketem. Viz WebSocket autentizace (ticket).Google Sign-In (Firebase Auth)
Uživatelé se mohou autentizovat pomocí svého Google účtu přes Firebase Authentication. Po úspěšném přihlášení přes Google na klientovi vyměňte Firebase ID token za propojenou API relaci. Systém automaticky synchronizuje vaši Google identitu se systémem API klíčů.
Tělo požadavku
| Pole | Typ | Popis |
|---|---|---|
| id_tokenpovinné | řetězec | Firebase ID token získaný po přihlášení přes Google na klientovi |
Příklad odpovědi
"api_key": "sm_your_linked_key",
"uid": "firebase_uid_abc123",
"email": "[email protected]",
"plan": "trader",
"synced": true
}
Limity rychlosti
| Plán | Volání/Den | Limit nárazu | Zpoždění dat |
|---|---|---|---|
| Free | 50 | 2/min | 60 sekund |
| Trader | 1,000 | 20/min | Reálný čas |
| Pro | 5,000 | 60/min | Reálný čas |
| Enterprise | 100,000 | 400/min | Reálný čas |
Hlavičky omezení rychlosti jsou součástí každé odpovědi: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
Základní URL
Všechny níže uvedené koncové body jsou relativní k této základní URL. Všechny odpovědi jsou ve formátu JSON s Content-Type: application/json.
Chyby
Chyby používají standardní HTTP stavové kódy a konzistentní tělo JSON. Vždy větvěte na základě stavového kódu, nikoli textu odpovědi. Tři nejčastější chyby, na které narazíte:
| Stav | Kód | Význam & co dělat |
|---|---|---|
| 401 | unauthorized | Chybí nebo je neplatný API klíč. Zkontrolujte, zda je X-API-Key hlavička přítomna a správná. |
| 402 | payment_required | Koncový bod nebo symbol vyžaduje vyšší plán, než jaký má váš klíč (např. volání WebSocket firehose s bezplatným klíčem). Upgradujte nebo přejděte na veřejný koncový bod. |
| 429 | rate_limit_exceeded | Dosáhli jste denního nebo okamžitého limitu. Ustupte a zkuste to znovu po X-RateLimit-Reset; nedělejte to opakovaně. |
Každá chyba vrací stejný formát:
"error": "rate_limit_exceeded",
"message": "Dosáhli jste denního limitu 100 volání. Resetuje se v 00:00 UTC.",
"status": 429
}
Pro úplný seznam stavových kódů (400 / 403 / 500 / 503 a další) viz Kódy chyb. Robustní integrace zachází s 5xx a 429 jako s přechodnými (opakujte s backoffem) a s 401/402/403 jako s terminálními (opravte klíč nebo plán).
Osvědčené postupy zabezpečení
Posílejte klíč v hlavičce, nikoli v URL. Vždy předávejte X-API-Key jako HTTP hlavičku. Klíče v query string (?key=) se zaznamenávají proxy, load balancery a historií prohlížeče — zastaralé ?key= auth již není z tohoto důvodu na WebSocket koncových bodech akceptováno.
Uchovávejte klíče na straně serveru. Nikdy nevkládejte API klíč do klientského JavaScriptu, mobilní aplikace nebo veřejného repozitáře. Načtěte jej z proměnné prostředí nebo správce tajemství. Pokud dojde k úniku klíče, proveďte jeho rotaci.
Pravidelně rotujte klíče. Obnovte svůj klíč z dashboardu podle plánu a okamžitě, pokud máte podezření na jeho prozrazení. Starý klíč přestane fungovat v okamžiku vydání nového.
Používejte lístky pro prohlížečové sokety. Pro streamy v reálném čase z prohlížeče vyměňte svůj klíč za jednorázový lístek místo připojení s původním klíčem — viz WebSocket autentizace (lístky).
Použití s kódovacími agenty / LLM
Stavíte s Claude Code, Codex, Cursor nebo jakýmkoli LLM kódovacím agentem? Můžete agentovi předat vše, co potřebuje pro správné připojení k tomuto API, najednou. Jsou publikovány dva strojově čitelné odkazy:
| Zdroj | URL |
|---|---|
| Shrnutí pro LLM | https://smartmoneyapi.com/llms.txt |
| OpenAPI specifikace | github.com/tashiardit/smartmoneyapi-docs |
Namiřte svého agenta na soubor /llms.txt (konvence llms.txt) pro stručný přehled, poté na OpenAPI specifikaci pro přesné tvary požadavků/odpovědí. Jednořádkový prompt, který dobře funguje:
Přečtěte si https://smartmoneyapi.com/llms.txt a OpenAPI specifikaci na
github.com/tashiardit/smartmoneyapi-docs, pak přidejte předobchodní
kontrolu do mého bota, která volá GET /v1/confirm a přeskočí vstupy,
pokud akce není CONFIRM.
Podívejte se na Kuchařku pro zpracovaný recept pro kódovacího agenta.
Koncové body
GET /confirm
Hlavní koncový bod. Vrací složené skóre důvěry a doporučení akce pro daný směr obchodu. Voláno před vstupem do jakékoli pozice.
Pokrytí, jednoduše řečeno. /confirm momentálně skóruje BTC, ETH a SOL — symboly s dostatečnou historií pro spolehlivé potvrzení. Derivátový screener samostatně monitoruje ~519 derivátových trhů pro financování, OI a data o likvidacích, a sledování velryb pokrývá 600+ peněženek. Pro odemyká plný screener, exporty a širší pokrytí trhu; /confirm podpora symbolů je rozšiřována, jak každý trh nashromáždí spolehlivou historii.
Parametry
| Parametr | Typ | Popis |
|---|---|---|
| symbolpovinný | řetězec | Symbol aktiva. Jeden z: BTC, ETH, SOL (Trader+) |
| directionpovinný | řetězec | Směr obchodu: long nebo short |
| sourcevolitelný | řetězec | Štítek pro váš zdroj signálu (logováno pro analytiku). Max 32 znaků. |
Příklad požadavku
"https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"
Příklad odpovědi
"ts": 1710940821,
"symbol": "BTC",
"direction": "long",
"composite": 0.74,
"confidence": "HIGH",
"action": "CONFIRM_FULL",
"size_mult": 1.5,
deriv_score: 0.81,
onchain_score: 0.68,
whale_score: 0.73,
x_score: 0.0,
faktory: {
deriváty: { skóre: 0.81, váha: 0.40, vážené: 0.324 },
onchain: { skóre: 0.68, váha: 0.35, vážené: 0.238, zdroj: coinmetrics, dostupné: True },
velryba: { skóre: 0.73, váha: 0.25, faktor zastaralosti: 1.0, vážené: 0.183 }
},
úpravy: { shoda: 0.0, trend: 0.0, makro zprávy: 0.0 },
váhy: { deriváty: 0.40, onchain: 0.35, whale_intel: 0.25 },
pokrytí: { deriváty: True, velryba: True, onchain: True },
důvody: [
Funding rate pozitivní na všech platformách,
LSR favorizuje longy: 1.42,
Velryby: 67% dlouhý konsenzus,
MVRV nad 1.0 — on-chain býčí
]
}
Transparentní designem. Každá odpověď obsahuje factors objekt zobrazující každou část skóre × váha = vážený příspěvek, a adjustments objekt pro úpravy po filtrování, použité weights váhy, a coverage mapu. On-chain část používá skutečná volná data Coin Metrics (MVRV / exchange-flow / active-address), když není nastaven klíč Glassnode. Toto je multi-faktorový konfluence skóre — podpora rozhodování, ne garantovaná výherní míra.
Nesledované symboly jsou upřímné. Symbol mimo sledovaný derivátový/velrybí vesmír vrátí explicitní "confidence":"NO_DATA" / "action":"NO_DATA_SKIP" s "unsupported":true — nikdy nefabricovaný LOW.
Pole odpovědi
| Pole | Typ | Popis |
|---|---|---|
| ts | integer | Unix časové razítko výpočtu |
| symbol | string | Symbol aktiva (BTC/ETH/SOL) |
| směr | string | Požadovaný směr (long/short) |
| composite | float | Kompozitní skóre konfluence od -1.0 (extrémní proti) do +1.0 (silné potvrzení). Ne výherní míra. |
| base_composite | float | Kompozitní skóre před aplikací úprav po filtrování |
| confidence | string | HIGH / MEDIUM / LOW / VETO / NO_DATA |
| akce | string | CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP |
| size_mult | float | Navrhovaný multiplikátor velikosti pozice (např. 0.0 – 1.5) |
| unsupported | bool | true když symbol není v pokrytí (spárováno s NO_DATA) |
| deriv_score | float | Derivátové podskóre (-1 až 1) |
| onchain_score | float | On-chain podskóre (-1 až 1) |
| whale_score | float | Podskóre konsenzu velryb (-1 až 1) |
| x_score | float | X/sociální sentiment podskóre (-1 až 1); 0 když nepoužito |
| factors | object | Rozdělení podle částí: score × weight = weighted pro deriváty / onchain / velryby / x_sentiment (onchain zahrnuje source) |
| adjustments | object | Podepsané úpravy po filtrování (shoda, trend, rsi_1h, makro zprávy, momentum, čas dne, streak_decay) |
| weights | object | Skutečně použité váhy pro toto hodnocení |
| coverage | object | {derivatives, whale, onchain} — které části měly skutečná data |
| reasons | array | Lidsky čitelné vysvětlení skóre |
GET /snapshot
Vrací kompletní snímek trhu včetně všech podskóre, surových metrik a hodnot indikátorů pro daný symbol. Užitečné pro dashbordy a logování.
GET /onchain
Vrací nezpracované on-chain metriky: MVRV, SOPR, čistý tok na burzách, poměr realizované kapitalizace a klasifikaci pozice v cyklu.
GET /v1/derivatives/*
Křížový screener derivátů napříč 500+ symboly: heatmapa funding rate, žebříček otevřených pozic a detekce signálů poměru long/short. Prvních 10 řádků je veřejných; celý screener vyžaduje Obchodník nebo Pro. Endpointy: /v1/derivatives/screener, /v1/derivatives/funding, /v1/derivatives/oi, /v1/derivatives/signals.
GET /v1/options/*
Analytika BTC & ETH opcí z Deribitu (veřejné, bez autentizace): poměr put/call, max pain a otevřené pozice podle strike. Endpointy: /v1/options/summary, /v1/options/pcr, /v1/options/oi.
GET /v1/etf/*
Denní čisté toky a rozdělení podle fondů u spotových BTC & ETH ETF (veřejné). Endpointy: /v1/etf/flows, /v1/etf/funds.
GET /v1/historical/*
Historická data funding rate, otevřených pozic, poměru long/short (Binance) a OHLCV (CoinGecko) pro backtesting. Endpointy: /v1/historical/funding, /v1/historical/oi, /v1/historical/lsr, /v1/historical/ohlcv.
GET /v1/dex/*
Trendující páry, vyhledávání tokenů a detaily párů s využitím DexScreeneru (veřejné, bez autentizace). Endpointy: /v1/dex/trending, /v1/dex/search, /v1/dex/token, /v1/dex/pair.
GET /v1/news/*
Zpravodajská inteligence: politické/geopolitické/krypto zprávy klasifikované podle dopadu plus Fear & Greed (veřejné, bez autentizace). Endpointy: /v1/news/trump, /v1/news/general, /v1/news/impact, /v1/news/fear-greed.
GET /whales
Vrací data konsenzu velrybích peněženek: rozdělení long/short, celkovou nominální expozici, top 10 pozic (pouze Pro) a počet peněženek.
GET /signals
Vrací proud nejnovějších HIGH/MEDIUM signálů napříč všemi sledovanými aktivy. Užitečné pro skenování příležitostí.
GET /v1/strategies/*
Transparentní, read-only historie výkonů automatizovaných obchodních strategií, které se spouští na základě signálů Smart Money — včetně deriv40 strategie SmartMoney Copytrade (account=9). Všechny endpointy přijímají ?account=<id> query parametr a vracejí JSON. Není vyžadována autentizace (veřejná historie výkonů).
Endpointy
GET /v1/strategies/stats?account=9— hlavní metriky: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— křivka kapitálu pro grafické zobrazení:{ initial_equity, curve: [{ time, equity }] }.GET /v1/strategies/trades?account=9&limit=500— záznam uzavřených obchodů: pole (nebo{trades:[…]}) obsahujícísymbol,direction,entry_price,exit_price,pnl_usdt,pnl_percent,pnl_percent_net.GET /v1/strategies/active?account=9— aktuálně otevřené pozice: pole (nebo{positions:[…]}) obsahujícísymbol,side/direction,entry_price,unrealized_pnl.GET /v1/strategies/signals— rozdělení podle typu signálů zásobujících strategie (počet / výhry / úspěšnost / avg_pnl podle typu signálu).
Minulé výsledky nejsou zárukou budoucích výnosů. Údaje jsou zpětně doplněny za přibližně 3měsíční období plus živé obchody a jsou zobrazeny před poplatky, kde uvedeno.
GET /export
Stáhněte si historická data signálů ve formátu CSV pro backtesting. Parametry: symbol, from (unix ts), to (unix ts).
GET /health
Kontrola stavu systému. Vrací aktuálnost dat pro každý zdroj a celkový stav API. Není vyžadována autentizace.
"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
Vrací vaše aktuální statistiky využití API: volání dnes, měsíční celky, limity kvót a časy resetu.
POST /webhooks
Zaregistrujte HTTPS URL pro příjem událostí v reálném čase s podpisem, když se aktivuje signál u vašich sledovaných aktiv. Dodávky obsahují X-SmartMoney-Event hlavičku a HMAC-SHA256 podpis v X-SmartMoney-Signaturea opakují se až 3× s backoffem.
Request Body
| Field | Type | Description |
|---|---|---|
| urlrequired | string | HTTPS endpoint pro POST událostí (musí začínat https://) |
| eventsrequired | array | Názvy událostí, např. ["HIGH","MEDIUM","VETO"] nebo ["*"] |
| symbolsrequired | array | Symboly pro filtr, např. ["BTC","ETH"] nebo ["*"] |
| secretrequired | string | Váš podpisový klíč, ≥ 16 znaků (uloženo jako hash) |
Ověření podpisu
HMAC klíč je SHA-256 hex digest vašeho registrovaného klíče. Vypočítejte HMAC-SHA256 surového těla požadavku s tímto klíčem a porovnejte (v konstantním čase) proti X-SmartMoney-Signature. Viz Průvodce implementací webhooku.
Inteligence
GET /analysis
Vrací klasifikaci tržního režimu poháněnou AI s detekcí konfliktů signálů. Analyzuje shodu mezi signály, identifikuje rozdíly mezi deriváty, on-chain daty a daty velryb a vytváří souhrn v přirozeném jazyce s výhledovými rizikovými faktory a doporučením s časovým horizontem.
Parametry
| Parametr | Typ | Popis |
|---|---|---|
| symbolpovinný | string | Symbol aktiva: BTC, ETH, nebo SOL |
Příklad odpovědi
"ts": 1710940821,
"symbol": "BTC",
"regime": "late_cycle_divergence",
"regime_label": "Pozdní cyklus — Rozdílnost signálů",
"summary": "BTC je v pozdní fázi býčího cyklu s konfliktem mezi silou on-chain dat a přetažením derivátů. Velryby snižují expozici, zatímco LSR retailu roste.",
"signal_conflicts": [
"Skóre velryb medvědí, zatímco on-chain skóre býčí",
"Funding rate na 3měsíčním maximu — riziko squeeze"
],
"risk_factors": ["Vysoký funding", "Rozdílnost OI", "Redukce velryb"],
"recommendation": "Snižte dlouhou expozici, utáhněte stop-lossy. Vyhněte se novým longům nad aktuální cenou.",
"time_horizon": "4h–12h"
}
GET /liquidations
Vrací dva doplňující pohledy: (1) leverage-projected levels — odhad kde se nacházejí shluky likvidací; a (2) realized_heatmap — REAL provedené intenzita vynucených likvidací (cena × čas), agregovaná živě z veřejných WebSocket feedů burz: Binance, OKX, Bybit, Bitget, BitMEX. Heatmapa je přítomna, když stream má data pro symbol (chybí v velmi klidném trhu nebo těsně po startu).
Parametry
| Parametr | Typ | Popis |
|---|---|---|
| symbolvolitelný | string | Symbol aktiva (výchozí BTC). Reálná heatmapa pokrývá aktivně obchodované perp symboly. |
Příklad odpovědi
"symbol": "BTC",
"cascade_risk": "VYSOKÉ",
"nearest_long_liq_pct": -3.2,
"nearest_short_liq_pct": 4.1,
// REAL provedené likvidace — živě z 5 burz
"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, nejbližší vzdálenosti a realizované součty/podle strany. Pro plán: plný projected levels plus plný realized_heatmap (matice, shluky podle ceny, počty podle burzy). Projected odhad odpovídá na "kde jsou stop-lossy"; realizovaná heatmapa ukazuje "co bylo skutečně zlikvidováno."GET /liquidations/heatmap
Public price-level likvidační heatmapa. Vrací matici cena × času ve stylu Coinglassu REAL provedených vynucených likvidací, seskupených podle ceny, na které každá likvidace proběhla — agregovaných živě z veřejných WebSocket feedů burz: Binance, OKX, Bybit, Bitget, BitMEX. Pole clusters je praktický výstup: cenové intervaly seřazené podle likvidované hodnoty, každý označený dominantní stranou. Data závisí na živém streamu — velmi klidný symbol nebo právě restartovaná brána vrátí dobře formovanou prázdnou strukturu plus upřímné note. Zobrazené úrovně jsou vždy pouze reálné likvidace, nikdy odhadované.
Parametry
| Parametr | Typ | Popis |
|---|---|---|
| symbolvolitelný | string | Symbol aktiva (výchozí BTC). |
| window_minutesvolitelný | int | Look-back okno v minutách (výchozí 240, omezeno na 5–1440). |
| price_bucketsvolitelný | int | Počet cenových bucketů (výchozí 50, omezeno na 5–100). |
Příklad odpovědi
"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 je 0, clusters je prázdný, a pole note vysvětluje proč. Je to záznam provedených likvidací — nikoli předpověď. Pro odhad "kde jsou stop příkazy", použijte autentizovaný /liquidations endpoint.GET /liquidations/onchain
Provedené on-chain DeFi lending liquidace zachyceny přímo z našich vlastních lokálních BSC + Avalanche full nodů — nezávisle na jakémkoli trading botu. Pokrývá Venus/Cream a Moolah na BSC, a AAVE V3/V2, Benqi, BankerJoe, Granary a Vinium na Avalanche. Pro tier navíc vrací at_risk pozice (závislé na botu, mohou chybět).
Parametry
| Parametr | Typ | Popis |
|---|---|---|
| chainvolitelný | string | bsc nebo avax. Vynechte pro všechny chainy. |
| limitvolitelný | integer | Maximální počet řádků (výchozí 100, maximum 500). Nejnovější první. |
Příklad odpovědi
"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, splatit_usd_zname: 148230.55 } },
uzly: { bsc: { dostupne: True, hlavni_blok: 89173010, udalosti_celkem: 61 } }
}
}
GET /smart-stop
Vypočítá inteligentní úrovně stop-loss na základě aktuálního heatmapu likvidací, volatilních pásem a struktury trhu. Vrací doporučení na stupňované stopy a návrhy take-profitů kalibrované na vaši vstupní cenu a toleranci rizika.
Parametry
| Parametr | Typ | Popis |
|---|---|---|
| symbolpovinne | string | Symbol aktiva: BTC, ETH, nebo SOL |
| directionpovinne | string | Směr pozice: long nebo short |
| entry_pricevolitelne | float | Vaše vstupní cena. Výchozí je aktuální tržní cena, pokud není uvedena. |
| risk_pctvolitelne | float | Maximální přijatelné riziko jako % účtu. Výchozí: 2.0 |
Příklad odpovědi
symbol: BTC,
direction: long,
entry_price: 96420,
stops: {
tight: { price: 95100, note: Pod 1h strukturou. Nejlepší pro scalping. },
recommended: { price: 93800, note: Pod hlavním shlukem likvidací na $94K. Standardní swing stop. },
wide: { price: 91200, note: Pod 4h zónou poptávky. Stop pro pozici. }
},
avoid_zones: [
{ low: 94200, high: 94800, reason: Hustý shluk likvidací — vysoké riziko slippage }
],
take_profit_suggestions: [
{ tp1: 98500, tp2: 101000, tp3: 104200 }
]
}
recommended stop. Plán Pro: Všechny tři úrovně stop, avoid_zonesa kompletní návrhy take-profitů.GET /funding-arb
Identifikuje příležitosti pro arbitráž funding rate mezi burzami v reálném čase. Vrací seřazené příležitosti s odhadovaným ročním výnosem, optimálním párem burz a požadovanou hedžovací akcí k zachycení spreadu.
Parametry
| Parametr | Typ | Popis |
|---|---|---|
| min_spreadvolitelne | float | Minimální spread funding rate k zahrnutí (jako desetinné číslo). Výchozí: 0.01 |
| symbolvolitelne | string | Filtrovat na konkrétní aktivum. Vynechte pro skenování všech podporovaných aktiv. |
Příklad odpovědi
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
}
]
}
Volná veřejná varianta Bez autentizace
Veřejný endpoint bez klíče vrací top 10 příležitostí s živým screenerem mezi burzami, vhodný pro vložení nebo rychlé kontroly. Vynechává historii spreadu pro jednotlivé symboly a těžká pole a je servírován z 120sekundové cache. Pokud v okně čerstvosti neexistují žádné cross-exchange funding spreads, vrací prázdné opportunities pole s note — nikdy nefabricovaná data.
opportunities: [
{
symbol: OGN,
spread_pct: 0.297667,
annualized_apr: 325.95,
long_exchange: bybit,
short_exchange: hyperliquid,
estimated_profit_per_10k: 29.77,
risk_notes: Nízký spread — zajistěte, aby poplatky nezanikly marži arbitráže.
}
],
scanned_symbols: 222,
ts: 1783268753,
public: true,
limited: true
}
GET /smart-money/flow
Kvalitativně vážený index směru velryb na symbol, skórovaný -100 (peníze velryb směřují ke shortu) až +100 (směřují k longu). Vytvořeno z tisíců sledovaných peněženek velryb na Hyperliquid — každá vážena vlastní historickou úspěšností a PnL a upravena podle aktuálnosti. Toto je index pozicování, ne signál k nákupu/prodeji nebo predikce ceny. Symboly s malým počtem přispívajících peněženek jsou označeny thin a skórovány upřímně. Živá stránka: smart-money-flow.html.
Parametry
| Parametr | Typ | Popis |
|---|---|---|
| symbolvolitelné | řetězec | Jednotlivý symbol (např. BTC). Vynechte pro získání všech sledovaných symbolů seřazených podle |score|. |
| window_hoursvolitelné | celé číslo | Okno pro skórování, omezené na 1..168. Výchozí 24. |
Příklad odpovědi
symbols: [
{
symbol: SPX,
score: -90.93,
direction: strong_short,
n_wallets: 26,
long_usd: 184200.0, short_usd: 2410000.0,
quality_weighted: true,
sample_quality: rich,
top_contributors: [ { wallet: 0x31ca…974b, direction: short, value_usd: 5338.25, weight: 0.4948 } ]
}
],
window_hours: 24,
quality_weighted: true,
ts: 1783270000,
note: Kvalitativně vážený index směru pozicování velryb (-100..+100). Není to predikce ceny ani signál k nákupu/prodeji.
}
top_contributors. Váhy peněženek jsou omezeny na [0.25,1.0]; PnL je nerealizovaný proxy z nejnovějších snímků pozic.GET /v1/whales/crowding
Kombinovaný kontext pozicování velryb & přeplněnosti na symbol, sloučeno napříč Hyperliquid + GMX v2 + Jupiter Perps. Vrací hrubé/čisté nominální hodnoty, směrové zkreslení, počty peněženek a míst, koncentraci pozic (podíl top-3 + HHI), váženou průměrnou páku a bucket blízkosti likvidace (nominální hodnota v USD, která se nachází do 5% a 10% od odhadované likvidační ceny, rozděleno na long/short). Toto je kontext, ne směrový signál. Pole, která nelze odvodit, jsou null a zobrazí se jako — — např. lev_wavg/crowding_index když žádná pozice nese páku. Vzdálenosti likvidace jsou odhadem izolované marže (pct_to_liq ≈ 1/lev + upnl/notional − mmr, mmr = 0.01), ne ceny likvidace hlášené burzou.
Parametry
| Parametr | Typ | Popis |
|---|---|---|
| min_notionalvolitelné | desetinné číslo | Minimální kombinovaná hrubá nominální hodnota (USD) pro zařazení symbolu. Výchozí: 1000000. |
Příklad požadavku
Příklad odpovědi
ok: true, ts: 1783423500, min_notional: 1000000, n_symbols: 92,
symbols: [
{
symbol: BTC,
hrubý_usd: 2447900000.0, čistý_usd: -51000000.0, sklon: -0.021,
n_whales: 414, n_venues: 3,
venues: {
hl: { hrubý: 1900000000.0, čistý: -40000000.0, n_whales: 272 },
gmx: { hrubý: 320000000.0, čistý: -6000000.0, n_whales: 59 },
jupiter: { hrubý: 227900000.0, čistý: -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: [ Vzdálenosti likvidace jsou odhady pro izolovanou marži, nikoli údaje od burz. ]
}
skew je net/gross ∈ [-1,1]; crowding_index = |skew|·conc_top3·min(lev/20,1). V seznamu se zobrazují pouze skutečně přítomné burzy. venues. Pozice bez páky jsou z likvidačních košů vyloučeny, nikoli předpokládány. Anonymní volající obdrží 10 největších symbolů podle hrubého objemu (s gated: true); uživatelé Trader+ obdrží celý seznam.GET /v1/options/gex
Dealer gamma exposure (GEX) analýzy pro BTC & ETH, počítané v reálném čase z veřejného řetězce opcí Deribit (bez ověření). Vrací čistý GEX dealerů na strike (konvence SpotGamma dealer-short), úroveň gamma-flip (strike, kde kumulativní čistý GEX překročí nulu), termínovou strukturu IV (ATM implikovaná volatilita podle dnů do expirace) a skew frontální expirace IV skew (25Δ-proxy risk reversal). Režim GEX je positive (dealeři long gamma → potlačující volatilitu) nebo negative (zesilující volatilitu). Plně samostatné – přepočítává se při každém volání, bez závislosti na databázi.
Parametry
| Parametr | Typ | Popis |
|---|---|---|
| symbolvolitelné | string | BTC nebo ETH pouze. Výchozí: BTC. |
Příklad požadavku
Příklad odpovědi
"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 },
{ "strike": 65000, "net_gex": 4800000.0 }
],
"term_structure": [
{ "expiry": "8JUL26", "dte": 0.76, "atm_iv": 62.1 },
{ "expiry": "27MAR26", "dte": 14.2, "atm_iv": 58.4 }
],
"skew": {
"expiry": "8JUL26", "dte": 0.76,
"put_iv": 69.69, "atm_iv": 62.1, "call_iv": 55.34,
"risk_reversal": 14.35, "bias": "downside_fear"
}
}
available: false s prázdnými panely – nikdy nefabricované GEX. IV skew používá pevný proxy ±10% strike pro 25Δ (skutečný 25-delta vyžaduje řešení delty na strike); vhodné pro zobrazení, dokumentováno jako aproximace.GET /v1/liquidations/simulate
Interactive test odolnosti proti kaskádové likvidaci. Na základě hypotetického pohybu ceny vrátí odhadované pákové pozice, které by byly zlikvidovány, nucený objem podle cenové hladiny / strany / burzy a výstup hloubky kaskády. Sestupný pohyb likviduje dlouhé pozice , jejichž likvidační cena je na/výše cíle; vzestupný pohyb likviduje krátké pozice , jejichž likvidační cena je na/pod ní. Spojeny jsou dvě nezávislé metody: přesné likvidační ceny ze sledovaných velryb Hyperliquid reálné pákového efektu/vstupu, plus statistické shluky pásem OI podle burzy (pákový efekt davu odvozený z financování). Vše je jasně označeno estimated: true — nemůže znát marži na účet, křížovou vs izolovanou, přidanou marži nebo ADL.
Parametry
| Parametr | Typ | Popis |
|---|---|---|
| symbolvolitelné | řetězec | Symbol aktiva. Výchozí: BTC. |
| move_pctvolitelné | desetinné číslo | Hypotetický pohyb ceny v procentech (záporné = dolů, kladné = nahoru). Výchozí: -5. |
Příklad požadavku
Příklad odpovědi
"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": true, "coverage_hours": 17.8, "by_side_24h": { "long": 6100000.0, "short": 2400000.0 } },
"methodology": { "disclaimer": "Odhadované — nemůže znát marži na účet, křížovou vs izolovanou, přidanou marži nebo ADL." }
}
ok: true, empty: true srozumitelnou zprávu, nikoli falešné sloupce. realized_context je mladý, rostoucí vzorek z živého proudu nucených likvidací, zobrazený pouze jako kontext — nikdy nečiní projekci „realizovanou“.GET /v1/wallet/{addr}/profile
Meziplatformový profil peněženky postavený výhradně z živých snímků pozic sledovaných velryb. Pro sledovanou velrybu Hyperliquid vrátí aktuální otevřené pozice, časovou řadu nerealizovaného PnL / expozice / počtu pozic časová řada, časovou osu aktivit OPEN/CLOSE/FLIP časová osa aktivit (rekonstruovaná porovnáním po sobě jdoucích snímků), dekódovaný štítek HL-leaderboardu a souhrn otevřené knihy. Živá stránka: wallet-profiler.html.
Parametry
| Parametr | Typ | Popis |
|---|---|---|
| addrpovinné | řetězec | Adresa peněženky (segment cesty), např. /v1/wallet/0x3bcae23e…/profile. |
| daysvolitelné | celé číslo | Okno zpětného pohledu pro řadu a časovou osu. Výchozí: 30. |
Příklad požadavku
Příklad odpovědi
"ok": true, "wallet": "0x3bcae23e…", "tracked": true,
"first_seen_ts": 1782827733, "latest_snapshot_ts": 1783418468, "as_of": 1783418468,
"hyperliquid": {
"label": { "name": "Andre is back", "score": 74,
"window_pnl_usd": 1307000, úspěšnost_v_%: 71, obchody: 42 },
pozice: [
{ místo: hyperliquid, symbol: ETH, směr: short,
velikost: 1200.0, vstupní_cena: 1800.0, nerealizovaný_zisk/ztráta: 34800.0,
páka: 20.0, hodnota_usd: 2160000.0 }
],
série: [ { časová_značka: 1783330000, nerealizovaný_zisk/ztráta: 42000.0, expozice_usd: 18400000.0, pozice: 5 } ],
časová_osa: [ { časová_značka: 1783400000, událost: přechod, symbol: ETH,
směr: short, ze_směru: long, hodnota_usd: 2160000.0 } ],
souhrn: {
otevřené_pozice: 5, v_zisku: 3, ve_ztrátě: 2, longy: 0, shorty: 5,
celkový_nerealizovaný_zisk/ztráta: -12000.0, celková_expozice_usd: 21000000.0, smíšená_páka: 19.9,
okno_dní: 30, snímky_v_okně: 474,
realizovaný_zisk/ztráta: None, poznámka_k_realizovanému_zisku/ztrátě: Nedá se odvodit — vidíme pouze otevřené snímky, nikdy uzavírací plnění.
}
}
}
pnl je HL vlastní nerealizované ocenění trhem, value_usd je otevřené nominální. Realizovaný zisk/ztráta za každý cyklus není dostupný (vidíme pouze otevřené snímky, nikdy uzavírací plnění) a je zobrazen jako null / —; události CLOSE na časové ose nenese žádný nárok na zisk/ztrátu. Platná, ale nesledovaná adresa vrátí tracked: false s poznámkou; neplatná adresa vrátí ok: false, error: "invalid_address" (HTTP 400). Štítek HL-leaderboard je HL vlastní okno při objevení, nepočítáno námi.GET /flows
Vrací data o kapitálových tocích mezi aktivy, které ukazují vzorce rotace mezi BTC, ETH a SOL v různých časových oknech. Užitečné pro identifikaci, které aktivum akumuluje kapitál a které je distribuováno v daném okamžiku.
Příklad odpovědi
časová_značka: 1710940821,
toky: {
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 }
},
detekované_rotace: [
Kapitál rotuje z ETH do BTC v okně 4h,
Akumulace SOL je konzistentní ve všech oknech
]
}
GET /whale-events
Vrací významné změny pozic velryb — otevření, uzavření a změny směru — detekované napříč sledovanými peněženkami a on-chain adresami v rámci zadaného zpětného okna.
Parametry
| Parametr | Typ | Popis |
|---|---|---|
| symbolvolitelné | řetězec | Filtrovat podle aktiva. Vynechte pro všechna sledovaná aktiva. |
| významnostvolitelné | řetězec | Filtrovat podle významnosti události: high, medium, nebo all. Výchozí: all |
| hodinyvolitelné | celé_číslo | Zpětné okno v hodinách. Výchozí: 24 |
Příklad odpovědi
symbol: BTC,
souhrn: {
přechody_na_long: 3,
přechody_na_short: 1,
nová_otevření: 7,
uzavření: 2
},
události: [
{
typ: převrátit_long,
peněženka: 0xWhale...a4f2,
směr: long,
size_usd: 4200000,
ts: 1710938400
}
]
}
summary pouze objekt. Plán Pro: Úplný events feed s identifikátory peněženek, velikostmi a časovými razítky.GET /regimes/history
Vrací historická data klasifikace režimů pro dané aktivum. Použijte to k backtestování, jak se konkrétní typy režimů chovaly historicky, jak dlouho každý typ režimu obvykle trvá a jak se přechody mezi režimy vyvíjejí v čase.
Parametry
| Parametr | Typ | Popis |
|---|---|---|
| symbolvolitelné | string | Symbol aktiva. Výchozí: BTC |
| regimevolitelné | string | Filtrovat na konkrétní typ režimu, např. late_cycle_divergence. Vynechte pro všechny režimy. |
| daysvolitelné | integer | Okno zpětného pohledu ve dnech. Výchozí: 30. Maximálně: 365 |
Příklad odpovědi
"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 k ověření strategických předpokladů proti historickým datům výkonnosti režimů.GET /exchange-health
Vrací stav zdraví všech sledovaných burz v reálném čase včetně latence na burzu, míry chyb a indikátorů zastaralosti dat. Není vyžadováno ověření — veřejně přístupný endpoint.
Příklad odpovědi
"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
Vrací index strachu a chamtivosti (0-100) vypočítaný z sentimentu derivátů, aktivity velryb, volatility a sociálních signálů v reálném čase. Zahrnuje rozložení komponent a 24hodinovou historii pro analýzu trendů.
Parametry
| Parametr | Typ | Popis |
|---|---|---|
| symbolvolitelné | string | Symbol aktiva. Výchozí: BTC |
Příklad odpovědi
"symbol": "BTC",
"score": 72,
"label": "Chamtivost",
"components": {
"volatilita": 65,
"momentum": 78,
"deriváty": 70,
"whale_activity": 75,
"sociální": 68
},
"historie_24h": [
{ "ts": 1710940800, "score": 68, "label": "Chamtivost" },
{ "ts": 1710937200, "score": 65, "label": "Chamtivost" }
],
"ts": 1710940821
}
Integrace
GET /tradingview/setup
Vrátí vaše personalizované nastavení integrace TradingView: webhook URL, tajný klíč pro validaci a připravené Pine Script indikátory, které se přímo připojují k Smart Money API. Zkopírujte a vložte Pine Script do TradingView, aby se naše signály zobrazovaly na jakémkoli grafu.
Příklad odpovědi
"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
Přijímá alert z TradingView, zpracuje jej přes /confirma vrací potvrzení. TradingView nemůže odesílat vlastní hlavičky, takže autentizujte zahrnutím vašeho webhooku secret do JSON těla (tento endpoint nepoužívá X-API-Key). Odpověď obaluje potvrzení a přidává nejvyšší úroveň action z CONFIRMED (daemon confidence HIGH/MEDIUM) nebo VETOED.
Tělo požadavku
"secret": "your_webhook_secret",
"symbol": "BTC",
"direction": "long",
"timeframe": "1h",
"strategy": "EMA crossover",
"price": 67500.0
}
Vyžadováno: secret, symbol, direction (long|short). Volitelné: source, timeframe, strategy, price.
Personalizace
GET /preferences
Vrátí vaše aktuální personalizované nastavení včetně výchozích parametrů obchodování, rizikového profilu, watchlistu a preferencí notifikací.
Aktualizujte preference odesláním JSON těla s libovolnou podmnožinou níže uvedených polí. Vynechaná pole si zachovají své aktuální hodnoty.
Pole preferencí
| Pole | Typ | Popis |
|---|---|---|
| default_trade_size_usd | float | Výchozí velikost pozice v USD pro výpočty Kelly a smart-stop |
| risk_tolerance | string | conservative, moderate, nebo aggressive |
| default_risk_pct | float | Výchozí riziko na obchod jako % účtu. Použito /smart-stop když risk_pct je vynecháno |
| watchlist | array | Seřazený seznam symbolů aktiv, např. ["BTC","ETH","SOL"] |
| notification_email | string | Emailová adresa pro doručování alertů |
| timezone | string | IANA časové pásmo, např. America/New_York |
"default_trade_size_usd": 5000,
"risk_tolerance": "střední",
"default_risk_pct": 1.5,
"watchlist": ["BTC", "ETH", "SOL"]
}
GET /watchlist
Vrací snímek stavu potvrzení a klíčové metriky rizika pro všechny symboly ve vašem nastaveném watchlistu. Poskytuje přehled více aktiv bez nutnosti volat /confirm pro každý symbol zvlášť.
Příklad odpovědi
"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"
}
]
}
Streamování v reálném čase (Live Swaps)
Streamujte swapy na DEX v hodnotě ≥ $500 detekované v reálném čase z našich vlastních uzlů BSC a Avalanche. K dispozici jsou dva přenosy: veřejný stream Server-Sent Events (SSE) pro bezplatné/browserové klienty a nízkolatenční WebSocket firehose pro placené úrovně. Události jsou vysílány během několika sekund po zařazení do bloku.
Veřejný SSE Stream (Zdarma)
Není vyžadována autentizace. Nativní EventSource podpora ve všech moderních prohlížečích. Server vysílá swap události a periodické heartbeat zprávy k udržení spojení.
es.addEventListener("swap", e => {
const swap = JSON.parse(e.data);
console.log(swap.chain, swap.pair, swap.amount_usd);
});
WebSocket Firehose (Placené)
Autentizace (doporučeno): nikdy nevkládejte svůj dlouhodobý klíč do URL — je logován proxy a ukládán do historie prohlížeče. Místo toho odešlete svůj klíč pomocí POST na /v1/ws/ticket pomocí bezpečné X-API-Key hlavičky, poté otevřete socket s vráceným jednorázovým ticket (platný ~60s, použije se jednou). Klienti na straně serveru, kteří mohou nastavit hlavičky, mohou místo toho předat X-API-Key přímo při handshake. Klíče z bezplatné úrovně obdrží 402 payment_required odpověď. Rámec hello je odeslán při připojení s vaší úrovní a prahovou hodnotou vysílání.
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. Otevřete socket s jednorázovým ticketem
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 autentizace (tickety)
Proč: nikdy nevkládejte svůj API klíč do URL WebSocketu — query stringy jsou logovány proxy, load balancery a ukládány do historie prohlížeče. Místo toho vyměňte svůj klíč za krátkodobý, jednorázový ticket pomocí normálního autentizovaného POST, poté se připojte s tímto ticketem.
Postup: POST na /v1/ws/ticket s vaší X-API-Key hlavičkou → obdržíte { "ticket": "…", "expires_in": 60 }. Poté otevřete wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=<ticket>. The ticket is jednorázový a vyprší za ~60 sekund. Klientské aplikace na straně serveru, které mohou nastavit hlavičky požadavků, mohou místo toho předat X-API-Key přímo při handshake WebSocket — není potřeba ticket.
Vytvoří jednorázový ticket pro autentizované handshake WebSocket. Autentizujte pomocí X-API-Key hlavičky (váš klíč nikdy neopustí hlavičky požadavku). Vrácený ticket lze uplatnit jednou na /v1/ws/live-swaps před jeho expirací.
"https://api.smartmoneyapi.com/v1/ws/ticket"
Příklad odpovědi
"ticket": "wst_9f3c1a8e4b2d…",
"expires_in": 60
}
Pole odpovědi
| Pole | Typ | Popis |
|---|---|---|
| ticket | string | Jednorázový token, který se připojí jako ?ticket= na URL WebSocket. Uplatní se jednou, poté se zneplatní. |
| expires_in | number | Sekundy do expirace ticketu (~60). Vytvořte nový ticket pro každý pokus o připojení. |
Poznámka: zastaralé ?key= ověřování pomocí query-param je již není přijímáno na WebSocket koncových bodech z bezpečnostních důvodů. Použijte ticket (pro klientské aplikace v prohlížeči) nebo X-API-Key handshake hlavičku (pro klientské aplikace na straně serveru).
REST Snapshot
Vrátí posledních N broadcastovaných swapů z rolling bufferu. Užitečné pro první vykreslení na dashboardech před otevřením streamového připojení. Také dostupné: /v1/live-swaps/status pro statistiky broadcasteru.
Schéma události
| Pole | Typ | Popis |
|---|---|---|
| chain | string | bsc nebo avalanche |
| dex | string | Název routeru (např. pancakeswap_v2, traderjoe) nebo unknown_dex |
| swapper | string | Plná 0x adresa peněženky, která provedla swap |
| swapper_short | string | Zkrácená forma pro zobrazení (např. 0xb300…028d) |
| swapper_url | string | Přímý odkaz na swapper v block exploreru řetězce |
| tx_hash | string | Hash transakce |
| explorer_url | string | Přímý odkaz na transakci na BscScan / Snowtrace |
| token_in | string | Symbol tokenu prodaného (např. USDT) |
| token_out | string | Symbol tokenu zakoupeného |
| amount_usd | number | USD hodnota swapu (minimum: $500) |
| pair | string | Formátovaný popis páru (např. USDT → USDC) |
| block | number | Číslo bloku, ve kterém byl swap vytěžen |
| timestamp | number | Unix epoch sekundy |
| significance | string | low / medium / high / critical na základě USD velikosti |
| seq | number | Monotonní číslo broadcast sekvence — použijte pro detekci mezer |
POST /alerts/conditions
Vytvořte vlastní pravidla upozornění, která se aktivují, když zadaná metrika překročí práh. Upozornění jsou doručována přes webhook, e-mail nebo feed oznámení na dashboardu podle vašich preferencí.
Vrátí seznam všech vašich nakonfigurovaných podmínek upozornění s jejich ID, definicemi a aktuálním stavem.
Trvale odstraní podmínku upozornění podle jejího ID.
Vrátí nedávné události spuštění upozornění s časovými razítky, odpovídajícími podmínkami a hodnotou metriky v době spuštění.
Vytvořit upozornění — Tělo požadavku
| Pole | Typ | Popis |
|---|---|---|
| namepovinné | string | Popisek výstrahy srozumitelný pro člověka (max 64 znaků) |
| metricrequired | string | Metrika k monitorování. Viz tabulka dostupných metrik níže. |
| symboloptional | string | Kontext aktiva. Vyžadováno pro metriky vázané na symbol, jako je funding_rate. |
| operatorrequired | string | Porovnávací operátor: gt, lt, eq, crosses_above, crosses_below |
| thresholdrequired | float | Číselná hodnota pro porovnání metriky |
| deliveryoptional | string | Doručovací kanál, např. telegram (default) nebo webhook |
| cooldown_minutesoptional | integer | Minimální počet minut mezi opětovnými spuštěními (výchozí 60) |
Aktuální seznam platných metrik a operátorů je vrácen GET /v1/alerts/conditions jako available_metrics a available_operators.
Dostupné metriky
| Metrika | Popis |
|---|---|
| funding_rate | Aktuální funding rate pro symbol (jako desetinné číslo) |
| global_lsr | Globální poměr long/short pro symbol |
| long_pct | Procento účtů s čistou dlouhou pozicí pro symbol |
| top_trader_lsr | Poměr long/short top traderů pro symbol |
| taker_ratio | Poměr nákupu/prodeje takerů pro symbol |
| mvrv | Poměr tržní hodnoty k realizované hodnotě (BTC/ETH) |
| sopr | Poměr zisku utracených výstupů (BTC/ETH) |
| exchange_net_flow | Signál čistého toku na burze (on-chain) |
| accumulation | Signál akumulace (on-chain) |
| whale_long_pct | Procento sledovaných velrybích peněženek s dlouhými pozicemi pro symbol |
| whale_n_wallets | Počet sledovaných velrybích peněženek s pozicí v symbolu |
| composite_long | Kompozitní skóre pro symbol dotazované v dlouhém směru |
| composite_short | Kompozitní skóre pro symbol dotazované v krátkém směru |
| funding_spread | Cross-venkovní funding spread pro symbol |
"name": "BTC funding rate spike",
"metric": "funding_rate",
"symbol": "BTC",
"operator": "gt",
"threshold": 0.05
}
GET /kelly
Vrací doporučení pro velikost pozice podle Kellyho kritéria, kalibrovaná na historickou výkonnost signálu pro daný symbol, úroveň spolehlivosti a směr. Zakládá velikost pozice na empirických úspěšnostech, aby se předešlo nadměrnému využití páky.
Parametry
| Parametr | Typ | Popis |
|---|---|---|
| symbolrequired | string | Symbol aktiva: BTC, ETH, nebo SOL |
| confidenceoptional | string | Úroveň spolehlivosti signálu k modelování: HIGH, MEDIUM, nebo LOW. Výchozí: HIGH |
| directionoptional | string | Směr obchodu: long nebo short. Výchozí: long |
| account_sizeoptional | float | Velikost účtu v USD pro výpočet suggested_size_usd. Výchozí: 10000 |
Příklad odpovědi
"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": "Half-Kelly doporučeno pro živé obchodování kvůli odhadované chybě."
}
GET /performance
Vrací historické statistiky přesnosti signálů vydaných API, rozdělené podle úrovně důvěry. Užitečné pro pochopení spolehlivosti signálů před nasazením kapitálu.
Parametry
| Parametr | Typ | Popis |
|---|---|---|
| symbolvolitelné | string | Filtrovat podle aktiva. Vynechte pro agregované statistiky napříč všemi symboly. |
| daysvolitelné | integer | Okno zpětného pohledu ve dnech. Výchozí: 30 |
Příklad odpovědi
"symbol": "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 }
}
}
Statistiky & Signály
GET /v1/stats
Celostránkové upřímné statistiky výkonu získané z smart_money_confirm výsledků různých volání. Vrací míru úspěšnosti na úrovních HIGH a MEDIUM důvěry, celkovou přesnost, profit faktor a rozpis podle symbolu. Všechny údaje jsou vzorkované v rámci hodnotícího okna; konzultujte calibration.html pro kontext a metodologii forward-holdout.
Příklad odpovědi
"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": "různá potvrzovací volání, výsledky vyřešené za 24h",
"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 je jediné číslo získané z dat, která hodnotitel nikdy neviděl — sledujte jeho růst v čase. Viz calibration.html pro úplnou metodologii a hranici mezi vzorkováním a forward-testem.GET /v1/signals/performance
Sledování výsledků signálů napříč více horizonty rozlišení (4h, 12h, 24h, 72h). Vrací míru úspěšnosti podle horizontu, celkový počet signálů a rozpis podle typu signálu.
Parametry
| Parametr | Typ | Popis |
|---|---|---|
| daysvolitelné | integer | Okno zpětného pohledu ve dnech. Výchozí: 30 |
| signal_typevolitelné | string | Filtrovat podle typu, např. smart_money_confirm nebo regime_flip. Vynechte pro všechny typy. |
| symbolvolitelné | string | Filtrovat podle symbolu aktiva, např. BTC. Vynechte pro agregaci napříč všemi symboly. |
Příklad odpovědi
"signal_type": "smart_money_confirm",
"symbol": "BTC",
"days": 30,
"total_signals": 48,
horizonty: {
4h: { úspěšnost: 0.65, vyřešeno: 46 },
12h: { úspěšnost: 0.61, vyřešeno: 44 },
24h: { úspěšnost: 0.58, vyřešeno: 40 },
72h: { úspěšnost: 0.54, vyřešeno: 32 }
},
typ_rozložení: {
smart_money_confirm: { počet: 35, úspěšnost_24h: 0.61 },
regime_flip: { počet: 13, úspěšnost_24h: 0.47 }
}
}
GET /v1/signals/recent
Přehled nedávno publikovaných signálů HIGH a MEDIUM napříč všemi sledovanými symboly. Každá položka obsahuje typ signálu, úroveň důvěry, směr a stav vyřešení, pokud je dostupný.
Příklad odpovědi
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
Výsledek vyřešení pro jednotlivý signál podle jeho číselného ID. Vrací úspěch/neúspěch pro každý horizont vyřešení (4h, 12h, 24h, 72h) spolu s cenou v době signálu a při vyřešení.
Parametry
| Parametr | Typ | Popis |
|---|---|---|
| idrequired | integer | ID signálu (segment cesty), např. /v1/signals/1042/outcome |
Příklad odpovědi
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
Rozložení úspěšnosti confirm-signal pro vlastní API klíč přihlášeného uživatele. Vrací úspěšnost pro jednotlivé úrovně důvěry, profit faktor a údaje podle symbolu. Vyžaduje platný X-API-Key hlavičku.
Příklad požadavku
"https://api.smartmoneyapi.com/v1/confirm-winrate"
Příklad odpovědi
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
Neměnný, pouze připojovací osobní záznam rozhodnutí. Odešlete svá obchodní rozhodnutí před nebo po jejich provedení; systém vypočítá confirm skóre vůči Smart Money engine a přidá trvalý záznam. Použijte jej k vytvoření časově označeného záznamu o tom, jak dobře se signál API shodoval s vašimi vstupy — zcela nezávisle na globálním poolu win-rate. Odpovědi úrovní Free a Trader mají pole evidence odstraněna; Pro vrací úplný rozklad. Pro úroveň Free platí zpoždění.
Odeslat rozhodnutí. Idempotentní na Idempotency-Key request header — opětovné odeslání stejného klíče vrátí existující záznam bez vytvoření duplikátu. Systém okamžitě volá confirm engine a připojí výsledek jako neměnný záznam v knize.
Request Body
| Pole | Typ | Popis |
|---|---|---|
| symbolrequired | string | Symbol aktiva, např. BTC |
| siderequired | string | Směr obchodu: long or short |
| strategy_idoptional | string | Uživatelem definovaný štítek strategie (max 64 znaků). Ukládá se tak, jak je, pro účely seskupování a filtrování. |
Example Request
-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"
Example Response
"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 pole evidence. Pro vrací úplný rozklad confirm. Pro úroveň Free platí zpoždění — záznam je zapsán okamžitě, ale confirm skóre může odrážet data z cache stará až 60 sekund.Zobrazí vaše vlastní shadow-gate rozhodnutí, od nejnovějších. Rozsah omezen na vlastníka — vrací pouze rozhodnutí odeslaná vaším API klíčem.
Parameters
| Parametr | Typ | Popis |
|---|---|---|
| limitoptional | integer | Maximální počet vrácených záznamů. Výchozí: 50, max: 200 |
| cursoroptional | string | Neprůhledný kurzor stránkování z předchozí odpovědi z pole next_cursor . Pro první stránku vynechejte. |
Example Response
"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, rozhodnutí: SKIP, důvěra: LOW, kompozitní: -0.12, size_mult: 0.0, ts: 1710937000, vyřešeno: True }
],
počet: 2,
next_cursor: None
}
Jednotlivé rozhodnutí podle ID, včetně úplných potvrzujících důkazů pro úroveň Pro. Odpovědi pro úrovně Free a Trader mají factors a adjustments odstraněny. Vrací 403 pokud rozhodnutí patří k jinému API klíči.
Příklad odpovědi (Pro)
id: 318,
symbol: BTC,
strana: long,
strategy_id: ema_crossover,
rozhodnutí: CONFIRM,
důvěra: HIGH,
kompozitní: 0.74,
size_mult: 1.5,
faktory: {
deriváty: { skóre: 0.81, váha: 0.40, vážené: 0.324 },
onchain: { skóre: 0.68, váha: 0.35, vážené: 0.238 },
velryba: { skóre: 0.73, váha: 0.25, vážené: 0.183 }
},
ts: 1710940821,
vyřešeno: False,
výsledek: None
}
Ručně vyřešte výsledek rozhodnutí. Zavolejte toto po uzavření obchodu, abyste zaznamenali konečný výsledek proti řádku v knize. Jakmile je vyřešeno, řádek je neměnný a nelze jej znovu změnit.
Tělo požadavku
| Pole | Typ | Popis |
|---|---|---|
| výsledekpovinné | řetězec | Výsledek obchodu: win nebo loss |
| exit_pricevolitelné | float | Výstupní cena obchodu. Ukládá se pro referenci; použito k výpočtu P&L %, pokud je poskytnuto. |
| pnl_pctvolitelné | float | Realizované P&L jako procento velikosti pozice, např. 3.5 nebo -1.2 |
Příklad odpovědi
id: 318,
vyřešeno: True,
výsledek: win,
exit_price: 65800.0,
pnl_pct: 4.1,
resolved_at: 1711027200
}
Chybové kódy
| Stav | Kód | Popis |
|---|---|---|
| 400 | invalid_params | Chybějící nebo neplatné parametry dotazu |
| 401 | unauthorized | Chybějící nebo neplatný API klíč |
| 403 | plan_restriction | Koncový bod není dostupný ve vašem aktuálním plánu |
| 429 | rate_limit_exceeded | Denní nebo okamžitý limit dosažen |
| 500 | internal_error | Chyba serveru — zkontrolujte /health pro stav zdroje |
| 503 | data_stale | Zdroj dat není dostupný; vráceno s posledními známými daty |
Příklady kódu
Python
r = requests.get(
https://api.smartmoneyapi.com/v1/confirm,
params={symbol: BTC, direction: 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()
# Ve vaší obchodní smyčce:
signal = confirm_trade("BTC", "long")
if signal["confidence"] not in ["HIGH", "MEDIUM"]:
print("Přeskočení - nedostatečná důvěra")
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 chyba: ${resstatus}`);
return res.json();
}
// Použití
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"
# Získání dat o velrybách
curl -X GET \
-H "X-API-Key: sm_your_key" \
"https://api.smartmoneyapi.com/v1/whales?symbol=BTC"
# Kontrola využití
curl -X GET \
-H X-API-Key: sm_your_key \
https://api.smartmoneyapi.com/v1/usage
Integrace Freqtrade
Přidejte potvrzení Smart Money do jakékoli strategie Freqtrade přepsáním confirm_trade_entry metody.
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 # Přeskočit kontrolu pro nepodporované
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 # Při chybě API povolit obchod
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):
# Nejprve zkontrolujte potvrzení
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"Přeskakuji {symbol} {side} — nedostatečná důvěra.")
return None
adj_amount = amount * conf["size_mult"]
order = exchange.create_market_order(
f"{symbol}/USDT", side, adj_amount
)
print(f"Objednávka zadána: {adj_amount} {symbol} {side}")
return order
Zkontrolujte stránku stavu API pro aktuální informace o stavu, nebo použijte náš kontaktní formulář.