Trhové dáta
Nástroj
search_coins
Nájde kryptomenu alebo token podľa voľného textu v názve či symbole a priradí mu kanonický slug, pričom pri každej zhode uvedie trhový súhrn a zhody zoradí podľa poradia. Vstupný bod: každý ďalší nástroj pre kryptomeny sa adresuje slugom.
| Parameter |
Typ |
Popis |
query
povinné
|
string |
Voľnotextové vyhľadávanie porovnávané s názvami a symbolmi kryptomien. |
type
|
enum |
Obmedzí zhody: coin alebo token. |
limit
|
integer |
Maximálny počet vrátených zhôd (1–50, predvolene 10). |
Nástroj
get_coin
Úplný profil jednej kryptomeny: ponuky, poradie a jeho zmeny, historické maximum/minimum a vzdialenosť od nich, plne zriedená valuácia, odkazy, kontrakty a popis.
| Parameter |
Typ |
Popis |
slug
povinné
|
string |
Kanonický slug kryptomeny, napr. bitcoin. |
Nástroj
get_prices
Aktuálne spotové ceny až pre 100 kryptomien v jednom volaní, voliteľne prevedené do fiat meny. Najlacnejší spôsob, ako odpovedať na otázky o cenách – vyžaduje sa presne jeden selektor.
| Parameter |
Typ |
Popis |
slugs
|
string |
Slugy kryptomien oddelené čiarkou – preferovaný selektor. |
symbols
|
string |
Symboly tickerov oddelené čiarkou; nejednoznačné symboly sa priradia k najvyššie zaradenej zhode. |
ids
|
string |
Číselné id kryptomien Bitculator oddelené čiarkou. |
convert
|
string |
Symbol fiat meny, do ktorej sa majú ceny previesť, napr. EUR. Predvolene USD. |
Nástroj
get_top_movers
Kryptomeny s najväčším rastom alebo poklesom podľa percentuálnej zmeny za posledných 24 hodín alebo 7 dní.
| Parameter |
Typ |
Popis |
direction
povinné
|
enum |
gainers alebo losers. |
interval
|
enum |
Okno zmeny, podľa ktorého sa zoraďuje: 24h alebo 7d (predvolene 24h). |
limit
|
integer |
Maximálny počet vrátených kryptomien (1–50, predvolene 10). |
Nástroj
get_trending_coins
Kryptomeny, ktoré momentálne pútajú na platforme Bitculator najviac pozornosti, ako kompaktné trhové riadky.
| Parameter |
Typ |
Popis |
limit
|
integer |
Maximálny počet vrátených kryptomien (1–20, predvolene 10). |
História
Nástroj
get_price_history
Sviečky OHLCV pre kryptomenu za dátumový rozsah. Uchovávanie: minútové ~8 dní, polhodinové ~3 mesiace, hodinové ~6 mesiacov, denné = celá história. Vracia najnovšie sviečky v okne, od najstaršej.
| Parameter |
Typ |
Popis |
slug
povinné
|
string |
Kanonický slug kryptomeny. |
interval
|
enum |
Interval sviečky: minutely, half-hourly, hourly alebo daily (predvolene daily). |
start
|
date |
Začiatok okna vo formáte YYYY-MM-DD; predvolene nedávne okno primerané intervalu. |
end
|
date |
Koniec okna vo formáte YYYY-MM-DD; predvolene teraz. |
limit
|
integer |
Maximálny počet vrátených sviečok (1–500, predvolene 90). |
Nástroj
get_historical_price
Cena jednej kryptomeny v konkrétny minulý dátum, s náhradou až 3 dni dozadu, keď pre presný deň nie sú dáta.
| Parameter |
Typ |
Popis |
slug
povinné
|
string |
Kanonický slug kryptomeny. |
date
povinné
|
date |
Dátum vo formáte YYYY-MM-DD (2009-01-01 alebo neskôr, nie v budúcnosti). |
Nástroj
get_global_history
Časový rad celkovej trhovej kapitalizácie kryptomien alebo celkového objemu. Granularita sa riadi obdobím: 24h je polhodinová, 7d hodinová, 30d a all denná.
| Parameter |
Typ |
Popis |
metric
povinné
|
enum |
Ktorý rad sa má vrátiť: marketcap alebo volume. |
period
|
enum |
Okno: 24h, 7d, 30d alebo all (predvolene 24h). |
Sentiment a globálne dáta
Nástroj
get_global_market
Snímka celého trhu: celková trhová kapitalizácia, celkový 24h objem, dominancia BTC/ETH a počty kryptomien/tokenov/búrz/párov. Obsahuje aj trhovú hodnotu Fear & Greed – uvádzajte jej index (0–100), nie surové score.
Tento nástroj neprijíma žiadne parametre.
Nástroj
get_fear_greed
Sentimentový index strachu a chamtivosti pre celý trh alebo pre jednu kryptomenu, keď sa odovzdá slug, vrátane čiastkových skóre za intervaly 7d/30d. Uvádzajte index (0–100, ako ho zobrazuje Bitculator), nie surové score (−100…+100).
| Parameter |
Typ |
Popis |
coin
|
string |
Voliteľný slug kryptomeny pre hodnotu za jednu kryptomenu; vynechajte pre celotrhový index. |
Nástroj
get_altseason_index
Index altseason – či altcoiny prekonávajú Bitcoin – s voliteľnou dennou históriou.
| Parameter |
Typ |
Popis |
days
|
integer |
Počet dní dennej histórie, ktoré sa majú zahrnúť (0–365; 0 vráti iba aktuálnu hodnotu). |
Nástroj
get_liquidations_summary
Dnešné celkové likvidácie futures s rozdelením Long/Short a dominanciou. Hneď po dennom resete môžu byť dáta null.
Tento nástroj neprijíma žiadne parametre.
Burzy
Nástroj
list_exchanges
Burzy zoradené podľa poradia s 24h objemom, dominanciou objemu a počtami párov/aktív. Zároveň prevádza názvy búrz na slugy.
| Parameter |
Typ |
Popis |
type
|
enum |
Obmedzí na centralizované (cex) alebo decentralizované (dex) burzy. |
search
|
string |
Voľnotextové vyhľadávanie porovnávané s názvami búrz. |
sort
|
string |
Polia na zoradenie oddelené čiarkou, predpona „-“ pre zostupné poradie: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets. |
limit
|
integer |
Maximálny počet vrátených búrz (1–50, predvolene 10). |
Nástroj
get_exchange
Úplný profil jednej burzy: poradie, objem a jeho zmeny, dominancia, obchodované páry a aktíva, odkazy.
| Parameter |
Typ |
Popis |
slug
povinné
|
string |
Kanonický slug burzy, napr. binance-exchange. |
Nástroj
get_exchange_trust_score
Skóre dôvery burzy (0–10) s úplným 13-faktorovým rozpisom. Nezaradená burza (zatiaľ bez aktívneho spotového objemu) vráti skóre aj rozpis ako null: nebola ohodnotená, čo nie je to isté ako nízke skóre.
| Parameter |
Typ |
Popis |
slug
povinné
|
string |
Kanonický slug burzy. |
Nástroj
get_coin_markets
Kde sa kryptomena obchoduje: jej trhy naprieč burzami s párom, cenou a 24h objemom, zoradené podľa objemu.
| Parameter |
Typ |
Popis |
slug
povinné
|
string |
Kanonický slug kryptomeny. |
exchange
|
string |
Voliteľný slug burzy na obmedzenie výsledkov na jedno obchodné miesto. |
instrument
|
enum |
Obmedzí na jeden typ inštrumentu: spot, future, option, swap alebo margin. |
limit
|
integer |
Maximálny počet vrátených trhov (1–50, predvolene 10). |
Analýza a pomôcky
Nástroj
get_coin_technicals
Technická snímka kryptomeny s viacerými indikátormi v jednom volaní: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, volatilita a ďalšie, každý s najnovším stavom a skóre.
| Parameter |
Typ |
Popis |
slug
povinné
|
string |
Kanonický slug kryptomeny. |
Nástroj
convert_currency
Prevedie sumu medzi ľubovoľnými krypto a/alebo fiat menami (až 10 cieľov na volanie) podľa živých kurzov, s plnou desatinnou presnosťou.
| Parameter |
Typ |
Popis |
from
povinné
|
string |
Slug zdrojovej meny, napr. bitcoin alebo united-states-dollar. |
to
povinné
|
string |
Slugy cieľových mien oddelené čiarkou, najviac 10. |
amount
|
number |
Množstvo zdrojovej meny na prevod (predvolene 1). |
Nástroj
calculate_dca
Spätne otestuje stratégiu DCA voči reálnej cenovej histórii: celkovo investované, nazhromaždené množstvo kryptomeny, aktuálna hodnota a zisk/strata.
| Parameter |
Typ |
Popis |
slug
povinné
|
string |
Kanonický slug kryptomeny. |
amount
povinné
|
number |
Suma v USD nakúpená v každom intervale. |
interval
povinné
|
enum |
Frekvencia nákupov: daily, weekly, monthly, quarterly alebo yearly. |
start
povinné
|
date |
Dátum prvého nákupu vo formáte YYYY-MM-DD (pred dneškom). |
end
|
date |
Dátum posledného nákupu vo formáte YYYY-MM-DD; predvolene dnes. |
series
|
boolean |
Zahrnie rad podľa jednotlivých nákupov (veľký výstup – ponechajte false, ak ho výslovne nepotrebujete). |