Bitculator
Bitculator · Data API · v1

Bitculator Data API

76 koncových bodov 15 skupín X-Quota-* pri každom volaní https://bitculator.com/api/v1

Všetky koncové body sa nachádzajú pod /api/v1 a vyžadujú Bearer kľúč s oprávnením data-api – vytvorte si ho vo svojej vývojárskej konzole.

Vaše prvé volanie:

curl https://bitculator.com/api/v1/prices/bitcoin \
  -H "Authorization: Bearer YOUR_API_KEY"

Odpovede sú vo formáte JSON. Ceny, kurzy a ponuky sú desatinné reťazce (typ float neunesie trhovú presnosť); počty a analytické hodnoty sú čísla. Každá odpoveď nesie vašu aktuálnu kvótu v hlavičkách X-Quota-Limit / X-Quota-Used / X-Quota-Reset a chyby vždy používajú obálku {"error": {"code", "message", "details"}}.

Data API má vlastnú mesačnú kvótu, viazanú na váš API plán a úplne oddelenú od vašich vložených widgetov. Stropy per_page závisia od plánu (Free 100, Starter/Pro 250); prekročenie stropu vráti 422, namiesto orezania hodnoty.

Klientske knižnice

SDK nepotrebujete – každý koncový bod je obyčajné HTTP. Ak ho však uprednostňujete, k dispozícii je osem oficiálnych SDK pod licenciou MIT; všetky pokrývajú celé API a majú zabudované stránkovanie, typované chyby aj presnosť desatinných reťazcov.

npm install @bitculator/sdk
pip install bitculator
PHP PHP
composer require bitculator/sdk
Go Go
go get github.com/bitculator/bitculator-go-sdk
cargo add bitculator
com.bitculator : bitculator
dotnet add package Bitculator
C++ C++
FetchContent: bitculator-cpp-sdk

Autentifikácia

Na autentifikáciu požiadaviek pridajte ku každej požiadavke hlavičku Authorization: Bearer {YOUR_API_KEY}.

Kľúč pre Data API si vytvorte vo svojej vývojárskej konzole – kľúče fungujú iba cez Bearer a nesú oprávnenie data-api. Držte ich na strane servera; nikdy nie sú určené na vkladanie do klientskeho kódu.

Hlavička Authorization
Vytvoriť kľúč →
Bearer
bc_••••••••••••••••

Posiela sa pri každej požiadavke ako Authorization: Bearer {YOUR_API_KEY}.

Pri každom koncovom bode je uvedený minimálny plán potrebný na jeho volanie. Free Starter Pro
9 koncových bodov

Kryptomeny

Zoradené trhové dáta mincí a tokenov: stránkované zoznamy, detail jednej mince, pohyby cien (rastúce/klesajúce), nedávno pridané mince, trendové mince a časové rady pre jednotlivé mince. Ceny a ponuka sú desatinné REŤAZCE (float neunesie trhovú presnosť); trhová kapitalizácia, 24h objem, percentuálne zmeny, poradia a počty sú čísla.

Zoznam mincí

Free

Zoradené mince s cenami, filtrami a selektormi, stránkované obálkou links + meta z Laravelu. Ceny a circulating_supply sú desatinné reťazce; marketcap, volume_24h, zmeny a poradia sú čísla.

GET
https://bitculator.com/api/v1/coins
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

page
integer voliteľné
1

Číslo strany (počítané od 1). Musí byť aspoň 1.

per_page
integer voliteľné
50

Počet riadkov na stranu. Strop závisí od plánu (Free 100, Starter/Pro 250); jeho prekročenie vráti 422 namiesto orezania. Musí byť aspoň 1. Nesmie byť väčší ako 100.

type
string voliteľné
coin

Obmedziť na jediný typ aktíva: coin alebo token.

Jedna z hodnôt: coin token

status
string voliteľné
active

Stav listingu: active, delisted, untracked, progressing, awaiting alebo preparing. Predvolene všetky verejné stavy.

Jedna z hodnôt: active delisted untracked progressing awaiting preparing

search
string voliteľné
bitcoin

Voľnotextová zhoda v názve alebo symbole. Nesmie byť dlhšie ako 100 znakov.

min_price
number voliteľné
0.5

Len mince s cenou na úrovni tejto hodnoty v USD alebo vyššou. Musí byť aspoň 0.

max_price
number voliteľné
100000

Len mince s cenou na úrovni tejto hodnoty v USD alebo nižšou. Musí byť aspoň 0.

min_marketcap
number voliteľné
1000000

Len mince s trhovou kapitalizáciou v USD na úrovni tejto hodnoty alebo vyššou. Musí byť aspoň 0.

max_marketcap
number voliteľné
5000000000000

Len mince s trhovou kapitalizáciou v USD na úrovni tejto hodnoty alebo nižšou. Musí byť aspoň 0.

min_volume
number voliteľné
1000000

Len mince s 24h objemom v USD na úrovni tejto hodnoty alebo vyšším. Musí byť aspoň 0.

max_volume
number voliteľné
100000000000

Len mince s 24h objemom v USD na úrovni tejto hodnoty alebo nižším. Musí byť aspoň 0.

ids
string voliteľné
38,39

Obmedziť na konkrétne id kryptomien (CSV, až 100 selektorov spolu so slugs/symbols). Nesmie byť dlhšie ako 1000 znakov.

slugs
string voliteľné
bitcoin,ethereum

Obmedziť na konkrétne slugy kryptomien (CSV, až 100 selektorov spolu). Nesmie byť dlhšie ako 2000 znakov.

symbols
string voliteľné
BTC,ETH

Obmedziť na konkrétne symboly kryptomien (CSV, nerozlišujú sa veľké a malé písmená, až 100 selektorov spolu). Nesmie byť dlhšie ako 1000 znakov.

sort
string voliteľné
-marketcap

Polia na zoradenie oddelené čiarkou; s predponou - pre zostupné poradie. Zoraditeľné: marketcap, rank, price, volume_24h, change_24h, change_7d. Nesmie byť dlhšie ako 100 znakov.

interval
string voliteľné
24h

Okno pohybov cien, len pre /coins/gainers a /coins/losers: 24h alebo 7d.

Jedna z hodnôt: 24h 7d

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins?page=1&per_page=50&type=coin&status=active&search=bitcoin&min_price=0.5&max_price=100000&min_marketcap=1000000&max_marketcap=5000000000000&min_volume=1000000&max_volume=100000000000&ids=38%2C39&slugs=bitcoin%2Cethereum&symbols=BTC%2CETH&sort=-marketcap&interval=24h" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Nedávno pridané mince

Free

Najnovšie listingy – zoradené podľa status_updated_at (čas prechodu do aktívneho stavu; created_at je dátum prehľadania, ktorý predchádza listingu o ľubovoľne dlhý čas). Parameter sort nahradí toto predvolené zoradenie od najnovších, rovnako ako pri List coins. Rovnaký tvar riadkov a stránkovacia obálka ako List coins.

GET
https://bitculator.com/api/v1/coins/recently-added
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

page
integer voliteľné
1

Číslo strany (počítané od 1). Musí byť aspoň 1.

per_page
integer voliteľné
50

Počet riadkov na stranu. Strop závisí od plánu (Free 100, Starter/Pro 250); jeho prekročenie vráti 422 namiesto orezania. Musí byť aspoň 1. Nesmie byť väčší ako 100.

type
string voliteľné
coin

Obmedziť na jediný typ aktíva: coin alebo token.

Jedna z hodnôt: coin token

status
string voliteľné
active

Stav listingu: active, delisted, untracked, progressing, awaiting alebo preparing. Predvolene všetky verejné stavy.

Jedna z hodnôt: active delisted untracked progressing awaiting preparing

search
string voliteľné
bitcoin

Voľnotextová zhoda v názve alebo symbole. Nesmie byť dlhšie ako 100 znakov.

min_price
number voliteľné
0.5

Len mince s cenou na úrovni tejto hodnoty v USD alebo vyššou. Musí byť aspoň 0.

max_price
number voliteľné
100000

Len mince s cenou na úrovni tejto hodnoty v USD alebo nižšou. Musí byť aspoň 0.

min_marketcap
number voliteľné
1000000

Len mince s trhovou kapitalizáciou v USD na úrovni tejto hodnoty alebo vyššou. Musí byť aspoň 0.

max_marketcap
number voliteľné
5000000000000

Len mince s trhovou kapitalizáciou v USD na úrovni tejto hodnoty alebo nižšou. Musí byť aspoň 0.

min_volume
number voliteľné
1000000

Len mince s 24h objemom v USD na úrovni tejto hodnoty alebo vyšším. Musí byť aspoň 0.

max_volume
number voliteľné
100000000000

Len mince s 24h objemom v USD na úrovni tejto hodnoty alebo nižším. Musí byť aspoň 0.

ids
string voliteľné
38,39

Obmedziť na konkrétne id kryptomien (CSV, až 100 selektorov spolu so slugs/symbols). Nesmie byť dlhšie ako 1000 znakov.

slugs
string voliteľné
bitcoin,ethereum

Obmedziť na konkrétne slugy kryptomien (CSV, až 100 selektorov spolu). Nesmie byť dlhšie ako 2000 znakov.

symbols
string voliteľné
BTC,ETH

Obmedziť na konkrétne symboly kryptomien (CSV, nerozlišujú sa veľké a malé písmená, až 100 selektorov spolu). Nesmie byť dlhšie ako 1000 znakov.

sort
string voliteľné
-marketcap

Polia na zoradenie oddelené čiarkou; s predponou - pre zostupné poradie. Zoraditeľné: marketcap, rank, price, volume_24h, change_24h, change_7d. Nesmie byť dlhšie ako 100 znakov.

interval
string voliteľné
24h

Okno pohybov cien, len pre /coins/gainers a /coins/losers: 24h alebo 7d.

Jedna z hodnôt: 24h 7d

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/recently-added?page=1&per_page=50&type=coin&status=active&search=bitcoin&min_price=0.5&max_price=100000&min_marketcap=1000000&max_marketcap=5000000000000&min_volume=1000000&max_volume=100000000000&ids=38%2C39&slugs=bitcoin%2Cethereum&symbols=BTC%2CETH&sort=-marketcap&interval=24h" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Najväčšie rasty

Free

Najväčšie rasty za okno interval (predvolene 24h alebo 7d). Rovnaký tvar riadkov a stránkovacia obálka ako List coins.

GET
https://bitculator.com/api/v1/coins/gainers
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

page
integer voliteľné
1

Číslo strany (počítané od 1). Musí byť aspoň 1.

per_page
integer voliteľné
50

Počet riadkov na stranu. Strop závisí od plánu (Free 100, Starter/Pro 250); jeho prekročenie vráti 422 namiesto orezania. Musí byť aspoň 1. Nesmie byť väčší ako 100.

type
string voliteľné
coin

Obmedziť na jediný typ aktíva: coin alebo token.

Jedna z hodnôt: coin token

status
string voliteľné
active

Stav listingu: active, delisted, untracked, progressing, awaiting alebo preparing. Predvolene všetky verejné stavy.

Jedna z hodnôt: active delisted untracked progressing awaiting preparing

search
string voliteľné
bitcoin

Voľnotextová zhoda v názve alebo symbole. Nesmie byť dlhšie ako 100 znakov.

min_price
number voliteľné
0.5

Len mince s cenou na úrovni tejto hodnoty v USD alebo vyššou. Musí byť aspoň 0.

max_price
number voliteľné
100000

Len mince s cenou na úrovni tejto hodnoty v USD alebo nižšou. Musí byť aspoň 0.

min_marketcap
number voliteľné
1000000

Len mince s trhovou kapitalizáciou v USD na úrovni tejto hodnoty alebo vyššou. Musí byť aspoň 0.

max_marketcap
number voliteľné
5000000000000

Len mince s trhovou kapitalizáciou v USD na úrovni tejto hodnoty alebo nižšou. Musí byť aspoň 0.

min_volume
number voliteľné
1000000

Len mince s 24h objemom v USD na úrovni tejto hodnoty alebo vyšším. Musí byť aspoň 0.

max_volume
number voliteľné
100000000000

Len mince s 24h objemom v USD na úrovni tejto hodnoty alebo nižším. Musí byť aspoň 0.

ids
string voliteľné
38,39

Obmedziť na konkrétne id kryptomien (CSV, až 100 selektorov spolu so slugs/symbols). Nesmie byť dlhšie ako 1000 znakov.

slugs
string voliteľné
bitcoin,ethereum

Obmedziť na konkrétne slugy kryptomien (CSV, až 100 selektorov spolu). Nesmie byť dlhšie ako 2000 znakov.

symbols
string voliteľné
BTC,ETH

Obmedziť na konkrétne symboly kryptomien (CSV, nerozlišujú sa veľké a malé písmená, až 100 selektorov spolu). Nesmie byť dlhšie ako 1000 znakov.

sort
string voliteľné
-marketcap

Polia na zoradenie oddelené čiarkou; s predponou - pre zostupné poradie. Zoraditeľné: marketcap, rank, price, volume_24h, change_24h, change_7d. Nesmie byť dlhšie ako 100 znakov.

interval
string voliteľné
24h

Okno pohybov cien, len pre /coins/gainers a /coins/losers: 24h alebo 7d.

Jedna z hodnôt: 24h 7d

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/gainers?page=1&per_page=50&type=coin&status=active&search=bitcoin&min_price=0.5&max_price=100000&min_marketcap=1000000&max_marketcap=5000000000000&min_volume=1000000&max_volume=100000000000&ids=38%2C39&slugs=bitcoin%2Cethereum&symbols=BTC%2CETH&sort=-marketcap&interval=24h" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Najväčšie poklesy

Free

Najväčšie prepady za okno interval (predvolene 24h alebo 7d). Rovnaký tvar riadkov a stránkovacia obálka ako List coins.

GET
https://bitculator.com/api/v1/coins/losers
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

page
integer voliteľné
1

Číslo strany (počítané od 1). Musí byť aspoň 1.

per_page
integer voliteľné
50

Počet riadkov na stranu. Strop závisí od plánu (Free 100, Starter/Pro 250); jeho prekročenie vráti 422 namiesto orezania. Musí byť aspoň 1. Nesmie byť väčší ako 100.

type
string voliteľné
coin

Obmedziť na jediný typ aktíva: coin alebo token.

Jedna z hodnôt: coin token

status
string voliteľné
active

Stav listingu: active, delisted, untracked, progressing, awaiting alebo preparing. Predvolene všetky verejné stavy.

Jedna z hodnôt: active delisted untracked progressing awaiting preparing

search
string voliteľné
bitcoin

Voľnotextová zhoda v názve alebo symbole. Nesmie byť dlhšie ako 100 znakov.

min_price
number voliteľné
0.5

Len mince s cenou na úrovni tejto hodnoty v USD alebo vyššou. Musí byť aspoň 0.

max_price
number voliteľné
100000

Len mince s cenou na úrovni tejto hodnoty v USD alebo nižšou. Musí byť aspoň 0.

min_marketcap
number voliteľné
1000000

Len mince s trhovou kapitalizáciou v USD na úrovni tejto hodnoty alebo vyššou. Musí byť aspoň 0.

max_marketcap
number voliteľné
5000000000000

Len mince s trhovou kapitalizáciou v USD na úrovni tejto hodnoty alebo nižšou. Musí byť aspoň 0.

min_volume
number voliteľné
1000000

Len mince s 24h objemom v USD na úrovni tejto hodnoty alebo vyšším. Musí byť aspoň 0.

max_volume
number voliteľné
100000000000

Len mince s 24h objemom v USD na úrovni tejto hodnoty alebo nižším. Musí byť aspoň 0.

ids
string voliteľné
38,39

Obmedziť na konkrétne id kryptomien (CSV, až 100 selektorov spolu so slugs/symbols). Nesmie byť dlhšie ako 1000 znakov.

slugs
string voliteľné
bitcoin,ethereum

Obmedziť na konkrétne slugy kryptomien (CSV, až 100 selektorov spolu). Nesmie byť dlhšie ako 2000 znakov.

symbols
string voliteľné
BTC,ETH

Obmedziť na konkrétne symboly kryptomien (CSV, nerozlišujú sa veľké a malé písmená, až 100 selektorov spolu). Nesmie byť dlhšie ako 1000 znakov.

sort
string voliteľné
-marketcap

Polia na zoradenie oddelené čiarkou; s predponou - pre zostupné poradie. Zoraditeľné: marketcap, rank, price, volume_24h, change_24h, change_7d. Nesmie byť dlhšie ako 100 znakov.

interval
string voliteľné
24h

Okno pohybov cien, len pre /coins/gainers a /coins/losers: 24h alebo 7d.

Jedna z hodnôt: 24h 7d

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/losers?page=1&per_page=50&type=coin&status=active&search=bitcoin&min_price=0.5&max_price=100000&min_marketcap=1000000&max_marketcap=5000000000000&min_volume=1000000&max_volume=100000000000&ids=38%2C39&slugs=bitcoin%2Cethereum&symbols=BTC%2CETH&sort=-marketcap&interval=24h" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Získať detail kryptomeny

Free

Úplný profil jednej kryptomeny. Okrem polí zo zoznamu pridáva: supply (obiehajúca/celková/maximálna), OHLC za today, all_time_high / all_time_low (cena, dátum a percent_from aktuálnej ceny), fully_diluted_valuation (maximálna ponuka, inak celková ponuka, krát cena; null, ak nie je známa ani jedna), trhové counts (burzy/páry/tickery/peňaženky), decimals, genesis_date, oficiálne links (typovaný zoznam url), contracts tokenu a lokalizovaný HTML description (pri chýbajúcom požadovanom jazyku sa použije angličtina). Všetky polia ceny/ponuky sú desatinné reťazce.

GET
https://bitculator.com/api/v1/coins/{slug}
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Slug mince.

Parametre dopytu

locale
string voliteľné
en

Jazyk obsahu popisu (záložným jazykom je angličtina).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin?locale=en" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

História sviečok

Free

Časové rady OHLC + objem + trhová kapitalizácia pre jednotlivé mince. Zvoľte interval: minutely, half-hourly, hourly alebo daily. Doba uchovávania je pevnou vlastnosťou agregačného reťazca – minutely 8 dní, half-hourly 3 mesiace, hourly 6 mesiacov, daily navždy; požiadavky nad rámec okna vrátia to, čo existuje. Keď je nastavený limit, dostanete N NAJNOVŠÍCH riadkov v okne, vypísaných od najstaršieho. Ceny sú desatinné reťazce.

GET
https://bitculator.com/api/v1/coins/{slug}/history
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Slug mince.

Parametre dopytu

interval
string voliteľné
daily

minutely, half-hourly, hourly alebo daily (predvolene daily).

start
string voliteľné
2026-06-01

Dolná hranica dátumu/času ISO.

end
string voliteľné
2026-06-30

Horná hranica dátumu/času ISO (hodnota len s dátumom znamená vrátane celého daného dňa).

limit
integer voliteľné
30

Maximálny počet riadkov (1–2000, predvolene 1000).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin/history?interval=daily&start=2026-06-01&end=2026-06-30&limit=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

História trhovej kapitalizácie

Free

Tie isté agregácie pre jednotlivé mince ako Candle history, premietnuté len do {time, marketcap}. Rovnaké možnosti interval a okná uchovávania (minutely 8 dní, half-hourly 3 mesiace, hourly 6 mesiacov, daily navždy), pri nastavenom limit N najnovších.

GET
https://bitculator.com/api/v1/coins/{slug}/marketcap-history
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Slug mince.

Parametre dopytu

interval
string voliteľné
daily

minutely, half-hourly, hourly alebo daily (predvolene daily).

start
string voliteľné
2026-06-01

Dolná hranica dátumu/času ISO.

end
string voliteľné
2026-06-30

Horná hranica dátumu/času ISO.

limit
integer voliteľné
30

Maximálny počet riadkov (1–2000, predvolene 1000).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin/marketcap-history?interval=daily&start=2026-06-01&end=2026-06-30&limit=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Sparkline kryptomeny

Free

Kompaktný cenový rad pre kryptomenu za zvolené period, určený na kreslenie sparklinov.

points je vzorka najviac 480 hodnôt, od najstaršej, každá je desatinný reťazec price s časom time vo formáte ISO-8601. low a high sú skutočné extrémy celého obdobia – ohraničujú každý bod, ale nemusia sa nachádzať medzi vzorkovanými. change je zmena za obdobie v PERCENTÁCH (1.25 znamená +1.25 %).

GET
https://bitculator.com/api/v1/coins/{slug}/sparkline
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Slug mince.

Parametre dopytu

period
string voliteľné
7d

24h, 7d, 30d, 60d, 90d, 180d alebo 365d (predvolené 7d).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin/sparkline?period=7d" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
3 koncových bodov

Ceny

Odľahčená rýchla cesta k cenám – aktuálna cena, trhová kapitalizácia, 24h objem a nedávne zmeny pre požadovanú množinu mincí. /prices vyžaduje selektor (ids, slugs alebo symbols); /prices/{slug} cieli na jednu mincu. Voliteľne convert do fiat meny (ceny kryptomien sa obnovujú ~každú minútu, fiat kurzy ~dvakrát denne). Ceny sú desatinné reťazce; trhová kapitalizácia a 24h objem sú čísla.

Získať ceny

Free

Ceny pre požadovanú množinu mincí. Odovzdajte aspoň jeden selektor – ids, slugs alebo symbols (spolu najviac 100). meta.currency vracia cieľ konverzie (USD, ak nie je nastavený convert).

GET
https://bitculator.com/api/v1/prices
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

ids
string voliteľné
38,39

Id kryptomien na ocenenie (CSV). Vyžaduje sa aspoň jedno z polí ids, slugs alebo symbols; tieto tri zoznamy majú spolu limit 100 selektorov. Toto pole je povinné, keď nie je prítomné ani slugs, ani symbols. Nesmie byť dlhšie ako 1000 znakov.

slugs
string voliteľné
bitcoin,ethereum

Slugy kryptomien na ocenenie (CSV). Vyžaduje sa aspoň jedno z polí ids, slugs alebo symbols. Toto pole je povinné, keď nie je prítomné ani ids, ani symbols. Nesmie byť dlhšie ako 2000 znakov.

symbols
string voliteľné
BTC,ETH

Symboly kryptomien na ocenenie (CSV, nerozlišujú sa veľké a malé písmená). Vyžaduje sa aspoň jedno z polí ids, slugs alebo symbols. Toto pole je povinné, keď nie je prítomné ani ids, ani slugs. Nesmie byť dlhšie ako 1000 znakov.

convert
string voliteľné
EUR

Prepočet cien/trhovej kapitalizácie na aktívnu fiat menu podľa symbolu (predvolené USD). FX kurzy sa obnovujú ~dvakrát denne.

Jedna z hodnôt: USD EUR JPY BGN CZK DKK GBP HUF PLN RON SEK CHF ISK NOK HRK RUB TRY AUD BRL CAD CNY HKD IDR ILS INR KRW MXN MYR NZD PHP SGD THB ZAR ARS DZD MAD TWD

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/prices?ids=38%2C39&slugs=bitcoin%2Cethereum&symbols=BTC%2CETH&convert=EUR" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Získať cenu kryptomeny

Free

Cenová snímka jednej mince. Voliteľne convert do aktívnej fiat meny podľa symbolu (predvolene USD).

GET
https://bitculator.com/api/v1/prices/{slug}
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Slug mince.

Parametre dopytu

convert
string voliteľné
EUR

Symbol aktívnej fiat meny, v ktorej sa majú uvádzať ceny (predvolené USD).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/prices/bitcoin?convert=EUR" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Historická cena

Free

Cena mince v USD k danému dátumu, načítaná z dennej histórie (presný deň, záloha ±3 dni – ten istý mechanizmus, aký používa portfólio). Len kryptomeny: fiat riadky nemajú dennú históriu.

GET
https://bitculator.com/api/v1/historical-price
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

slug
string povinné
bitcoin

Identifikátor slug danej mince.

date
string povinné
2021-04-14

date Dátum vyhľadania (po 2008-12-31, nie v budúcnosti).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/historical-price?slug=bitcoin&date=2021-04-14" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
5 koncových bodov

Trhy

Tickery (trhy jednotlivých búrz) a páry (trhy agregované naprieč burzami), plus trhy danej mince a surové obchodné symboly podľa búrz. Všetko sú snímkové dáta – história pre jednotlivé tickery/páry neexistuje. Objemy v USD sú čísla, ceny sú desatinné reťazce.

Trhy kryptomeny

Free

Všetky trhy pre kryptomenu – tickery, ktorých pár má danú kryptomenu ako základnú ALEBO kótovanú menu. Rovnaký tvar riadkov a filtre ako List tickers.

GET
https://bitculator.com/api/v1/coins/{slug}/markets
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Slug mince.

Parametre dopytu

page
integer voliteľné
1

Číslo strany (počítané od 1). Musí byť aspoň 1.

per_page
integer voliteľné
50

Počet riadkov na stranu. Strop závisí od plánu (Free 100, Starter/Pro 250); jeho prekročenie vráti 422 namiesto orezania. Musí byť aspoň 1. Nesmie byť väčší ako 100.

exchange
string voliteľné
binance-exchange

Obmedziť na jedinú burzu podľa slugu (vynechajte pri zozname pre konkrétnu burzu, ktorý je už obmedzený). Musí zodpovedať regulárnemu výrazu /^[a-z0-9-]{1,120}$/.

pair
integer voliteľné
1

Obmedziť na jediný pár podľa id. Musí byť aspoň 1.

instrument
string voliteľné
spot

Typ inštrumentu: future, option, swap, spot alebo margin (akceptuje sa aj množné číslo).

Jedna z hodnôt: future option swap spot margin

search
string voliteľné
BTC

Voľnotextová zhoda v symbole tickera. Nesmie byť dlhšie ako 50 znakov.

min_volume
number voliteľné
1000000

Len tickery s 24h objemom v USD na úrovni tejto hodnoty alebo vyšším. Musí byť aspoň 0.

max_volume
number voliteľné
100000000000

Len tickery s 24h objemom v USD na úrovni tejto hodnoty alebo nižším. Musí byť aspoň 0.

min_change
number voliteľné
-50

Len tickery s 24h percentuálnou zmenou na úrovni tejto hodnoty alebo vyššou.

max_change
number voliteľné
50

Len tickery s 24h percentuálnou zmenou na úrovni tejto hodnoty alebo nižšou.

sort
string voliteľné
-volume_usd

Jedno pole na zoradenie (s predponou - pre zostupné poradie). Zoraditeľné: volume_usd, change_24h, price_usd, updated. Predvolené je -volume_usd. Nesmie byť dlhšie ako 100 znakov.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin/markets?page=1&per_page=50&exchange=binance-exchange&pair=1&instrument=spot&search=BTC&min_volume=1000000&max_volume=100000000000&min_change=-50&max_change=50&sort=-volume_usd" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Obchodné symboly kryptomeny

Free

Surové obchodné symboly mince podľa jednotlivých búrz – riedko vyplnené referenčné dáta (pokrytie je podľa najlepších možností).

GET
https://bitculator.com/api/v1/coins/{slug}/symbols
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Slug mince.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin/symbols" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Zoznam tickerov

Free

Jednotlivé trhy podľa búrz (tickery), stránkované. Filtrujte podľa burzy, páru, inštrumentu a rozsahov objemu/zmeny. Objemy v USD sú čísla; ceny sú desatinné reťazce.

GET
https://bitculator.com/api/v1/tickers
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

page
integer voliteľné
1

Číslo strany (počítané od 1). Musí byť aspoň 1.

per_page
integer voliteľné
50

Počet riadkov na stranu. Strop závisí od plánu (Free 100, Starter/Pro 250); jeho prekročenie vráti 422 namiesto orezania. Musí byť aspoň 1. Nesmie byť väčší ako 100.

exchange
string voliteľné
binance-exchange

Obmedziť na jedinú burzu podľa slugu (vynechajte pri zozname pre konkrétnu burzu, ktorý je už obmedzený). Musí zodpovedať regulárnemu výrazu /^[a-z0-9-]{1,120}$/.

pair
integer voliteľné
1

Obmedziť na jediný pár podľa id. Musí byť aspoň 1.

instrument
string voliteľné
spot

Typ inštrumentu: future, option, swap, spot alebo margin (akceptuje sa aj množné číslo).

Jedna z hodnôt: future option swap spot margin

search
string voliteľné
BTC

Voľnotextová zhoda v symbole tickera. Nesmie byť dlhšie ako 50 znakov.

min_volume
number voliteľné
1000000

Len tickery s 24h objemom v USD na úrovni tejto hodnoty alebo vyšším. Musí byť aspoň 0.

max_volume
number voliteľné
100000000000

Len tickery s 24h objemom v USD na úrovni tejto hodnoty alebo nižším. Musí byť aspoň 0.

min_change
number voliteľné
-50

Len tickery s 24h percentuálnou zmenou na úrovni tejto hodnoty alebo vyššou.

max_change
number voliteľné
50

Len tickery s 24h percentuálnou zmenou na úrovni tejto hodnoty alebo nižšou.

sort
string voliteľné
-volume_usd

Jedno pole na zoradenie (s predponou - pre zostupné poradie). Zoraditeľné: volume_usd, change_24h, price_usd, updated. Predvolené je -volume_usd. Nesmie byť dlhšie ako 100 znakov.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/tickers?page=1&per_page=50&exchange=binance-exchange&pair=1&instrument=spot&search=BTC&min_volume=1000000&max_volume=100000000000&min_change=-50&max_change=50&sort=-volume_usd" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Zoznam párov

Free

Obchodné páry agregované naprieč obchodnými miestami, zoradené podľa 24h objemu v USD. Filtrujte podľa slugu mince (základnej alebo kótovacej) a rozsahu objemu.

GET
https://bitculator.com/api/v1/pairs
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

page
integer voliteľné
1

Číslo strany (počítané od 1). Musí byť aspoň 1.

per_page
integer voliteľné
50

Počet riadkov na stranu. Strop závisí od plánu (Free 100, Starter/Pro 250); jeho prekročenie vráti 422 namiesto orezania. Musí byť aspoň 1. Nesmie byť väčší ako 100.

search
string voliteľné
BTC

Voľnotextová zhoda v symbole páru. Nesmie byť dlhšie ako 50 znakov.

coin
string voliteľné
bitcoin

Obmedziť na páry, kde je slug tejto mince základným alebo kótovacím aktívom. Musí zodpovedať regulárnemu výrazu /^[a-z0-9-]{1,120}$/.

min_volume
number voliteľné
1000000

Len páry s 24h objemom v USD na úrovni tejto hodnoty alebo vyšším. Musí byť aspoň 0.

max_volume
number voliteľné
100000000000

Len páry s 24h objemom v USD na úrovni tejto hodnoty alebo nižším. Musí byť aspoň 0.

sort
string voliteľné
-volume_usd

Pole na zoradenie: volume_usd alebo updated (pre zostupné poradie pridajte predponu -). Predvolene -volume_usd.

Jedna z hodnôt: volume_usd -volume_usd updated -updated

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/pairs?page=1&per_page=50&search=BTC&coin=bitcoin&min_volume=1000000&max_volume=100000000000&sort=-volume_usd" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Získať detail páru

Free

Jeden pár plus každý burzový ticker, ktorý ho ponúka, zoradené podľa objemu.

GET
https://bitculator.com/api/v1/pairs/{id}
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

id
integer povinné
1

Id páru.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/pairs/1" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
7 koncových bodov

Burzy

Rebríčky búrz, detail, skóre dôvery, časové rady a zoznamy trhov/kryptomien pre jednotlivé burzy. Objemy sú v USD. Neexistuje stĺpec CEX/DEX – type sa odvodzuje z taxonómie búrz, takže môže byť „cex“, „dex“ alebo null.

Zoznam búrz

Free

Zoradené burzy s 24h objemom, dominanciou, počtami párov a aktív a nedávnymi zmenami. Stránkované obálkou links + meta z Laravelu.

GET
https://bitculator.com/api/v1/exchanges
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

page
integer voliteľné
1

Číslo strany (počítané od 1). Musí byť aspoň 1.

per_page
integer voliteľné
50

Počet riadkov na stranu. Strop závisí od plánu (Free 100, Starter/Pro 250); jeho prekročenie vráti 422 namiesto orezania. Musí byť aspoň 1. Nesmie byť väčší ako 100.

type
string voliteľné
cex

Obmedziť na typ burzy: cex alebo dex (určené podľa taxonómie búrz).

Jedna z hodnôt: cex dex

search
string voliteľné
binance

Voľnotextová zhoda v názve burzy. Nesmie byť dlhšie ako 100 znakov.

min_pairs
integer voliteľné
100

Len burzy, ktoré ponúkajú aspoň tento počet párov. Musí byť aspoň 0.

max_pairs
integer voliteľné
2000

Len burzy, ktoré ponúkajú najviac tento počet párov. Musí byť aspoň 0.

min_assets
integer voliteľné
50

Len burzy, ktoré ponúkajú aspoň tento počet aktív. Musí byť aspoň 0.

max_assets
integer voliteľné
1000

Len burzy, ktoré ponúkajú najviac tento počet aktív. Musí byť aspoň 0.

min_volume
number voliteľné
1000000

Len burzy s 24h objemom v USD na úrovni tejto hodnoty alebo vyšším. Musí byť aspoň 0.

max_volume
number voliteľné
100000000000

Len burzy s 24h objemom v USD na úrovni tejto hodnoty alebo nižším. Musí byť aspoň 0.

ids
string voliteľné
1,12

Obmedziť na konkrétne id búrz (CSV, až 100). Nesmie byť dlhšie ako 1000 znakov.

slugs
string voliteľné
binance-exchange,gateio

Obmedziť na konkrétne slugy búrz (CSV, až 100). Nesmie byť dlhšie ako 2000 znakov.

sort
string voliteľné
-volume

Polia na zoradenie oddelené čiarkou; s predponou - pre zostupné poradie. Zoraditeľné: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets. Nesmie byť dlhšie ako 100 znakov.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/exchanges?page=1&per_page=50&type=cex&search=binance&min_pairs=100&max_pairs=2000&min_assets=50&max_assets=1000&min_volume=1000000&max_volume=100000000000&ids=1%2C12&slugs=binance-exchange%2Cgateio&sort=-volume" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Získať detail burzy

Free

Úplný profil jednej burzy: poradie, objem/dominancia, počty párov a aktív, dátum established, location, referral website a odvodený type (cex/dex/null).

GET
https://bitculator.com/api/v1/exchanges/{slug}
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
binance-exchange

Slug burzy.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/exchanges/binance-exchange" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Získať skóre dôvery burzy

Free

Súhrnné skóre dôvery score v rozsahu 0–10 plus jeho 13-faktorový rozpis breakdown (rank, volume, age, volume_trend, stability, rank_stability, ticker_health, pairs, community, assets, dominance, market_breadth, transparency). Počíta sa pre každú burzu a ukladá do vyrovnávacej pamäte na 24 h.

Burza bez poradia (zatiaľ bez aktívneho spotového objemu, takže rank je null) sa nehodnotí: score aj breakdown sú null.

GET
https://bitculator.com/api/v1/exchanges/{slug}/trust-score
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
binance-exchange

Slug burzy.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/exchanges/binance-exchange/trust-score" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

História burzy

Starter

Časové rady objemu / dominancie / párov / aktív (agregácie búrz neobsahujú OHLC). Zvoľte interval: minutely, hourly alebo daily. Doba uchovávania je pevnou vlastnosťou agregačného reťazca – minutely 8 dní, hourly 6 mesiacov, daily navždy; ak je nastavený limit, dostanete najnovších N riadkov v okne, od najstaršieho.

GET
https://bitculator.com/api/v1/exchanges/{slug}/history
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
binance-exchange

Slug burzy.

Parametre dopytu

interval
string voliteľné
daily

minutely, hourly alebo daily (predvolene daily).

start
string voliteľné
2026-06-01

Dolná hranica dátumu/času ISO.

end
string voliteľné
2026-06-30

Horná hranica dátumu/času ISO (hodnota len s dátumom znamená vrátane celého daného dňa).

limit
integer voliteľné
30

Maximálny počet riadkov (1–2000, predvolene 1000).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/exchanges/binance-exchange/history?interval=daily&start=2026-06-01&end=2026-06-30&limit=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Sparkline burzy

Starter

Rad hodnôt objemovej mikrokrivky burzy za dané obdobie (predvolene 7d) – ten istý rad, aký vykresľujú riadky búrz na webe.

points je vzorka najviac 480 meraní, od najstaršieho, každé s hodnotou volume v čase time vo formáte ISO-8601. low a high sú skutočné extrémy celého obdobia – ohraničujú každý bod, no nemusia byť medzi vzorkovanými. change je pohyb za celé obdobie v PERCENTÁCH (1.25 znamená +1,25 %).

GET
https://bitculator.com/api/v1/exchanges/{slug}/sparkline
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
binance-exchange

Slug burzy.

Parametre dopytu

period
string voliteľné
7d

Jedna z hodnôt 24h, 7d (predvolená), 30d, 60d, 90d, 180d, 365d.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/exchanges/binance-exchange/sparkline?period=7d" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Trhy burzy

Free

Tickerové listingy burzy (jej trhy), stránkované. Sú už obmedzené na danú burzu – parameter exchange tu neodovzdávajte.

GET
https://bitculator.com/api/v1/exchanges/{slug}/tickers
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
binance-exchange

Slug burzy.

Parametre dopytu

page
integer voliteľné
1

Číslo strany (počítané od 1). Musí byť aspoň 1.

per_page
integer voliteľné
50

Počet riadkov na stranu. Strop závisí od plánu (Free 100, Starter/Pro 250); jeho prekročenie vráti 422 namiesto orezania. Musí byť aspoň 1. Nesmie byť väčší ako 100.

exchange
string voliteľné
binance-exchange

Obmedziť na jedinú burzu podľa slugu (vynechajte pri zozname pre konkrétnu burzu, ktorý je už obmedzený). Musí zodpovedať regulárnemu výrazu /^[a-z0-9-]{1,120}$/.

pair
integer voliteľné
1

Obmedziť na jediný pár podľa id. Musí byť aspoň 1.

instrument
string voliteľné
spot

Typ inštrumentu: future, option, swap, spot alebo margin (akceptuje sa aj množné číslo).

Jedna z hodnôt: future option swap spot margin

search
string voliteľné
BTC

Voľnotextová zhoda v symbole tickera. Nesmie byť dlhšie ako 50 znakov.

min_volume
number voliteľné
1000000

Len tickery s 24h objemom v USD na úrovni tejto hodnoty alebo vyšším. Musí byť aspoň 0.

max_volume
number voliteľné
100000000000

Len tickery s 24h objemom v USD na úrovni tejto hodnoty alebo nižším. Musí byť aspoň 0.

min_change
number voliteľné
-50

Len tickery s 24h percentuálnou zmenou na úrovni tejto hodnoty alebo vyššou.

max_change
number voliteľné
50

Len tickery s 24h percentuálnou zmenou na úrovni tejto hodnoty alebo nižšou.

sort
string voliteľné
-volume_usd

Jedno pole na zoradenie (s predponou - pre zostupné poradie). Zoraditeľné: volume_usd, change_24h, price_usd, updated. Predvolené je -volume_usd. Nesmie byť dlhšie ako 100 znakov.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/exchanges/binance-exchange/tickers?page=1&per_page=50&exchange=binance-exchange&pair=1&instrument=spot&search=BTC&min_volume=1000000&max_volume=100000000000&min_change=-50&max_change=50&sort=-volume_usd" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Kryptomeny burzy

Free

Kryptomeny kótované na burze, vrátené v rovnakom tvare ako List coins a prijímajúce rovnaké filtre/zoradenie.

GET
https://bitculator.com/api/v1/exchanges/{slug}/assets
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
binance-exchange

Slug burzy.

Parametre dopytu

page
integer voliteľné
1

Číslo strany (počítané od 1). Musí byť aspoň 1.

per_page
integer voliteľné
50

Počet riadkov na stranu. Strop závisí od plánu (Free 100, Starter/Pro 250); jeho prekročenie vráti 422 namiesto orezania. Musí byť aspoň 1. Nesmie byť väčší ako 100.

type
string voliteľné
coin

Obmedziť na jediný typ aktíva: coin alebo token.

Jedna z hodnôt: coin token

status
string voliteľné
active

Stav listingu: active, delisted, untracked, progressing, awaiting alebo preparing. Predvolene všetky verejné stavy.

Jedna z hodnôt: active delisted untracked progressing awaiting preparing

search
string voliteľné
bitcoin

Voľnotextová zhoda v názve alebo symbole. Nesmie byť dlhšie ako 100 znakov.

min_price
number voliteľné
0.5

Len mince s cenou na úrovni tejto hodnoty v USD alebo vyššou. Musí byť aspoň 0.

max_price
number voliteľné
100000

Len mince s cenou na úrovni tejto hodnoty v USD alebo nižšou. Musí byť aspoň 0.

min_marketcap
number voliteľné
1000000

Len mince s trhovou kapitalizáciou v USD na úrovni tejto hodnoty alebo vyššou. Musí byť aspoň 0.

max_marketcap
number voliteľné
5000000000000

Len mince s trhovou kapitalizáciou v USD na úrovni tejto hodnoty alebo nižšou. Musí byť aspoň 0.

min_volume
number voliteľné
1000000

Len mince s 24h objemom v USD na úrovni tejto hodnoty alebo vyšším. Musí byť aspoň 0.

max_volume
number voliteľné
100000000000

Len mince s 24h objemom v USD na úrovni tejto hodnoty alebo nižším. Musí byť aspoň 0.

ids
string voliteľné
38,39

Obmedziť na konkrétne id kryptomien (CSV, až 100 selektorov spolu so slugs/symbols). Nesmie byť dlhšie ako 1000 znakov.

slugs
string voliteľné
bitcoin,ethereum

Obmedziť na konkrétne slugy kryptomien (CSV, až 100 selektorov spolu). Nesmie byť dlhšie ako 2000 znakov.

symbols
string voliteľné
BTC,ETH

Obmedziť na konkrétne symboly kryptomien (CSV, nerozlišujú sa veľké a malé písmená, až 100 selektorov spolu). Nesmie byť dlhšie ako 1000 znakov.

sort
string voliteľné
-marketcap

Polia na zoradenie oddelené čiarkou; s predponou - pre zostupné poradie. Zoraditeľné: marketcap, rank, price, volume_24h, change_24h, change_7d. Nesmie byť dlhšie ako 100 znakov.

interval
string voliteľné
24h

Okno pohybov cien, len pre /coins/gainers a /coins/losers: 24h alebo 7d.

Jedna z hodnôt: 24h 7d

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/exchanges/binance-exchange/assets?page=1&per_page=50&type=coin&status=active&search=bitcoin&min_price=0.5&max_price=100000&min_marketcap=1000000&max_marketcap=5000000000000&min_volume=1000000&max_volume=100000000000&ids=38%2C39&slugs=bitcoin%2Cethereum&symbols=BTC%2CETH&sort=-marketcap&interval=24h" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
5 koncových bodov

Peňaženky

Recenzie kryptomenových peňaženiek – skóre recenzie score, počet podporovaných aktív, počty výhod/nevýhod, cenový model a dátum vydania, plus zoskupená taxonómia značiek v odpovediach detailu/porovnania. meta.top_score je najvyššie skóre spomedzi všetkých peňaženiek (použite ho na normalizáciu skóre do rozsahu 0–1).

Zoznam peňaženiek

Free

Recenzované peňaženky so skóre, počtom aktív, počtami výhod/nevýhod, cenovým modelom, stavom a dátumom vydania. Stránkované obálkou links + meta z Laravelu, plus meta.top_score.

GET
https://bitculator.com/api/v1/wallets
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

page
integer voliteľné
1

Číslo strany (počítané od 1). Musí byť aspoň 1.

per_page
integer voliteľné
50

Počet riadkov na stranu. Strop závisí od plánu (Free 100, Starter/Pro 250); jeho prekročenie vráti 422 namiesto orezania. Musí byť aspoň 1. Nesmie byť väčší ako 100.

search
string voliteľné
ledger

Voľnotextová zhoda v názve peňaženky. Nesmie byť dlhšie ako 100 znakov.

min_score
integer voliteľné
50

Len peňaženky s hodnotením recenzie na úrovni tejto hodnoty alebo vyšším. Musí byť aspoň 0.

max_score
integer voliteľné
214

Len peňaženky s hodnotením recenzie na úrovni tejto hodnoty alebo nižším. Musí byť aspoň 0.

tags
string voliteľné
12,34

Filtrovať podľa taxonómie značiek: id skupín kategórií oddelené čiarkou (rovnaké id, aké odosielajú webové fazetové filtre). Nesmie byť dlhšie ako 1000 znakov.

ids
string voliteľné
175,317

Obmedziť na konkrétne id peňaženiek (CSV, až 100). Nesmie byť dlhšie ako 1000 znakov.

slugs
string voliteľné
frostsnap,coin98-fusion-card

Obmedziť na konkrétne slugy peňaženiek (CSV, až 100). Nesmie byť dlhšie ako 2000 znakov.

sort
string voliteľné
-score

Polia na zoradenie oddelené čiarkou; s predponou - pre zostupné poradie. Zoraditeľné: score, released_at, assets, pros, cons. Nesmie byť dlhšie ako 100 znakov.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/wallets?page=1&per_page=50&search=ledger&min_score=50&max_score=214&tags=12%2C34&ids=175%2C317&slugs=frostsnap%2Ccoin98-fusion-card&sort=-score" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Časová os vydaní peňaženky

Free

Zoznam peňaženiek pevne zoradený podľa released_at zostupne (peňaženky bez dátumu nakoniec). Rovnaký tvar riadkov a stránkovacia obálka ako List wallets.

GET
https://bitculator.com/api/v1/wallets/timeline
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

page
integer voliteľné
1

Číslo strany (počítané od 1). Musí byť aspoň 1.

per_page
integer voliteľné
50

Počet riadkov na stranu. Strop závisí od plánu (Free 100, Starter/Pro 250); jeho prekročenie vráti 422 namiesto orezania. Musí byť aspoň 1. Nesmie byť väčší ako 100.

search
string voliteľné
ledger

Voľnotextová zhoda v názve peňaženky. Nesmie byť dlhšie ako 100 znakov.

min_score
integer voliteľné
50

Len peňaženky s hodnotením recenzie na úrovni tejto hodnoty alebo vyšším. Musí byť aspoň 0.

max_score
integer voliteľné
214

Len peňaženky s hodnotením recenzie na úrovni tejto hodnoty alebo nižším. Musí byť aspoň 0.

tags
string voliteľné
12,34

Filtrovať podľa taxonómie značiek: id skupín kategórií oddelené čiarkou (rovnaké id, aké odosielajú webové fazetové filtre). Nesmie byť dlhšie ako 1000 znakov.

ids
string voliteľné
175,317

Obmedziť na konkrétne id peňaženiek (CSV, až 100). Nesmie byť dlhšie ako 1000 znakov.

slugs
string voliteľné
frostsnap,coin98-fusion-card

Obmedziť na konkrétne slugy peňaženiek (CSV, až 100). Nesmie byť dlhšie ako 2000 znakov.

sort
string voliteľné
-score

Polia na zoradenie oddelené čiarkou; s predponou - pre zostupné poradie. Zoraditeľné: score, released_at, assets, pros, cons. Nesmie byť dlhšie ako 100 znakov.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/wallets/timeline?page=1&per_page=50&search=ledger&min_score=50&max_score=214&tags=12%2C34&ids=175%2C317&slugs=frostsnap%2Ccoin98-fusion-card&sort=-score" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Porovnať peňaženky

Free

Porovnanie 2–4 peňaženiek vedľa seba s ich úplnou zoskupenou taxonómiou značiek. data[] zachováva poradie požadovaných slugov, takže klienti môžu vykresliť stĺpce podľa pozície.

GET
https://bitculator.com/api/v1/wallets/compare
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

slugs
string povinné
frostsnap,coin98-fusion-card

2–4 rôzne slugy peňaženiek oddelené čiarkou.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/wallets/compare?slugs=frostsnap%2Ccoin98-fusion-card" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Získať detail peňaženky

Free

Úplný profil jednej peňaženky vrátane zoskupenej taxonómie značiek: categories je zoznam {group, tags[]}, kde každá značka má slug, názov a voliteľnú hodnotu. meta.top_score je najvyššie skóre spomedzi všetkých peňaženiek.

GET
https://bitculator.com/api/v1/wallets/{slug}
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
frostsnap

Slug peňaženky.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/wallets/frostsnap" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Kryptomeny podporované peňaženkou

Free

Kryptomeny, ktoré peňaženka podporuje, vrátené v rovnakom tvare ako List coins a prijímajúce rovnaké filtre/zoradenie.

GET
https://bitculator.com/api/v1/wallets/{slug}/assets
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
frostsnap

Slug peňaženky.

Parametre dopytu

page
integer voliteľné
1

Číslo strany (počítané od 1). Musí byť aspoň 1.

per_page
integer voliteľné
50

Počet riadkov na stranu. Strop závisí od plánu (Free 100, Starter/Pro 250); jeho prekročenie vráti 422 namiesto orezania. Musí byť aspoň 1. Nesmie byť väčší ako 100.

type
string voliteľné
coin

Obmedziť na jediný typ aktíva: coin alebo token.

Jedna z hodnôt: coin token

status
string voliteľné
active

Stav listingu: active, delisted, untracked, progressing, awaiting alebo preparing. Predvolene všetky verejné stavy.

Jedna z hodnôt: active delisted untracked progressing awaiting preparing

search
string voliteľné
bitcoin

Voľnotextová zhoda v názve alebo symbole. Nesmie byť dlhšie ako 100 znakov.

min_price
number voliteľné
0.5

Len mince s cenou na úrovni tejto hodnoty v USD alebo vyššou. Musí byť aspoň 0.

max_price
number voliteľné
100000

Len mince s cenou na úrovni tejto hodnoty v USD alebo nižšou. Musí byť aspoň 0.

min_marketcap
number voliteľné
1000000

Len mince s trhovou kapitalizáciou v USD na úrovni tejto hodnoty alebo vyššou. Musí byť aspoň 0.

max_marketcap
number voliteľné
5000000000000

Len mince s trhovou kapitalizáciou v USD na úrovni tejto hodnoty alebo nižšou. Musí byť aspoň 0.

min_volume
number voliteľné
1000000

Len mince s 24h objemom v USD na úrovni tejto hodnoty alebo vyšším. Musí byť aspoň 0.

max_volume
number voliteľné
100000000000

Len mince s 24h objemom v USD na úrovni tejto hodnoty alebo nižším. Musí byť aspoň 0.

ids
string voliteľné
38,39

Obmedziť na konkrétne id kryptomien (CSV, až 100 selektorov spolu so slugs/symbols). Nesmie byť dlhšie ako 1000 znakov.

slugs
string voliteľné
bitcoin,ethereum

Obmedziť na konkrétne slugy kryptomien (CSV, až 100 selektorov spolu). Nesmie byť dlhšie ako 2000 znakov.

symbols
string voliteľné
BTC,ETH

Obmedziť na konkrétne symboly kryptomien (CSV, nerozlišujú sa veľké a malé písmená, až 100 selektorov spolu). Nesmie byť dlhšie ako 1000 znakov.

sort
string voliteľné
-marketcap

Polia na zoradenie oddelené čiarkou; s predponou - pre zostupné poradie. Zoraditeľné: marketcap, rank, price, volume_24h, change_24h, change_7d. Nesmie byť dlhšie ako 100 znakov.

interval
string voliteľné
24h

Okno pohybov cien, len pre /coins/gainers a /coins/losers: 24h alebo 7d.

Jedna z hodnôt: 24h 7d

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/wallets/frostsnap/assets?page=1&per_page=50&type=coin&status=active&search=bitcoin&min_price=0.5&max_price=100000&min_marketcap=1000000&max_marketcap=5000000000000&min_volume=1000000&max_volume=100000000000&ids=38%2C39&slugs=bitcoin%2Cethereum&symbols=BTC%2CETH&sort=-marketcap&interval=24h" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
3 koncových bodov

Globálny trh

Celotrhové agregáty – celková trhová kapitalizácia a objem, počty aktív/búrz/párov/trhov, dominancia BTC/ETH s top-3 podľa poradia, celotrhová hodnota indexu Strach a chamtivosť, plus teplotná mapa top 100 a história trhovej kapitalizácie a objemu.

Snímka globálneho trhu

Free

Jednorazový prehľad trhu: celková trhová kapitalizácia a 24h objem, počty kryptomien / tokenov / búrz / párov / trhov, dominance (podiel BTC a ETH plus top3 podľa poradia) a celotrhová hodnota fear_greed. index: index Fear & Greed 0–100 tak, ako ho zobrazuje Bitculator – používajte ho na zobrazenie; score: surová zložená hodnota −100…+100, z ktorej sa index odvodzuje.

GET
https://bitculator.com/api/v1/global
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/global" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Teplotná mapa trhu

Starter

Riadky stromovej mapy top 100 plus rámcové štatistiky (celková trhová kapitalizácia a objem, dominancia a trhové skóre Strach a chamtivosť) – API dvojička webovej teplotnej mapy. V meta.fear_greed: index: index Fear & Greed 0–100 tak, ako ho zobrazuje Bitculator – používajte ho na zobrazenie; score: surová zložená hodnota −100…+100, z ktorej sa index odvodzuje.

GET
https://bitculator.com/api/v1/global/heatmap
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/global/heatmap" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

História globálnej trhovej kapitalizácie / objemu

Starter

Časové rady celého trhu pre marketcap alebo volume. Granularita sa riadi parametrom period: 24h = polhodinová, 7d = hodinová, 30d/all = denná (jemnejšie agregácie sa mažú).

GET
https://bitculator.com/api/v1/global/history/{metric}
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

metric
string povinné
marketcap

Ktorý rad: marketcap alebo volume.

Parametre dopytu

period
string voliteľné
7d

24h, 7d, 30d alebo all (predvolené 24h).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/global/history/marketcap?period=7d" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
4 koncových bodov

Sentiment

Indexy sentimentu pre celý trh aj pre jednotlivé mince. Strach a chamtivosť a Bull/Bear sú SNÍMKY obnovované každých 15 minút – existuje len aktuálna hodnota, nemajú žiadny časový rad. Altseason nesie úplnú dennú históriu. indicators je celotrhový technický súhrn.

Index strachu a chamtivosti

Free

Aktuálna hodnota indexu Strach a chamtivosť (15-minútová snímka – bez histórie). Vynechajte coin pre celotrhový index alebo odovzdajte slug mince pre hodnotu jednej mince. intervals nesie čiastkové skóre za 7d/30d a rozpis ich zložiek.

index: index Fear & Greed 0–100 tak, ako ho zobrazuje Bitculator – používajte ho na zobrazenie (0–19 extrémny strach, 20–39 strach, 40–59 neutrálne, 60–79 chamtivosť, 80–100 extrémna chamtivosť). score: surová zložená hodnota −100…+100, z ktorej sa index odvodzuje. Každý interval obsahuje obe polia.

GET
https://bitculator.com/api/v1/sentiment/fear-greed
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

coin
string voliteľné
bitcoin

Slug kryptomeny pre hodnotu za jednu kryptomenu; vynechajte pre trhový index.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/sentiment/fear-greed?coin=bitcoin" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Index býk / medveď

Starter

Aktuálna hodnota Bull/Bear (15-minútová snímka – bez histórie). Vynechajte coin pre celotrhový index alebo odovzdajte slug mince pre hodnotu jednej mince.

GET
https://bitculator.com/api/v1/sentiment/bull-bear
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

coin
string voliteľné
bitcoin

Slug kryptomeny pre hodnotu za jednu kryptomenu; vynechajte pre trhový index.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/sentiment/bull-bear?coin=bitcoin" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Index altseason

Starter

Aktuálna hodnota altseason (počet mincí, ktoré prekonávajú BTC v rámci top 100), s voliteľnou dennou history. Na rozdiel od indexu Strach a chamtivosť má altseason úplnú dennú históriu – zahrniete ju odovzdaním days.

GET
https://bitculator.com/api/v1/sentiment/altseason
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

days
integer voliteľné
30

Počet dní dennej histórie, ktoré sa majú zahrnúť (1–365; 0/vynechané = len aktuálne).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/sentiment/altseason?days=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Súhrn trhových indikátorov

Pro

Celotrhový technický súhrn – 25 zosumarizovaných kategórií indikátorov, každá s aktuálnym stavom, skóre a údajmi kategórie.

GET
https://bitculator.com/api/v1/sentiment/indicators
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/sentiment/indicators" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
14 koncových bodov

Indikátory

Technické indikátory pre jednotlivé mince. Každý indikátor má vlastný koncový bod – oscilátory dynamiky (RSI, Stoch-RSI, CCI, MFI, Williams %R), trendové a cenové základne (SMA, MACD, VWAP), tok objemu (OBV, CMF), sila trendu (ADX) a volatilita – plus jedna spoločná snímka viacerých indikátorov. Každá rodina je DENNÝ rad počítaný z denných sviečok (plné uchovávanie; mladé aktíva vracajú na začiatku zahrievacie hodnoty null, kým nie je dosť histórie). Rodiny v cenovej škále (SMA, VWAP, MACD, OBV) vracajú desatinné reťazce, ohraničené oscilátory vracajú čísla. Niekoľko období s dlhým oknom vyžaduje platený plán – uvedené pri každom koncovom bode.

Snímka indikátorov

Pro

Snímka viacerých indikátorov – najnovší state každej kategórie indikátorov (bullish/bearish/sheepish…), score a surové data v jednej odpovedi. Ideálne na rýchly pohľad v prehľadovom paneli; pre úplnú dennú históriu použite vyhradené koncové body jednotlivých indikátorov nižšie.

GET
https://bitculator.com/api/v1/coins/{slug}/indicators
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Slug mince.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin/indicators" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

RSI (Relative Strength Index)

Starter

Denný Relative Strength Index – oscilátor dynamiky ohraničený 0–100, ktorý meria rýchlosť a veľkosť nedávnych cenových pohybov. Nad 70 sa bežne považuje za prekúpené, pod 30 za prepredané. Okná: 7, 14, 21, 28 dní (predvolené 14) – 21- a 28-dňové okno vyžaduje plán Starter alebo vyšší. Mladé kryptomeny vracajú na začiatku zahrievacie hodnoty null.

GET
https://bitculator.com/api/v1/coins/{slug}/indicators/rsi
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Slug mince.

Parametre dopytu

period
integer voliteľné
14

Dĺžka okna – jedna z hodnôt 7, 14, 21, 28 (predvolene 14).

start
string voliteľné
2026-06-01

Dolná hranica dátumu ISO.

end
string voliteľné
2026-06-30

Horná hranica dátumu ISO.

limit
integer voliteľné
30

Maximálny počet riadkov (1–1000, predvolene 365).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin/indicators/rsi?period=14&start=2026-06-01&end=2026-06-30&limit=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Stochastický RSI

Pro

Denný Stochastic RSI – aplikuje stochastický oscilátor na samotné RSI, čo dáva rýchlejší a citlivejší údaj o dynamike 0–100 s líniami %K a %D, ktoré sa krížia a signalizujú obraty. Okná: 7, 14, 21, 28 dní (predvolené 14) – 21- a 28-dňové okno vyžaduje plán Starter alebo vyšší.

GET
https://bitculator.com/api/v1/coins/{slug}/indicators/stoch-rsi
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Slug mince.

Parametre dopytu

period
integer voliteľné
14

Dĺžka okna – jedna z hodnôt 7, 14, 21, 28 (predvolene 14).

start
string voliteľné
2026-06-01

Dolná hranica dátumu ISO.

end
string voliteľné
2026-06-30

Horná hranica dátumu ISO.

limit
integer voliteľné
30

Maximálny počet riadkov (1–1000, predvolene 365).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin/indicators/stoch-rsi?period=14&start=2026-06-01&end=2026-06-30&limit=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

SMA (Simple Moving Average)

Starter

Denný Simple Moving Average – aritmetický priemer záverečnej ceny za okno, klasická trendová základňa, ktorú obchodníci čítajú kvôli podpore, rezistencii a zlatým/smrteľným krížom. Okná: 50, 100, 200 dní (predvolené 50). Hodnoty sú desatinné reťazce na cenovej škále.

GET
https://bitculator.com/api/v1/coins/{slug}/indicators/sma
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Slug mince.

Parametre dopytu

period
integer voliteľné
50

Dĺžka okna – jedna z hodnôt 50, 100, 200 (predvolene 50).

start
string voliteľné
2026-06-01

Dolná hranica dátumu ISO.

end
string voliteľné
2026-06-30

Horná hranica dátumu ISO.

limit
integer voliteľné
30

Maximálny počet riadkov (1–1000, predvolene 365).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin/indicators/sma?period=50&start=2026-06-01&end=2026-06-30&limit=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

CCI (Commodity Channel Index)

Starter

Denný Commodity Channel Index – meria, ako ďaleko sa cena odchýlila od svojho štatistického priemeru; hodnoty za hranicou ±100 signalizujú silné trendy alebo možné obrátenia. Okná: 20, 50, 100 dní (predvolené 20).

GET
https://bitculator.com/api/v1/coins/{slug}/indicators/cci
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Slug mince.

Parametre dopytu

period
integer voliteľné
20

Dĺžka okna – jedna z hodnôt 20, 50, 100 (predvolene 20).

start
string voliteľné
2026-06-01

Dolná hranica dátumu ISO.

end
string voliteľné
2026-06-30

Horná hranica dátumu ISO.

limit
integer voliteľné
30

Maximálny počet riadkov (1–1000, predvolene 365).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin/indicators/cci?period=20&start=2026-06-01&end=2026-06-30&limit=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

MFI (Money Flow Index)

Pro

Denný Money Flow Index – objemovo vážené RSI (0–100), ktoré zahŕňa obchodný objem do dynamiky, často nazývané „objemové RSI“; nad 80 prekúpené, pod 20 prepredané. Okná: 7, 14, 28 dní (predvolené 14).

GET
https://bitculator.com/api/v1/coins/{slug}/indicators/mfi
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Slug mince.

Parametre dopytu

period
integer voliteľné
14

Dĺžka okna – jedna z hodnôt 7, 14, 28 (predvolene 14).

start
string voliteľné
2026-06-01

Dolná hranica dátumu ISO.

end
string voliteľné
2026-06-30

Horná hranica dátumu ISO.

limit
integer voliteľné
30

Maximálny počet riadkov (1–1000, predvolene 365).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin/indicators/mfi?period=14&start=2026-06-01&end=2026-06-30&limit=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Williams %R

Pro

Denný Williams %R – oscilátor dynamiky ohraničený −100 – 0, ktorý ukazuje, kde sa záver nachádza v rámci nedávneho rozpätia maxima a minima; nad −20 prekúpené, pod −80 prepredané. Okná: 14, 20, 50 dní (predvolené 14).

GET
https://bitculator.com/api/v1/coins/{slug}/indicators/williams-r
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Slug mince.

Parametre dopytu

period
integer voliteľné
14

Dĺžka okna – jedna z hodnôt 14, 20, 50 (predvolene 14).

start
string voliteľné
2026-06-01

Dolná hranica dátumu ISO.

end
string voliteľné
2026-06-30

Horná hranica dátumu ISO.

limit
integer voliteľné
30

Maximálny počet riadkov (1–1000, predvolene 365).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin/indicators/williams-r?period=14&start=2026-06-01&end=2026-06-30&limit=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Cenová volatilita

Pro

Denný index cenovej volatility – rozptyl denných výnosov za okno, normalizovaný údaj o tom, aké rozkolísané boli cenové pohyby. Okná: 7, 14, 30 dní (predvolené 7) – 30-dňové okno vyžaduje plán Starter alebo vyšší.

GET
https://bitculator.com/api/v1/coins/{slug}/indicators/price-volatility
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Slug mince.

Parametre dopytu

period
integer voliteľné
7

Dĺžka okna – jedna z hodnôt 7, 14, 30 (predvolene 7).

start
string voliteľné
2026-06-01

Dolná hranica dátumu ISO.

end
string voliteľné
2026-06-30

Horná hranica dátumu ISO.

limit
integer voliteľné
30

Maximálny počet riadkov (1–1000, predvolene 365).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin/indicators/price-volatility?period=7&start=2026-06-01&end=2026-06-30&limit=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Objemová volatilita

Starter

Denný index objemovej volatility – rozptyl denného obchodného objemu za okno, údaj o tom, aká nestála bola účasť na trhu. Okná: 7, 14, 30 dní (predvolené 7) – 30-dňové okno vyžaduje plán Starter alebo vyšší.

GET
https://bitculator.com/api/v1/coins/{slug}/indicators/volume-volatility
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Slug mince.

Parametre dopytu

period
integer voliteľné
7

Dĺžka okna – jedna z hodnôt 7, 14, 30 (predvolene 7).

start
string voliteľné
2026-06-01

Dolná hranica dátumu ISO.

end
string voliteľné
2026-06-30

Horná hranica dátumu ISO.

limit
integer voliteľné
30

Maximálny počet riadkov (1–1000, predvolene 365).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin/indicators/volume-volatility?period=7&start=2026-06-01&end=2026-06-30&limit=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

MACD

Pro

Denný MACD (Moving Average Convergence Divergence) – rozdiel 12/26 EMA so signálnou líniou s periódou 9 a histogramom, základný indikátor trendu a dynamiky, ktorý sa číta cez kríženia signálnej línie a posuny okolo nulovej línie. Vracia macd, signal a histogram ako desatinné reťazce. Bez parametra okna.

GET
https://bitculator.com/api/v1/coins/{slug}/indicators/macd
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Slug mince.

Parametre dopytu

start
string voliteľné
2026-06-01

Dolná hranica dátumu ISO.

end
string voliteľné
2026-06-30

Horná hranica dátumu ISO.

limit
integer voliteľné
30

Maximálny počet riadkov (1–1000, predvolene 365).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin/indicators/macd?start=2026-06-01&end=2026-06-30&limit=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

OBV (On-Balance Volume)

Pro

Denný On-Balance Volume – kumulatívna objemová línia, ktorá pripočítava objem v rastových dňoch a odpočítava ho v klesajúcich, sleduje čistý nákupný vs. predajný tlak a potvrdzuje cenové trendy (alebo sa od nich odchyľuje). Jeden rad desatinných reťazcov.

GET
https://bitculator.com/api/v1/coins/{slug}/indicators/obv
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Slug mince.

Parametre dopytu

start
string voliteľné
2026-06-01

Dolná hranica dátumu ISO.

end
string voliteľné
2026-06-30

Horná hranica dátumu ISO.

limit
integer voliteľné
30

Maximálny počet riadkov (1–1000, predvolene 365).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin/indicators/obv?start=2026-06-01&end=2026-06-30&limit=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

ADX (Average Directional Index)

Starter

Denné ADX s +DI/−DI – meria silu trendu (adx) a smer (smerové indikátory plus_di/minus_di). ADX nad 25 signalizuje silný trend bez ohľadu na smer; kríženie DI ukazuje, ktorým smerom. Jeden rad, bez parametra okna.

GET
https://bitculator.com/api/v1/coins/{slug}/indicators/adx
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Slug mince.

Parametre dopytu

start
string voliteľné
2026-06-01

Dolná hranica dátumu ISO.

end
string voliteľné
2026-06-30

Horná hranica dátumu ISO.

limit
integer voliteľné
30

Maximálny počet riadkov (1–1000, predvolene 365).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin/indicators/adx?start=2026-06-01&end=2026-06-30&limit=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

VWAP (Volume-Weighted Average Price)

Pro

Denný VWAP – priemerná cena vážená objemom, kľúčová referencia férovej hodnoty a kvality vykonania; cena nad VWAP sa číta ako býčia, pod ním ako medvedia. Jeden rad desatinných reťazcov, bez parametra okna.

GET
https://bitculator.com/api/v1/coins/{slug}/indicators/vwap
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Slug mince.

Parametre dopytu

start
string voliteľné
2026-06-01

Dolná hranica dátumu ISO.

end
string voliteľné
2026-06-30

Horná hranica dátumu ISO.

limit
integer voliteľné
30

Maximálny počet riadkov (1–1000, predvolene 365).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin/indicators/vwap?start=2026-06-01&end=2026-06-30&limit=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

CMF (Chaikin Money Flow)

Starter

Denný Chaikin Money Flow – sčítava objem peňažného toku za obdobie a odhaduje akumuláciu vs. distribúciu; kladná hodnota znamená čistý nákupný tlak, záporná predajný. Pohybuje sa približne v rozsahu ±1. Jeden rad, bez parametra okna.

GET
https://bitculator.com/api/v1/coins/{slug}/indicators/cmf
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Slug mince.

Parametre dopytu

start
string voliteľné
2026-06-01

Dolná hranica dátumu ISO.

end
string voliteľné
2026-06-30

Horná hranica dátumu ISO.

limit
integer voliteľné
30

Maximálny počet riadkov (1–1000, predvolene 365).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin/indicators/cmf?start=2026-06-01&end=2026-06-30&limit=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
3 koncových bodov

Prevod

Prevod medzi ľubovoľnými dvoma aktívnymi aktívami (kryptomeny AJ fiat) a zoznam mien použiteľných ako strany prevodu. Hodnoty sú desatinné reťazce. Fiat FX kurzy sa obnovujú ~dvakrát denne; kurzy kryptomien ~každú minútu.

Prevod medzi aktívami

Free

Konverzia na strane servera medzi ľubovoľnými dvoma aktívnymi aktívami (kryptomeny AJ fiat). to prijíma CSV pre konverziu na viac cieľov; opačný smer získate prehodením from/to. Konverzia je lineárna, takže value = unit_rate * amount. Kurzy fiat mien sa obnovujú ~dvakrát denne, kurzy kryptomien ~každú minútu.

GET
https://bitculator.com/api/v1/convert
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

from
string povinné
bitcoin

Slug zdrojového aktíva.

to
string povinné
ethereum

Slug(y) cieľového aktíva, oddelené čiarkou (najviac 10).

amount
number voliteľné
2.5

Množstvo zdrojového aktíva na prevod (predvolené 1).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/convert?from=bitcoin&to=ethereum&amount=2.5" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Zoznam fiat mien

Free

Aktívne fiat meny s ich kurzami voči USD: rate_per_usd (jednotiek na jeden USD) a jeho prevrátená hodnota usd_value. Kurzy fiat mien sa obnovujú ~dvakrát denne.

GET
https://bitculator.com/api/v1/fiats
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/fiats" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Zoznam konverzných kurzov

Free

Meny použiteľné ako strany konverzie – hlavné fiat meny, mince a tokeny – každá s normalizovanou hodnotou usd_value (USD za jednu jednotku). Hodnoty mincí a tokenov sa obnovujú ~každú minútu; pomalé fiat kurzy sú vo vyrovnávacej pamäti samostatne (~dvakrát denne).

GET
https://bitculator.com/api/v1/rates
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/rates" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
5 koncových bodov

Kalkulačky

Finančné kalkulačky na strane servera kopírujúce webové nástroje: DCA, zisk/strata a úver (čítajú trhové dáta z vyrovnávacej pamäte), plus bezstavové výpočty zloženého úročenia a stakingu.

DCA kalkulačka

Free

Spätný test dollar-cost averaging na reálnej dennej cenovej histórii kryptomeny: jeden nákup vo výške amount za každý interval medzi start a end. Odovzdaním series=true zahrniete úplný rad za každý nákup.

GET
https://bitculator.com/api/v1/calculators/dca
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

slug
string povinné
bitcoin

Identifikátor slug danej mince.

amount
number povinné
100

Suma v USD minutá na jeden nákup (0.01–1,000,000,000).

interval
string povinné
weekly

Frekvencia nákupov: daily, weekly, monthly, quarterly alebo yearly.

start
string povinné
2024-01-01

date Dátum prvého nákupu (po 2008-12-31).

end
string voliteľné
2025-01-01

date Dátum posledného nákupu (predvolene dnešok).

series
boolean voliteľné
false

Zahrnúť do payloadu rad za každý nákup.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/calculators/dca?slug=bitcoin&amount=100&interval=weekly&start=2024-01-01&end=2025-01-01&series=" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Kalkulačka zisku / straty

Free

Čo priniesol nákup a následný predaj medzi dvoma historickými dátumami, s použitím reálnych cien mince k týmto dátumom. Poplatky sú pevné sumy v USD, nie percentá.

GET
https://bitculator.com/api/v1/calculators/profit-loss
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

slug
string povinné
bitcoin

Identifikátor slug danej mince.

amount
number povinné
1000

Suma v USD investovaná k dátumu buy_date (0.01–1,000,000,000).

buy_date
string povinné
2023-01-01

date Dátum nákupu.

sell_date
string povinné
2025-01-01

date Dátum predaja (v deň buy_date alebo po ňom).

buy_fee
number voliteľné
10

Pevný poplatok za nákup v USD (predvolené 0).

sell_fee
number voliteľné
10

Pevný poplatok za predaj v USD (predvolené 0).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/calculators/profit-loss?slug=bitcoin&amount=1000&buy_date=2023-01-01&sell_date=2025-01-01&buy_fee=10&sell_fee=10" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Kalkulačka zloženého úročenia

Free

Čistá matematika – žiadne trhové dáta. rate je ročná nominálna sadzba: každé úročiace obdobie pripíše rate vydelenú počtom období za rok (5 % pri mesačnom úročení znamená 5/12 % mesačne).

GET
https://bitculator.com/api/v1/calculators/compound-interest
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

principal
number povinné
10000

Počiatočný zostatok v USD.

rate
number povinné
5

Ročná úroková sadzba v % (nominálna, rovnomerne rozdelená medzi obdobia úročenia).

duration
integer povinné
5

Dĺžka projekcie (roky sú obmedzené na 50).

duration_unit
string voliteľné
years

years (predvolené) alebo months.

compound_frequency
string voliteľné
monthly

daily, weekly, monthly (predvolené), quarterly alebo annually.

contribution
number voliteľné
100

Opakovaný vklad v USD (predvolene 0).

contribution_frequency
string voliteľné
monthly

daily, weekly, monthly (predvolené), quarterly alebo annually.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/calculators/compound-interest?principal=10000&rate=5&duration=5&duration_unit=years&compound_frequency=monthly&contribution=100&contribution_frequency=monthly" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Kalkulačka úver vs. predaj

Free

Pôžička zabezpečená kryptomenou vs. jej predaj – porovnáva oba scenáre pomocou AKTUÁLNEJ ceny kryptomeny. Informatívna projekcia, nie finančné poradenstvo.

GET
https://bitculator.com/api/v1/calculators/loan
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

slug
string povinné
bitcoin

Identifikátor slug danej mince.

crypto_amount
number povinné
2

Koľko danej kryptomeny držíte.

needed_cash
number povinné
50000

Suma v USD, ktorú potrebujete uvoľniť.

term_months
integer voliteľné
36

Doba splatnosti úveru v mesiacoch (predvolene 36).

interest_rate
number voliteľné
10

Ročná úroková sadzba (APR) úveru v % (predvolene 10).

ltv
number voliteľné
50

Pomer úveru k hodnote (LTV) v % (predvolene 50).

expected_growth
number voliteľné
25

Očakávaný rast ceny kryptomeny za obdobie v % (predvolené 25).

tax_rate
number voliteľné
25

Daň z kapitálových výnosov v %, uplatnená na predaj (predvolené 25).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/calculators/loan?slug=bitcoin&crypto_amount=2&needed_cash=50000&term_months=36&interest_rate=10&ltv=50&expected_growth=25&tax_rate=25" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Kalkulačka odmien zo stakingu

Free

Čistá matematika – odmeny zo stakingu s voliteľným zloženým úročením a províziou validátora. Nečítajú sa žiadne trhové dáta.

GET
https://bitculator.com/api/v1/calculators/staking
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

amount
number povinné
1000

Stakovaná suma v jednotkách stakovaného aktíva.

period
number povinné
2

Dĺžka obdobia stakingu (obmedzená na ekvivalent 50 rokov).

period_unit
string voliteľné
years

years (predvolené), months alebo days.

apy
number povinné
5

Inzerované APY v %.

compound_frequency
string voliteľné
monthly

never, daily, weekly, monthly (predvolené) alebo yearly.

commission
number voliteľné
10

Provízia validátora v %, odoberaná z odmien (predvolene 0).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/calculators/staking?amount=1000&period=2&period_unit=years&apy=5&compound_frequency=monthly&commission=10" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
8 koncových bodov

Redakcia

Redakčné články – len publikované (ACTIVE). locale určuje jazyk obsahu s anglickým záložným variantom pre každé pole (payload uvádza, ktorý locale skutočne zvíťazil). Články možno filtrovať podľa značky alebo podľa súvisiaceho slugu kryptomeny/burzy/peňaženky. Čítania cez API zámerne NEZVYŠUJÚ počty zobrazení.

Videá kryptomeny

Free

Kurátorsky vybrané videá pripojené ku kryptomene (karta Videá na stránke kryptomeny), stránkované.

GET
https://bitculator.com/api/v1/coins/{slug}/videos
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Identifikátor slug danej mince.

Parametre dopytu

page
integer voliteľné
1

Číslo strany (počítané od 1).

per_page
integer voliteľné
10

Počet riadkov na stranu (1–50, predvolene 10).

type
string voliteľné
review

Filtrovať podľa typu videa (napr. overview, tutorial, explainer, review, analysis, news).

search
string voliteľné
halving

Voľnotextová zhoda v názve.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin/videos?page=1&per_page=10&type=review&search=halving" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Časová os postrehov kryptomeny

Free

Časová os postrehov k danej minci – rovnaké dáta, aké používa panel postrehov na stránke aktíva, ohraničené pomocou offset/limit.

GET
https://bitculator.com/api/v1/coins/{slug}/insights
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
bitcoin

Identifikátor slug danej mince.

Parametre dopytu

locale
string voliteľné
en

Jazyk obsahu (záložným jazykom je angličtina).

offset
integer voliteľné
0

Počet riadkov na preskočenie (0–500, predvolene 0).

limit
integer voliteľné
5

Počet riadkov na vrátenie (1–50, predvolene 5).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/coins/bitcoin/insights?locale=en&offset=0&limit=5" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Zoznam článkov

Free

Publikované články, najnovšie ako prvé, stránkované. Filtrujte podľa tag alebo podľa slugu súvisiacej entity v parametri coin / exchange / wallet, prípadne voľným textom search. Každý riadok je zhrnutie (názov, podnadpis, značky, čas čítania, hlavný obrázok, súvisiace entity, dátumy).

GET
https://bitculator.com/api/v1/articles
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

page
integer voliteľné
1

Číslo strany (počítané od 1).

per_page
integer voliteľné
20

Počet riadkov na stranu (1–50, predvolene 20).

locale
string voliteľné
en

Jazyk obsahu (záložným jazykom je angličtina).

tag
string voliteľné
guide

Filtrovať podľa značky: news, guide, tutorial, explainer, analysis, review, trading, overview alebo information.

coin
string voliteľné
bitcoin

Obmedziť na články súvisiace s týmto slugom kryptomeny.

exchange
string voliteľné
binance-exchange

Obmedziť na články súvisiace s týmto slugom burzy.

wallet
string voliteľné
frostsnap

Obmedziť na články súvisiace s týmto slugom peňaženky.

search
string voliteľné
halving

Voľnotextová zhoda v nadpise/podnadpise.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/articles?page=1&per_page=20&locale=en&tag=guide&coin=bitcoin&exchange=binance-exchange&wallet=frostsnap&search=halving" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Získať článok

Free

Jeden publikovaný článok s celým textom, značkami, hlavným obrázkom, počítadlami užitočnosti a súvisiacimi entitami. locale volí jazyk obsahu s anglickým záložným textom po jednotlivých poliach (odpoveď uvádza, ktorý jazyk sa nakoniec použil).

GET
https://bitculator.com/api/v1/articles/{slug}
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
what-is-bitcoin

Slug článku.

Parametre dopytu

locale
string voliteľné
en

Jazyk obsahu (záložným jazykom je angličtina).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/articles/what-is-bitcoin?locale=en" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Odoslať spätnú väzbu k článku

Free

Zaznamená palec hore/dole pri článku – tie isté počítadlá, aké používajú webové tlačidlá užitočnosti. Vyššie v reťazci platí obmedzenie počtu požiadaviek na kľúč.

POST
https://bitculator.com/api/v1/articles/{slug}/feedback
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

slug
string povinné
what-is-bitcoin

Slug článku.

Parametre tela

helpful
boolean povinné
true

true pre užitočné, false pre neužitočné.

Požiadavka

curl --request POST \
    "https://bitculator.com/api/v1/articles/what-is-bitcoin/feedback" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"helpful\": true
}"

Získať video

Free

Jedno kurátorsky vybrané video s jeho YouTube id, názvom, typom, dĺžkou a mincami/burzami/peňaženkami, ku ktorým je pripojené.

GET
https://bitculator.com/api/v1/videos/{id}
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

id
integer povinné
87

Id videa.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/videos/87" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Zoznam postrehov

Free

Trhové postrehy generované AI, stránkované. Filtrujte podľa type, súvisiaceho slugu coin alebo voľného textu search; locale určuje jazyk titulku/zhrnutia s anglickým záložným variantom.

GET
https://bitculator.com/api/v1/insights
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

page
integer voliteľné
1

Číslo strany (počítané od 1).

per_page
integer voliteľné
20

Počet riadkov na stranu (1–50, predvolene 20).

locale
string voliteľné
en

Jazyk obsahu (záložným jazykom je angličtina).

type
string voliteľné
per_asset

Filtrovať podľa typu postrehu: per_asset, market_overview alebo narrative.

coin
string voliteľné
bitcoin

Obmedziť na postrehy súvisiace s týmto slugom kryptomeny.

search
string voliteľné
etf

Voľnotextová zhoda v titulku.

sort
string voliteľné
first_reported

Poradie zoradenia: first_reported (predvolené) alebo last_updated.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/insights?page=1&per_page=20&locale=en&type=per_asset&coin=bitcoin&search=etf&sort=first_reported" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Získať postreh

Free

Jeden postreh s celým obsahom – titulok, zhrnutie, časová os zdrojových článkov a súvisiace mince.

GET
https://bitculator.com/api/v1/insights/{id}
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

id
integer povinné
101

Id postrehu.

Parametre dopytu

locale
string voliteľné
en

Jazyk obsahu (záložným jazykom je angličtina).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/insights/101?locale=en" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
3 koncových bodov

Alarmy

CRUD cenových alarmov – tie isté alarmy, aké spravuje webová aplikácia. Alarmy čerpajú zostatok alarmov z inventára vlastníka kľúča, sú typu TARGET a len na minciach, pričom ochrana above/below voči aktuálnej hodnote blokuje alarmy, ktoré by sa okamžite samy spustili. Viažu sa na kľúč (API kľúč určuje vlastníka) a ich odpovede sa nikdy neukladajú do vyrovnávacej pamäte.

Zoznam alarmov

Free

Alarmy vlastníka kľúča, najnovšie ako prvé, stránkované. Filtrujte podľa status, direction alebo kanála notification.

GET
https://bitculator.com/api/v1/alarms
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre dopytu

page
integer voliteľné
1

Číslo strany (počítané od 1).

per_page
integer voliteľné
25

Počet riadkov na stranu (1–100, predvolene 25).

status
string voliteľné
active

Filtrovať podľa stavu: active alebo triggered.

direction
string voliteľné
above

Filtrovať podľa smeru spustenia: above alebo below.

notification
string voliteľné
email

Filtrovať podľa kanála doručenia: email, push alebo webhook.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/alarms?page=1&per_page=25&status=active&direction=above&notification=email" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Vytvoriť alarm

Free

Vytvorí cieľový (TARGET) alarm na kryptomene a spotrebuje jeden slot alarmu zo zostatku vlastníka kľúča. Cieľ sa porovnáva s aktuálnou hodnotou kryptomeny, aby sa alarm nemohol spustiť sám okamžite: alarm above musí cieliť vyššie ako aktuálna hodnota, alarm below nižšie. Kryptomena bez aktuálnej hodnoty zvolenej metriky (napr. bez trhovej kapitalizácie, pretože nemá obiehajúcu ponuku) sa odmietne s kódom 422.

POST
https://bitculator.com/api/v1/alarms
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre tela

name
string povinné
BTC six figures

Označenie alarmu (max. 255 znakov).

coin
string povinné
bitcoin

Identifikátor slug danej mince.

metric
string povinné
rate

Sledovaná metrika: rate, volume alebo marketcap.

direction
string povinné
above

Smer spustenia: above alebo below.

target
number povinné
100000

Prahová hodnota (musí ležať na strane direction od aktuálnej hodnoty mince).

notification
string povinné
email

Kanál doručenia: email, push alebo webhook.

Požiadavka

curl --request POST \
    "https://bitculator.com/api/v1/alarms" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"BTC six figures\",
    \"coin\": \"bitcoin\",
    \"metric\": \"rate\",
    \"direction\": \"above\",
    \"target\": 100000,
    \"notification\": \"email\"
}"

Odstrániť alarm

Free

Odstráni jeden z alarmov vlastníka kľúča a vráti slot alarmu, ktorý spotreboval.

DELETE
https://bitculator.com/api/v1/alarms/{id}
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

id
integer povinné
42

Id alarmu.

Požiadavka

curl --request DELETE \
    "https://bitculator.com/api/v1/alarms/42" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
5 koncových bodov

Webhooky

Bitculator odosiela každú udalosť metódou POST ako JSON s hlavičkou HMAC podpisu:

X-Bitculator-Signature: t=<unix-ts>,v1=<hex hmac_sha256("<ts>.<raw-body>", secret)>
X-Bitculator-Event: alarm.triggered

Overte ho prepočítaním HMAC nad „.“ pomocou tajného kľúča vášho koncového bodu a porovnaním v konštantnom čase; odmietnite, ak je t staršie ako niekoľko minút (ochrana proti opakovanému prehratiu). Príklad (PHP):

[$t, $v1] = sscanf($_SERVER['HTTP_X_BITCULATOR_SIGNATURE'], 't=%d,v1=%s');
$expected = hash_hmac('sha256', $t.'.'.file_get_contents('php://input'), $secret);
abort_unless(hash_equals($expected, $v1) && abs(time() - $t) < 300, 403);

Podporované udalosti: alarm.triggered. Doručenia sa opakujú 3× s odstupom; koncový bod sa po 10 po sebe idúcich neúspešných doručeniach automaticky vypne.

Zoznam koncových bodov webhookov

Free

Koncové body webhookov vlastníka kľúča, najnovšie ako prvé. Podpisové tajné kľúče nikdy nie sú súčasťou odpovede – každý sa zobrazí práve raz, pri vytvorení.

GET
https://bitculator.com/api/v1/webhooks
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/webhooks" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Vytvoriť koncový bod webhooku

Free

Zaregistruje HTTPS koncový bod (max. 5 na účet) na doručovanie udalostí. Odpoveď obsahuje podpisový secret – zobrazí sa JEDINÝ raz, preto si ho ihneď uložte.

POST
https://bitculator.com/api/v1/webhooks
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre tela

url
string povinné
https://example.com/webhooks/bitculator

Doručovacia HTTPS URL. Len verejné hostiteľské adresy – interné/súkromné adresy sú odmietnuté.

events
string[] povinné
["alarm.triggered"]

Udalosti, na ktoré sa prihlásiť. Povolené hodnoty: alarm.triggered.

Požiadavka

curl --request POST \
    "https://bitculator.com/api/v1/webhooks" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"url\": \"https:\\/\\/example.com\\/webhooks\\/bitculator\",
    \"events\": [
        \"alarm.triggered\"
    ]
}"

Odstrániť koncový bod webhooku

Free

Odstráni jeden z koncových bodov webhooku vlastníka kľúča. Čakajúce doručenia naň sa zrušia.

DELETE
https://bitculator.com/api/v1/webhooks/{id}
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

id
integer povinné
7

Id koncového bodu webhooku.

Požiadavka

curl --request DELETE \
    "https://bitculator.com/api/v1/webhooks/7" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Odoslať testovaciu udalosť

Free

Odošle podpísanú testovaciu udalosť alarm.triggered (test: true v payloade, reálne hlavičky podpisu), aby bolo možné prijímače úplne overiť.

POST
https://bitculator.com/api/v1/webhooks/{id}/test
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

id
integer povinné
7

Id koncového bodu webhooku.

Požiadavka

curl --request POST \
    "https://bitculator.com/api/v1/webhooks/7/test" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Protokol doručovania webhookov

Free

Pokusy o doručenie pre tento koncový bod (uchovávané 30 dní), najnovšie ako prvé, stránkované.

GET
https://bitculator.com/api/v1/webhooks/{id}/deliveries
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Parametre cesty

id
integer povinné
7

Id koncového bodu webhooku.

Parametre dopytu

page
integer voliteľné
1

Číslo strany (počítané od 1).

per_page
integer voliteľné
25

Počet riadkov na stranu (1–100, predvolene 25).

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/webhooks/7/deliveries?page=1&per_page=25" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
3 koncových bodov

Meta

Meta a introspekcia API: autentifikovaný ping na overenie kľúča a middleware vrstvy, využitie/kvóta aktuálneho kľúča a strojovo čitateľná špecifikácia OpenAPI.

Špecifikácia OpenAPI

Free

Strojovo čitateľný dokument OpenAPI 3 pre toto API vo formáte JSON – nasmerujte na túto URL generátor kódu alebo API nástroje. Verejné: nevyžaduje kľúč.

GET
https://bitculator.com/api/v1/openapi.json
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/openapi.json" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Ping

Free

Autentifikovaná prázdna operácia na úplné overenie kľúča Data API (auth.api → nárazové obmedzenie podľa plánu → mesačná kvóta). Započítava sa do kvóty ako každé iné volanie.

GET
https://bitculator.com/api/v1/ping
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/ping" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Využitie a kvóta kľúča

Free

Prehľad spotreby pre vlastníka volajúceho kľúča v rámci produktu, do ktorého kľúč patrí: plán, jeho mesačný limit, využitá a zostávajúca časť (vždy zhodná s hlavičkami X-Quota-*), aktuálne obdobie a rozpisy podľa koncových bodov / tokenov. Pri volaní cez MCP vracia plán a pool pre MCP. Spotreba embed widgetu má vlastný plán a pool – tu sa nikdy neobjaví.

GET
https://bitculator.com/api/v1/usage
Bearer
bc_••••••••••••••••

Kľúče fungujú iba cez Bearer a nesú oprávnenie data-api – držte ich na strane servera.

Požiadavka GET – bez tela požiadavky.

Požiadavka

curl --request GET \
    --get "https://bitculator.com/api/v1/usage" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"