Dane rynkowe
Narzędzie
search_coins
Dopasowuje monetę lub token po dowolnej tekstowej nazwie albo symbolu do jej kanonicznego sluga, z rankingowanym podsumowaniem rynkowym dla każdego trafienia. Punkt wejścia: każde inne narzędzie monetowe adresuje się slugiem.
| Parametr |
Typ |
Opis |
query
wymagany
|
string |
Dowolne wyszukiwanie tekstowe dopasowywane do nazw i symboli monet. |
type
|
enum |
Ogranicz dopasowania: coin lub token. |
limit
|
integer |
Maksymalna liczba trafień do zwrócenia (1–50, domyślnie 10). |
Narzędzie
get_coin
Pełny profil jednej monety: podaże, ranking i jego zmiany, historyczne maksimum/minimum i odległość od nich, w pełni rozwodniona wycena, linki, kontrakty i opis.
| Parametr |
Typ |
Opis |
slug
wymagany
|
string |
Kanoniczny slug monety, np. bitcoin. |
Narzędzie
get_prices
Bieżące ceny spot dla maks. 100 monet w jednym wywołaniu, opcjonalnie przeliczone na walutę fiat. Najtańszy sposób odpowiadania na pytania o cenę — wymagany jest dokładnie jeden selektor.
| Parametr |
Typ |
Opis |
slugs
|
string |
Slugi monet rozdzielone przecinkami — preferowany selektor. |
symbols
|
string |
Symbole tickerów rozdzielone przecinkami; niejednoznaczne symbole dopasowywane są do monety o najwyższym rankingu. |
ids
|
string |
Numeryczne id monet Bitculator rozdzielone przecinkami. |
convert
|
string |
Symbol waluty fiat, na którą przeliczyć ceny, np. EUR. Domyślnie USD. |
Narzędzie
get_top_movers
Najwięksi zyskujący lub tracący według zmiany procentowej z ostatnich 24 godzin lub 7 dni.
| Parametr |
Typ |
Opis |
direction
wymagany
|
enum |
gainers lub losers. |
interval
|
enum |
Okno zmiany do rankingu: 24h lub 7d (domyślnie 24h). |
limit
|
integer |
Maksymalna liczba monet do zwrócenia (1–50, domyślnie 10). |
Narzędzie
get_trending_coins
Monety przyciągające w tej chwili najwięcej uwagi na Bitculator, jako kompaktowe wiersze rynkowe.
| Parametr |
Typ |
Opis |
limit
|
integer |
Maksymalna liczba monet do zwrócenia (1–20, domyślnie 10). |
Historia
Narzędzie
get_price_history
Świece OHLCV dla monety w zakresie dat. Retencja: minutowe ~8 dni, półgodzinne ~3 miesiące, godzinowe ~6 miesięcy, dzienne = pełna historia. Zwraca najnowsze świece w oknie, od najstarszych.
| Parametr |
Typ |
Opis |
slug
wymagany
|
string |
Kanoniczny slug monety. |
interval
|
enum |
Interwał świecy: minutely, half-hourly, hourly lub daily (domyślnie daily). |
start
|
date |
Początek okna jako YYYY-MM-DD; domyślnie niedawne okno dopasowane do interwału. |
end
|
date |
Koniec okna jako YYYY-MM-DD; domyślnie teraz. |
limit
|
integer |
Maksymalna liczba świec do zwrócenia (1–500, domyślnie 90). |
Narzędzie
get_historical_price
Cena jednej monety w jednym konkretnym dniu w przeszłości, z fallbackiem do 3 dni, gdy dokładny dzień nie ma danych.
| Parametr |
Typ |
Opis |
slug
wymagany
|
string |
Kanoniczny slug monety. |
date
wymagany
|
date |
Data jako YYYY-MM-DD (2009-01-01 lub później, nie w przyszłości). |
Narzędzie
get_global_history
Szereg czasowy łącznej kapitalizacji kryptorynku lub łącznego wolumenu. Granulacja zależy od okresu: 24h jest półgodzinna, 7d godzinowa, 30d i all dzienna.
| Parametr |
Typ |
Opis |
metric
wymagany
|
enum |
Który szereg zwrócić: marketcap lub volume. |
period
|
enum |
Okno: 24h, 7d, 30d lub all (domyślnie 24h). |
Sentyment i dane globalne
Narzędzie
get_global_market
Migawka całego rynku: łączna kapitalizacja, łączny wolumen 24h, dominacja BTC/ETH oraz liczby monet/tokenów/giełd/par.
To narzędzie nie przyjmuje parametrów.
Narzędzie
get_fear_greed
Indeks sentymentu strachu i chciwości dla całego rynku lub dla jednej monety, gdy podany jest slug, wraz z pod-ocenami dla interwałów 7d/30d.
| Parametr |
Typ |
Opis |
coin
|
string |
Opcjonalny slug monety dla odczytu per moneta; pomiń dla indeksu całego rynku. |
Narzędzie
get_altseason_index
Indeks altseason — czy altcoiny radzą sobie lepiej niż Bitcoin — z opcjonalną dzienną historią.
| Parametr |
Typ |
Opis |
days
|
integer |
Liczba dni dziennej historii do uwzględnienia (0–365; 0 zwraca tylko bieżący odczyt). |
Narzędzie
get_liquidations_summary
Dzisiejsze sumy likwidacji futures z podziałem long/short i dominacją. Zaraz po dziennym rolowaniu dane mogą być null.
To narzędzie nie przyjmuje parametrów.
Giełdy
Narzędzie
list_exchanges
Rankingowane giełdy z wolumenem 24h, dominacją wolumenu oraz liczbą par/aktywów. Dopasowuje też nazwy giełd do slugów.
| Parametr |
Typ |
Opis |
type
|
enum |
Ogranicz do giełd scentralizowanych (cex) lub zdecentralizowanych (dex). |
search
|
string |
Dowolne wyszukiwanie tekstowe dopasowywane do nazw giełd. |
sort
|
string |
Pola sortowania rozdzielone przecinkami, prefiks "-" dla malejąco: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets. |
limit
|
integer |
Maksymalna liczba giełd do zwrócenia (1–50, domyślnie 10). |
Narzędzie
get_exchange
Pełny profil jednej giełdy: ranking, wolumen i zmiany, dominacja, notowane pary i aktywa oraz linki.
| Parametr |
Typ |
Opis |
slug
wymagany
|
string |
Kanoniczny slug giełdy, np. binance-exchange. |
Narzędzie
get_exchange_trust_score
Wskaźnik zaufania giełdy (0–10) z pełnym rozbiciem na 13 czynników.
| Parametr |
Typ |
Opis |
slug
wymagany
|
string |
Kanoniczny slug giełdy. |
Narzędzie
get_coin_markets
Gdzie handluje się monetą: jej rynki na giełdach z parą, ceną i wolumenem 24h, posortowane według wolumenu.
| Parametr |
Typ |
Opis |
slug
wymagany
|
string |
Kanoniczny slug monety. |
exchange
|
string |
Opcjonalny slug giełdy, aby ograniczyć wyniki do jednego miejsca handlu. |
instrument
|
enum |
Ogranicz do jednego typu instrumentu: spot, future, option, swap lub margin. |
limit
|
integer |
Maksymalna liczba rynków do zwrócenia (1–50, domyślnie 10). |
Analiza i narzędzia pomocnicze
Narzędzie
get_coin_technicals
Wielowskaźnikowa migawka techniczna monety w jednym wywołaniu: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, zmienność i więcej — każdy z najnowszym stanem i oceną.
| Parametr |
Typ |
Opis |
slug
wymagany
|
string |
Kanoniczny slug monety. |
Narzędzie
convert_currency
Konwertuje kwotę między dowolnymi walutami krypto i/lub fiat (maks. 10 celów na wywołanie) po kursach na żywo, z pełną precyzją dziesiętną.
| Parametr |
Typ |
Opis |
from
wymagany
|
string |
Slug waluty źródłowej, np. bitcoin lub united-states-dollar. |
to
wymagany
|
string |
Slugi walut docelowych rozdzielone przecinkami, maks. 10. |
amount
|
number |
Kwota waluty źródłowej do przeliczenia (domyślnie 1). |
Narzędzie
calculate_dca
Backtest strategii uśredniania kosztu zakupu (DCA) na prawdziwej historii cen: łącznie zainwestowano, zgromadzone monety, bieżąca wartość oraz zysk/strata.
| Parametr |
Typ |
Opis |
slug
wymagany
|
string |
Kanoniczny slug monety. |
amount
wymagany
|
number |
Kwota w USD kupowana w każdym interwale. |
interval
wymagany
|
enum |
Częstotliwość zakupów: daily, weekly, monthly, quarterly lub yearly. |
start
wymagany
|
date |
Data pierwszego zakupu jako YYYY-MM-DD (przed dniem dzisiejszym). |
end
|
date |
Data ostatniego zakupu jako YYYY-MM-DD; domyślnie dziś. |
series
|
boolean |
Dołącz serię per zakup (duży wynik — zostaw false, chyba że poproszono). |