Tržní data
Nástroj
search_coins
Převede coin nebo token z volně zadaného názvu či symbolu na jeho kanonický slug, s hodnoceným tržním souhrnem u každé shody. Vstupní bod: každý další coinový nástroj se adresuje slugem.
| Parametr |
Typ |
Popis |
query
povinné
|
string |
Volně zadaný text porovnávaný s názvy a symboly coinů. |
type
|
enum |
Omezí shody: coin nebo token. |
limit
|
integer |
Maximum vrácených shod (1–50, výchozí 10). |
Nástroj
get_coin
Kompletní profil jednoho coinu: nabídky, pořadí a jeho změny, historické maximum/minimum a vzdálenost od nich, plně zředěná valuace, odkazy, kontrakty a popis.
| Parametr |
Typ |
Popis |
slug
povinné
|
string |
Kanonický slug coinu, např. bitcoin. |
Nástroj
get_prices
Aktuální spotové ceny až 100 coinů v jednom volání, volitelně převedené do fiat měny. Nejlevnější způsob, jak odpovídat na cenové dotazy — vyžaduje se právě jeden selektor.
| Parametr |
Typ |
Popis |
slugs
|
string |
Slugy coinů oddělené čárkami — preferovaný selektor. |
symbols
|
string |
Ticker symboly oddělené čárkami; nejednoznačné symboly se převedou na shodu s nejvyšším pořadím. |
ids
|
string |
Číselná Bitculator id coinů oddělená čárkami. |
convert
|
string |
Symbol fiat měny, do které se ceny převedou, např. EUR. Výchozí je USD. |
Nástroj
get_top_movers
Největší gainery nebo losery podle procentní změny za posledních 24 hodin nebo 7 dní.
| Parametr |
Typ |
Popis |
direction
povinné
|
enum |
gainers nebo losers. |
interval
|
enum |
Okno změny pro řazení: 24h nebo 7d (výchozí 24h). |
limit
|
integer |
Maximum vrácených coinů (1–50, výchozí 10). |
Nástroj
get_trending_coins
Coiny, které na Bitculatoru právě přitahují nejvíc pozornosti, jako kompaktní tržní řádky.
| Parametr |
Typ |
Popis |
limit
|
integer |
Maximum vrácených coinů (1–20, výchozí 10). |
Historie
Nástroj
get_price_history
OHLCV svíčky coinu za rozsah dat. Retence: minutové ~8 dní, půlhodinové ~3 měsíce, hodinové ~6 měsíců, denní = celá historie. Vrací nejnovější svíčky v okně, nejstarší první.
| Parametr |
Typ |
Popis |
slug
povinné
|
string |
Kanonický slug coinu. |
interval
|
enum |
Interval svíček: minutely, half-hourly, hourly nebo daily (výchozí daily). |
start
|
date |
Začátek okna jako YYYY-MM-DD; výchozí je nedávné okno odpovídající intervalu. |
end
|
date |
Konec okna jako YYYY-MM-DD; výchozí je teď. |
limit
|
integer |
Maximum vrácených svíček (1–500, výchozí 90). |
Nástroj
get_historical_price
Cena jednoho coinu k jednomu konkrétnímu datu v minulosti, s fallbackem až 3 dny, když přesný den nemá data.
| Parametr |
Typ |
Popis |
slug
povinné
|
string |
Kanonický slug coinu. |
date
povinné
|
date |
Datum jako YYYY-MM-DD (2009-01-01 nebo později, ne v budoucnu). |
Nástroj
get_global_history
Časová řada celkové krypto tržní kapitalizace nebo celkového objemu. Granularita sleduje období: 24h je půlhodinová, 7d hodinová, 30d a all denní.
| Parametr |
Typ |
Popis |
metric
povinné
|
enum |
Která řada se má vrátit: marketcap nebo volume. |
period
|
enum |
Okno: 24h, 7d, 30d nebo all (výchozí 24h). |
Sentiment & globální data
Nástroj
get_global_market
Snímek celého trhu: celková tržní kapitalizace, celkový 24h objem, dominance BTC/ETH a počty coinů/tokenů/burz/párů.
Tento nástroj nepřijímá žádné parametry.
Nástroj
get_fear_greed
Sentimentový index strachu a chamtivosti pro celý trh, nebo pro jeden coin při předání slugu, včetně dílčích skóre za intervaly 7d/30d.
| Parametr |
Typ |
Popis |
coin
|
string |
Volitelný slug coinu pro hodnotu za jeden coin; vynechte pro celotržní index. |
Nástroj
get_altseason_index
Index altseason — zda altcoiny překonávají Bitcoin — s volitelnou denní historií.
| Parametr |
Typ |
Popis |
days
|
integer |
Počet dní denní historie k zahrnutí (0–365; 0 vrátí jen aktuální hodnotu). |
Nástroj
get_liquidations_summary
Dnešní součty likvidací futures s rozdělením long/short a dominancí. Hned po denním překlopení mohou být data null.
Tento nástroj nepřijímá žádné parametry.
Burzy
Nástroj
list_exchanges
Seřazené burzy s 24h objemem, objemovou dominancí a počty párů/aktiv. Také převádí názvy burz na slugy.
| Parametr |
Typ |
Popis |
type
|
enum |
Omezí na centralizované (cex) nebo decentralizované (dex) burzy. |
search
|
string |
Volně zadaný text porovnávaný s názvy burz. |
sort
|
string |
Pole řazení oddělená čárkami, prefix "-" pro sestupné řazení: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets. |
limit
|
integer |
Maximum vrácených burz (1–50, výchozí 10). |
Nástroj
get_exchange
Kompletní profil jedné burzy: pořadí, objem a jeho změny, dominance, listované páry a aktiva a odkazy.
| Parametr |
Typ |
Popis |
slug
povinné
|
string |
Kanonický slug burzy, např. binance-exchange. |
Nástroj
get_exchange_trust_score
Skóre důvěryhodnosti burzy (0–10) s kompletním rozpadem na 13 faktorů.
| Parametr |
Typ |
Popis |
slug
povinné
|
string |
Kanonický slug burzy. |
Nástroj
get_coin_markets
Kde se coin obchoduje: jeho trhy napříč burzami s párem, cenou a 24h objemem, seřazené podle objemu.
| Parametr |
Typ |
Popis |
slug
povinné
|
string |
Kanonický slug coinu. |
exchange
|
string |
Volitelný slug burzy pro omezení výsledků na jedno tržiště. |
instrument
|
enum |
Omezí na jeden typ instrumentu: spot, future, option, swap nebo margin. |
limit
|
integer |
Maximum vrácených trhů (1–50, výchozí 10). |
Analýza & utility
Nástroj
get_coin_technicals
Multi-indikátorový technický snímek coinu v jednom volání: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, volatilita a další, každý s nejnovějším stavem a skóre.
| Parametr |
Typ |
Popis |
slug
povinné
|
string |
Kanonický slug coinu. |
Nástroj
convert_currency
Převeďte částku mezi libovolnými krypto a/nebo fiat měnami (až 10 cílů na volání) podle živých kurzů, s plnou desetinnou přesností.
| Parametr |
Typ |
Popis |
from
povinné
|
string |
Slug zdrojové měny, např. bitcoin nebo united-states-dollar. |
to
povinné
|
string |
Slugy cílových měn oddělené čárkami, až 10. |
amount
|
number |
Množství zdrojové měny k převodu (výchozí 1). |
Nástroj
calculate_dca
Backtestujte strategii průměrování nákladů (DCA) proti reálné cenové historii: celkem investováno, nakumulované coiny, aktuální hodnota a zisk/ztráta.
| Parametr |
Typ |
Popis |
slug
povinné
|
string |
Kanonický slug coinu. |
amount
povinné
|
number |
Částka v USD nakoupená v každém intervalu. |
interval
povinné
|
enum |
Kadence nákupů: daily, weekly, monthly, quarterly nebo yearly. |
start
povinné
|
date |
Datum prvního nákupu jako YYYY-MM-DD (před dneškem). |
end
|
date |
Datum posledního nákupu jako YYYY-MM-DD; výchozí je dnešek. |
series
|
boolean |
Zahrnout řadu po jednotlivých nákupech (velký výstup — nechte false, pokud není vyžádáno). |