Bitculator
Bitculator · Data API · v1

Bitculator Data API

76 endpointów 15 grup X-Quota-* w każdym wywołaniu https://bitculator.com/api/v1

Wszystkie endpointy znajdują się pod /api/v1 i wymagają klucza Bearer z uprawnieniem data-api - utwórz go w swojej konsoli deweloperskiej.

Twoje pierwsze wywołanie:

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

Odpowiedzi są w formacie JSON. Ceny, kursy i podaże to ciągi dziesiętne (liczby zmiennoprzecinkowe nie utrzymają precyzji rynkowej); liczniki i wartości analityczne to liczby. Każda odpowiedź niesie Twój bieżący limit w nagłówkach X-Quota-Limit / X-Quota-Used / X-Quota-Reset, a błędy zawsze używają koperty {"error": {"code", "message", "details"}}.

Data API ma własny miesięczny limit, powiązany z Twoim planem API i całkowicie oddzielny od Twoich widżetów embed. Limity per_page zależą od planu (Free 100, Starter/Pro 250); przekroczenie limitu zwraca 422 zamiast przycinać wartość.

Biblioteki klienckie

Nie potrzebujesz SDK - każdy endpoint to zwykłe HTTP. Jeśli jednak wolisz z niego korzystać, dostępnych jest osiem oficjalnych SDK na licencji MIT - wszystkie pokrywają całe API i mają wbudowaną paginację, typowane błędy oraz precyzję ciągów dziesiętnych.

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

Uwierzytelnianie

Aby uwierzytelnić zapytania, dołączaj nagłówek Authorization: Bearer {YOUR_API_KEY} do każdego zapytania.

Utwórz klucz Data API w swojej konsoli deweloperskiej - klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api. Przechowuj je po stronie serwera; nigdy nie są przeznaczone do osadzania po stronie klienta.

Nagłówek Authorization
Utwórz klucz →
Bearer
bc_••••••••••••••••

Wysyłany jako Authorization: Bearer {YOUR_API_KEY} w każdym zapytaniu.

Każdy endpoint pokazuje minimalny plan wymagany do jego wywołania. Free Starter Pro
9 endpointów

Monety

Rankingowane dane rynkowe monet i tokenów: stronicowane listy, szczegóły pojedynczej monety, zmiany (zyskujące/tracące), niedawno dodane, trendujące oraz szeregi czasowe dla monety. Ceny, kapitalizacja rynkowa i podaż to ŁAŃCUCHY dziesiętne (liczby zmiennoprzecinkowe nie utrzymają precyzji rynkowej); zmiany procentowe, rankingi i liczby to liczby.

Wypisz monety

Free

Rankingowane monety z cenami, filtrami i selektorami, stronicowane w kopercie links + meta Laravela. Ceny, kapitalizacja rynkowa i circulating_supply to łańcuchy dziesiętne; zmiany i rankingi to liczby.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

page
integer opcjonalny
1

Numer strony (od 1). Musi wynosić co najmniej 1.

per_page
integer opcjonalny
50

Wierszy na stronę. Limit zależy od planu (Free 100, Starter/Pro 250); przekroczenie zwraca 422 zamiast przycinać. Musi wynosić co najmniej 1. Nie może przekraczać 100.

type
string opcjonalny
coin

Ogranicz do jednego typu aktywu: coin lub token.

Jeden z: coin token

status
string opcjonalny
active

Status notowania: active, delisted, untracked, progressing, awaiting lub preparing. Domyślnie wszystkie publiczne statusy.

Jeden z: active delisted untracked progressing awaiting preparing

search
string opcjonalny
bitcoin

Dopasowanie tekstowe po nazwie lub symbolu. Nie może przekraczać 100 znaków.

min_price
number opcjonalny
0.5

Tylko monety wyceniane na tę wartość w USD lub wyżej. Musi wynosić co najmniej 0.

max_price
number opcjonalny
100000

Tylko monety wyceniane na tę wartość w USD lub niżej. Musi wynosić co najmniej 0.

min_marketcap
number opcjonalny
1000000

Tylko monety z kapitalizacją rynkową w USD na tym poziomie lub wyższym. Musi wynosić co najmniej 0.

max_marketcap
number opcjonalny
5000000000000

Tylko monety z kapitalizacją rynkową w USD na tym poziomie lub niższym. Musi wynosić co najmniej 0.

min_volume
number opcjonalny
1000000

Tylko monety z wolumenem 24h w USD na tym poziomie lub wyższym. Musi wynosić co najmniej 0.

max_volume
number opcjonalny
100000000000

Tylko monety z wolumenem 24h w USD na tym poziomie lub niższym. Musi wynosić co najmniej 0.

ids
string opcjonalny
38,39

Ogranicz do konkretnych identyfikatorów monet (CSV, do 100 selektorów łącznie ze slugs/symbols). Nie może przekraczać 1000 znaków.

slugs
string opcjonalny
bitcoin,ethereum

Ogranicz do konkretnych slugów monet (CSV, do 100 selektorów łącznie). Nie może przekraczać 2000 znaków.

symbols
string opcjonalny
BTC,ETH

Ogranicz do konkretnych symboli monet (CSV, wielkość liter bez znaczenia, do 100 selektorów łącznie). Nie może przekraczać 1000 znaków.

sort
string opcjonalny
-marketcap

Pola sortowania oddzielone przecinkami; poprzedź znakiem - dla porządku malejącego. Sortowalne: marketcap, rank, price, volume_24h, change_24h, change_7d. Nie może przekraczać 100 znaków.

interval
string opcjonalny
24h

Okno zmian tylko dla /coins/gainers i /coins/losers: 24h lub 7d.

Jeden z: 24h 7d

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Niedawno dodane monety

Free

Najnowsze notowania - sortowane po status_updated_at (znacznik czasu aktywacji; created_at to data indeksowania, która wyprzedza notowanie o dowolne wartości). Taki sam kształt wiersza i koperta stronicowania jak w List coins.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

page
integer opcjonalny
1

Numer strony (od 1). Musi wynosić co najmniej 1.

per_page
integer opcjonalny
50

Wierszy na stronę. Limit zależy od planu (Free 100, Starter/Pro 250); przekroczenie zwraca 422 zamiast przycinać. Musi wynosić co najmniej 1. Nie może przekraczać 100.

type
string opcjonalny
coin

Ogranicz do jednego typu aktywu: coin lub token.

Jeden z: coin token

status
string opcjonalny
active

Status notowania: active, delisted, untracked, progressing, awaiting lub preparing. Domyślnie wszystkie publiczne statusy.

Jeden z: active delisted untracked progressing awaiting preparing

search
string opcjonalny
bitcoin

Dopasowanie tekstowe po nazwie lub symbolu. Nie może przekraczać 100 znaków.

min_price
number opcjonalny
0.5

Tylko monety wyceniane na tę wartość w USD lub wyżej. Musi wynosić co najmniej 0.

max_price
number opcjonalny
100000

Tylko monety wyceniane na tę wartość w USD lub niżej. Musi wynosić co najmniej 0.

min_marketcap
number opcjonalny
1000000

Tylko monety z kapitalizacją rynkową w USD na tym poziomie lub wyższym. Musi wynosić co najmniej 0.

max_marketcap
number opcjonalny
5000000000000

Tylko monety z kapitalizacją rynkową w USD na tym poziomie lub niższym. Musi wynosić co najmniej 0.

min_volume
number opcjonalny
1000000

Tylko monety z wolumenem 24h w USD na tym poziomie lub wyższym. Musi wynosić co najmniej 0.

max_volume
number opcjonalny
100000000000

Tylko monety z wolumenem 24h w USD na tym poziomie lub niższym. Musi wynosić co najmniej 0.

ids
string opcjonalny
38,39

Ogranicz do konkretnych identyfikatorów monet (CSV, do 100 selektorów łącznie ze slugs/symbols). Nie może przekraczać 1000 znaków.

slugs
string opcjonalny
bitcoin,ethereum

Ogranicz do konkretnych slugów monet (CSV, do 100 selektorów łącznie). Nie może przekraczać 2000 znaków.

symbols
string opcjonalny
BTC,ETH

Ogranicz do konkretnych symboli monet (CSV, wielkość liter bez znaczenia, do 100 selektorów łącznie). Nie może przekraczać 1000 znaków.

sort
string opcjonalny
-marketcap

Pola sortowania oddzielone przecinkami; poprzedź znakiem - dla porządku malejącego. Sortowalne: marketcap, rank, price, volume_24h, change_24h, change_7d. Nie może przekraczać 100 znaków.

interval
string opcjonalny
24h

Okno zmian tylko dla /coins/gainers i /coins/losers: 24h lub 7d.

Jeden z: 24h 7d

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Największe wzrosty

Free

Największe wzrosty w oknie interval (domyślnie 24h lub 7d). Taki sam kształt wiersza i koperta stronicowania jak w List coins.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

page
integer opcjonalny
1

Numer strony (od 1). Musi wynosić co najmniej 1.

per_page
integer opcjonalny
50

Wierszy na stronę. Limit zależy od planu (Free 100, Starter/Pro 250); przekroczenie zwraca 422 zamiast przycinać. Musi wynosić co najmniej 1. Nie może przekraczać 100.

type
string opcjonalny
coin

Ogranicz do jednego typu aktywu: coin lub token.

Jeden z: coin token

status
string opcjonalny
active

Status notowania: active, delisted, untracked, progressing, awaiting lub preparing. Domyślnie wszystkie publiczne statusy.

Jeden z: active delisted untracked progressing awaiting preparing

search
string opcjonalny
bitcoin

Dopasowanie tekstowe po nazwie lub symbolu. Nie może przekraczać 100 znaków.

min_price
number opcjonalny
0.5

Tylko monety wyceniane na tę wartość w USD lub wyżej. Musi wynosić co najmniej 0.

max_price
number opcjonalny
100000

Tylko monety wyceniane na tę wartość w USD lub niżej. Musi wynosić co najmniej 0.

min_marketcap
number opcjonalny
1000000

Tylko monety z kapitalizacją rynkową w USD na tym poziomie lub wyższym. Musi wynosić co najmniej 0.

max_marketcap
number opcjonalny
5000000000000

Tylko monety z kapitalizacją rynkową w USD na tym poziomie lub niższym. Musi wynosić co najmniej 0.

min_volume
number opcjonalny
1000000

Tylko monety z wolumenem 24h w USD na tym poziomie lub wyższym. Musi wynosić co najmniej 0.

max_volume
number opcjonalny
100000000000

Tylko monety z wolumenem 24h w USD na tym poziomie lub niższym. Musi wynosić co najmniej 0.

ids
string opcjonalny
38,39

Ogranicz do konkretnych identyfikatorów monet (CSV, do 100 selektorów łącznie ze slugs/symbols). Nie może przekraczać 1000 znaków.

slugs
string opcjonalny
bitcoin,ethereum

Ogranicz do konkretnych slugów monet (CSV, do 100 selektorów łącznie). Nie może przekraczać 2000 znaków.

symbols
string opcjonalny
BTC,ETH

Ogranicz do konkretnych symboli monet (CSV, wielkość liter bez znaczenia, do 100 selektorów łącznie). Nie może przekraczać 1000 znaków.

sort
string opcjonalny
-marketcap

Pola sortowania oddzielone przecinkami; poprzedź znakiem - dla porządku malejącego. Sortowalne: marketcap, rank, price, volume_24h, change_24h, change_7d. Nie może przekraczać 100 znaków.

interval
string opcjonalny
24h

Okno zmian tylko dla /coins/gainers i /coins/losers: 24h lub 7d.

Jeden z: 24h 7d

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Największe spadki

Free

Największe spadki w oknie interval (domyślnie 24h lub 7d). Taki sam kształt wiersza i koperta stronicowania jak w List coins.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

page
integer opcjonalny
1

Numer strony (od 1). Musi wynosić co najmniej 1.

per_page
integer opcjonalny
50

Wierszy na stronę. Limit zależy od planu (Free 100, Starter/Pro 250); przekroczenie zwraca 422 zamiast przycinać. Musi wynosić co najmniej 1. Nie może przekraczać 100.

type
string opcjonalny
coin

Ogranicz do jednego typu aktywu: coin lub token.

Jeden z: coin token

status
string opcjonalny
active

Status notowania: active, delisted, untracked, progressing, awaiting lub preparing. Domyślnie wszystkie publiczne statusy.

Jeden z: active delisted untracked progressing awaiting preparing

search
string opcjonalny
bitcoin

Dopasowanie tekstowe po nazwie lub symbolu. Nie może przekraczać 100 znaków.

min_price
number opcjonalny
0.5

Tylko monety wyceniane na tę wartość w USD lub wyżej. Musi wynosić co najmniej 0.

max_price
number opcjonalny
100000

Tylko monety wyceniane na tę wartość w USD lub niżej. Musi wynosić co najmniej 0.

min_marketcap
number opcjonalny
1000000

Tylko monety z kapitalizacją rynkową w USD na tym poziomie lub wyższym. Musi wynosić co najmniej 0.

max_marketcap
number opcjonalny
5000000000000

Tylko monety z kapitalizacją rynkową w USD na tym poziomie lub niższym. Musi wynosić co najmniej 0.

min_volume
number opcjonalny
1000000

Tylko monety z wolumenem 24h w USD na tym poziomie lub wyższym. Musi wynosić co najmniej 0.

max_volume
number opcjonalny
100000000000

Tylko monety z wolumenem 24h w USD na tym poziomie lub niższym. Musi wynosić co najmniej 0.

ids
string opcjonalny
38,39

Ogranicz do konkretnych identyfikatorów monet (CSV, do 100 selektorów łącznie ze slugs/symbols). Nie może przekraczać 1000 znaków.

slugs
string opcjonalny
bitcoin,ethereum

Ogranicz do konkretnych slugów monet (CSV, do 100 selektorów łącznie). Nie może przekraczać 2000 znaków.

symbols
string opcjonalny
BTC,ETH

Ogranicz do konkretnych symboli monet (CSV, wielkość liter bez znaczenia, do 100 selektorów łącznie). Nie może przekraczać 1000 znaków.

sort
string opcjonalny
-marketcap

Pola sortowania oddzielone przecinkami; poprzedź znakiem - dla porządku malejącego. Sortowalne: marketcap, rank, price, volume_24h, change_24h, change_7d. Nie może przekraczać 100 znaków.

interval
string opcjonalny
24h

Okno zmian tylko dla /coins/gainers i /coins/losers: 24h lub 7d.

Jeden z: 24h 7d

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Pobierz szczegóły monety

Free

Pełny profil pojedynczej monety. Poza polami z listy dodaje: supply (krążąca/całkowita/maks.), today OHLC, all_time_high / all_time_low (cena, data i percent_from względem bieżącej ceny), fully_diluted_valuation, rynkowe counts (giełdy/pary/tickery/portfele), decimals, genesis_date, oficjalne links (typowana lista url), contracts tokena oraz zlokalizowany opis HTML description (fallback na angielski, gdy żądany locale jest niedostępny). Wszystkie pola cen/podaży to łańcuchy dziesiętne.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Slug monety.

Parametry zapytania

locale
string opcjonalny
en

Język treści opisu (fallback na angielski).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Historia świec

Free

Szereg czasowy OHLC + wolumen + kapitalizacja rynkowa dla monety. Wybierz interval: minutowy, półgodzinny, godzinowy lub dzienny. Retencja jest twardą właściwością potoku agregacji - minutowy 8 dni, półgodzinny 3 miesiące, godzinowy 6 miesięcy, dzienny na zawsze; żądania poza oknem zwracają to, co istnieje. Gdy ustawiono limit, otrzymujesz N NAJNOWSZYCH wierszy w oknie, emitowanych od najstarszego. Ceny to łańcuchy dziesiętne.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Slug monety.

Parametry zapytania

interval
string opcjonalny
daily

minutowy, półgodzinny, godzinowy lub dzienny (domyślnie dzienny).

start
string opcjonalny
2026-06-01

Dolna granica daty/czasu ISO.

end
string opcjonalny
2026-06-30

Górna granica daty/czasu ISO (wartość zawierająca tylko datę oznacza do końca tego dnia).

limit
integer opcjonalny
30

Maks. wierszy (1–2000, domyślnie 1000).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Historia kapitalizacji rynkowej

Free

Te same agregaty dla monety co Candle history, rzutowane wyłącznie na {time, marketcap}. Takie same opcje interval i okna retencji (minutowy 8 dni, półgodzinny 3 miesiące, godzinowy 6 miesięcy, dzienny na zawsze), N-najnowszych, gdy ustawiono limit.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Slug monety.

Parametry zapytania

interval
string opcjonalny
daily

minutowy, półgodzinny, godzinowy lub dzienny (domyślnie dzienny).

start
string opcjonalny
2026-06-01

Dolna granica daty/czasu ISO.

end
string opcjonalny
2026-06-30

Górna granica daty/czasu ISO.

limit
integer opcjonalny
30

Maks. wierszy (1–2000, domyślnie 1000).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 monety

Free

Zwarta seria cen monety w wybranym period, do rysowania wykresów sparkline.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Slug monety.

Parametry zapytania

period
string opcjonalny
7d

24h, 7d, 30d, 60d, 90d, 180d lub 365d (domyślnie 7d).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 endpointów

Ceny

Lekka szybka ścieżka cenowa - bieżąca cena, kapitalizacja rynkowa, wolumen 24h i niedawne zmiany dla żądanego zestawu monet. /prices wymaga selektora (ids, slugs lub symbols); /prices/{slug} dotyczy jednej monety. Opcjonalnie convert na walutę fiat (ceny krypto odświeżają się ~co minutę, fiat FX ~dwa razy dziennie). Ceny i kapitalizacja rynkowa to łańcuchy dziesiętne.

Pobierz ceny

Free

Ceny dla żądanego zestawu monet. Przekaż co najmniej jeden selektor - ids, slugs lub symbols (do 100 łącznie). meta.currency odzwierciedla cel konwersji (USD, o ile nie ustawiono convert).

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

ids
string opcjonalny
38,39

Identyfikatory monet do wyceny (CSV). Wymagane co najmniej jedno z ids, slugs lub symbols; trzy listy łącznie ograniczone są do 100 selektorów. To pole jest wymagane, gdy nie występuje żadne z slugs i symbols. Nie może przekraczać 1000 znaków.

slugs
string opcjonalny
bitcoin,ethereum

Slugi monet do wyceny (CSV). Wymagane co najmniej jedno z ids, slugs lub symbols. To pole jest wymagane, gdy nie występuje żadne z ids i symbols. Nie może przekraczać 2000 znaków.

symbols
string opcjonalny
BTC,ETH

Symbole monet do wyceny (CSV, wielkość liter bez znaczenia). Wymagane co najmniej jedno z ids, slugs lub symbols. To pole jest wymagane, gdy nie występuje żadne z ids i slugs. Nie może przekraczać 1000 znaków.

convert
string opcjonalny
EUR

Przelicz ceny/kapitalizację rynkową na aktywną walutę fiat według symbolu (domyślnie USD). Kursy FX odświeżają się ~dwa razy dziennie.

Jeden z: 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

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Pobierz cenę monety

Free

Migawka ceny pojedynczej monety. Opcjonalnie convert na aktywną walutę fiat według symbolu (domyślnie USD).

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Slug monety.

Parametry zapytania

convert
string opcjonalny
EUR

Symbol aktywnej waluty fiat do wyceny (domyślnie USD).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Cena historyczna

Free

Cena monety w USD w danym dniu, odczytana z historii dziennej (dokładny dzień, fallback ±3 dni - ten sam resolver, którego używa portfel). Tylko krypto: wiersze fiat nie mają historii dziennej.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

slug
string wymagany
bitcoin

Identyfikator sluga monety.

date
string wymagany
2021-04-14

date Data wyszukania (po 2008-12-31, nie w przyszłości).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 endpointów

Rynki

Tickery (rynki poszczególnych giełd) i pary (rynki zagregowane między platformami), a także rynki monety i surowe symbole handlowe dla poszczególnych giełd. Wszystko to dane migawkowe - nie istnieje historia dla poszczególnych tickerów/par. Wolumeny w USD to liczby; ceny to łańcuchy dziesiętne.

Rynki monety

Free

Wszystkie rynki monety - tickery, których para ma daną monetę jako aktyw bazowy LUB kwotowany. Taki sam kształt wiersza i filtry jak w List tickers.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Slug monety.

Parametry zapytania

page
integer opcjonalny
1

Numer strony (od 1). Musi wynosić co najmniej 1.

per_page
integer opcjonalny
50

Wierszy na stronę. Limit zależy od planu (Free 100, Starter/Pro 250); przekroczenie zwraca 422 zamiast przycinać. Musi wynosić co najmniej 1. Nie może przekraczać 100.

exchange
string opcjonalny
binance-exchange

Ogranicz do jednej giełdy według sluga (pomiń na liście danej giełdy, która jest już ograniczona). Musi pasować do wyrażenia regularnego /^[a-z0-9-]{1,120}$/.

pair
integer opcjonalny
1

Ogranicz do jednej pary według id. Musi wynosić co najmniej 1.

instrument
string opcjonalny
spot

Typ instrumentu: future, option, swap, spot lub margin (formy mnogie akceptowane).

Jeden z: future option swap spot margin

search
string opcjonalny
BTC

Dopasowanie tekstowe po symbolu tickera. Nie może przekraczać 50 znaków.

min_volume
number opcjonalny
1000000

Tylko tickery z wolumenem 24h w USD na tym poziomie lub wyższym. Musi wynosić co najmniej 0.

max_volume
number opcjonalny
100000000000

Tylko tickery z wolumenem 24h w USD na tym poziomie lub niższym. Musi wynosić co najmniej 0.

min_change
number opcjonalny
-50

Tylko tickery ze zmianą procentową 24h na tym poziomie lub wyższym.

max_change
number opcjonalny
50

Tylko tickery ze zmianą procentową 24h na tym poziomie lub niższym.

sort
string opcjonalny
-volume_usd

Pojedyncze pole sortowania (poprzedź znakiem - dla porządku malejącego). Sortowalne: volume_usd, change_24h, price_usd, updated. Domyślnie -volume_usd. Nie może przekraczać 100 znaków.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Symbole handlowe monety

Free

Surowe symbole handlowe monety dla poszczególnych giełd - rzadko wypełnione dane referencyjne (pokrycie w miarę możliwości).

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Slug monety.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Wypisz tickery

Free

Pojedyncze rynki poszczególnych giełd (tickery), stronicowane. Filtruj po giełdzie, parze, instrumencie oraz zakresach wolumenu/zmiany. Wolumeny w USD to liczby; ceny to łańcuchy dziesiętne.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

page
integer opcjonalny
1

Numer strony (od 1). Musi wynosić co najmniej 1.

per_page
integer opcjonalny
50

Wierszy na stronę. Limit zależy od planu (Free 100, Starter/Pro 250); przekroczenie zwraca 422 zamiast przycinać. Musi wynosić co najmniej 1. Nie może przekraczać 100.

exchange
string opcjonalny
binance-exchange

Ogranicz do jednej giełdy według sluga (pomiń na liście danej giełdy, która jest już ograniczona). Musi pasować do wyrażenia regularnego /^[a-z0-9-]{1,120}$/.

pair
integer opcjonalny
1

Ogranicz do jednej pary według id. Musi wynosić co najmniej 1.

instrument
string opcjonalny
spot

Typ instrumentu: future, option, swap, spot lub margin (formy mnogie akceptowane).

Jeden z: future option swap spot margin

search
string opcjonalny
BTC

Dopasowanie tekstowe po symbolu tickera. Nie może przekraczać 50 znaków.

min_volume
number opcjonalny
1000000

Tylko tickery z wolumenem 24h w USD na tym poziomie lub wyższym. Musi wynosić co najmniej 0.

max_volume
number opcjonalny
100000000000

Tylko tickery z wolumenem 24h w USD na tym poziomie lub niższym. Musi wynosić co najmniej 0.

min_change
number opcjonalny
-50

Tylko tickery ze zmianą procentową 24h na tym poziomie lub wyższym.

max_change
number opcjonalny
50

Tylko tickery ze zmianą procentową 24h na tym poziomie lub niższym.

sort
string opcjonalny
-volume_usd

Pojedyncze pole sortowania (poprzedź znakiem - dla porządku malejącego). Sortowalne: volume_usd, change_24h, price_usd, updated. Domyślnie -volume_usd. Nie może przekraczać 100 znaków.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Wypisz pary

Free

Pary handlowe zagregowane między platformami, uszeregowane według wolumenu 24h w USD. Filtruj po slugu monety (bazowej lub kwotowanej) i zakresie wolumenu.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

page
integer opcjonalny
1

Numer strony (od 1). Musi wynosić co najmniej 1.

per_page
integer opcjonalny
50

Wierszy na stronę. Limit zależy od planu (Free 100, Starter/Pro 250); przekroczenie zwraca 422 zamiast przycinać. Musi wynosić co najmniej 1. Nie może przekraczać 100.

search
string opcjonalny
BTC

Dopasowanie tekstowe po symbolu pary. Nie może przekraczać 50 znaków.

coin
string opcjonalny
bitcoin

Ogranicz do par, w których ten slug monety jest aktywem bazowym lub kwotowanym. Musi pasować do wyrażenia regularnego /^[a-z0-9-]{1,120}$/.

min_volume
number opcjonalny
1000000

Tylko pary z wolumenem 24h w USD na tym poziomie lub wyższym. Musi wynosić co najmniej 0.

max_volume
number opcjonalny
100000000000

Tylko pary z wolumenem 24h w USD na tym poziomie lub niższym. Musi wynosić co najmniej 0.

sort
string opcjonalny
-volume_usd

Pole sortowania: volume_usd lub updated (poprzedź znakiem - dla porządku malejącego). Domyślnie -volume_usd.

Jeden z: volume_usd -volume_usd updated -updated

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Pobierz szczegóły pary

Free

Jedna para wraz z każdym tickerem giełdowym ją notującym, uporządkowane według wolumenu.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

id
integer wymagany
1

Identyfikator pary.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 endpointów

Giełdy

Rankingi giełd, szczegóły, oceny zaufania, szeregi czasowe oraz notowania rynków/monet poszczególnych giełd. Wolumeny są w USD. Nie ma kolumny CEX/DEX - type jest wyprowadzany z taksonomii giełdy, więc może to być "cex", "dex" lub null.

Wypisz giełdy

Free

Rankingowane giełdy z wolumenem 24h, dominacją, liczbą par/aktywów i niedawnymi zmianami. Stronicowane w kopercie links + meta Laravela.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

page
integer opcjonalny
1

Numer strony (od 1). Musi wynosić co najmniej 1.

per_page
integer opcjonalny
50

Wierszy na stronę. Limit zależy od planu (Free 100, Starter/Pro 250); przekroczenie zwraca 422 zamiast przycinać. Musi wynosić co najmniej 1. Nie może przekraczać 100.

type
string opcjonalny
cex

Ogranicz do typu platformy: cex lub dex (rozstrzygane przez taksonomię giełdy).

Jeden z: cex dex

search
string opcjonalny
binance

Dopasowanie tekstowe po nazwie giełdy. Nie może przekraczać 100 znaków.

min_pairs
integer opcjonalny
100

Tylko giełdy notujące co najmniej tyle par. Musi wynosić co najmniej 0.

max_pairs
integer opcjonalny
2000

Tylko giełdy notujące najwyżej tyle par. Musi wynosić co najmniej 0.

min_assets
integer opcjonalny
50

Tylko giełdy notujące co najmniej tyle aktywów. Musi wynosić co najmniej 0.

max_assets
integer opcjonalny
1000

Tylko giełdy notujące najwyżej tyle aktywów. Musi wynosić co najmniej 0.

min_volume
number opcjonalny
1000000

Tylko giełdy z wolumenem 24h w USD na tym poziomie lub wyższym. Musi wynosić co najmniej 0.

max_volume
number opcjonalny
100000000000

Tylko giełdy z wolumenem 24h w USD na tym poziomie lub niższym. Musi wynosić co najmniej 0.

ids
string opcjonalny
1,12

Ogranicz do konkretnych identyfikatorów giełd (CSV, do 100). Nie może przekraczać 1000 znaków.

slugs
string opcjonalny
binance-exchange,gateio

Ogranicz do konkretnych slugów giełd (CSV, do 100). Nie może przekraczać 2000 znaków.

sort
string opcjonalny
-volume

Pola sortowania oddzielone przecinkami; poprzedź znakiem - dla porządku malejącego. Sortowalne: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets. Nie może przekraczać 100 znaków.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Pobierz szczegóły giełdy

Free

Pełny profil pojedynczej giełdy: ranking, wolumen/dominacja, liczba par i aktywów, data established, location, referencyjny website oraz wyprowadzony type (cex/dex/null).

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
binance-exchange

Slug giełdy.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Pobierz ocenę zaufania giełdy

Free

Zbiorcza ocena zaufania score 0–10 wraz z 13-czynnikowym breakdown (rank, volume, age, volume_trend, stability, rank_stability, ticker_health, pairs, community, assets, dominance, market_breadth, transparency). Obliczana dla każdej giełdy i buforowana przez 24h.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
binance-exchange

Slug giełdy.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Historia giełdy

Starter

Szereg czasowy wolumen / dominacja / pary / aktywa (agregaty giełd nie niosą OHLC). Wybierz interval: minutowy, godzinowy lub dzienny. Retencja jest twardą właściwością potoku agregacji - minutowy 8 dni, godzinowy 6 miesięcy, dzienny na zawsze; gdy ustawiono limit, otrzymujesz N najnowszych wierszy w oknie, od najstarszego.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
binance-exchange

Slug giełdy.

Parametry zapytania

interval
string opcjonalny
daily

minutowy, godzinowy lub dzienny (domyślnie dzienny).

start
string opcjonalny
2026-06-01

Dolna granica daty/czasu ISO.

end
string opcjonalny
2026-06-30

Górna granica daty/czasu ISO (wartość zawierająca tylko datę oznacza do końca tego dnia).

limit
integer opcjonalny
30

Maks. wierszy (1–2000, domyślnie 1000).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 giełdy

Starter

Seria sparkline wolumenu giełdy dla okresu (domyślnie 7d) - ta sama seria, którą renderują wiersze giełd w serwisie.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
binance-exchange

Slug giełdy.

Parametry zapytania

period
string opcjonalny
7d

Jedno z 24h, 7d (domyślnie), 30d, 60d, 90d, 180d, 365d.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Rynki giełdy

Free

Notowania tickerów giełdy (jej rynki), stronicowane. Już ograniczone do giełdy - nie przekazuj tutaj parametru exchange.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
binance-exchange

Slug giełdy.

Parametry zapytania

page
integer opcjonalny
1

Numer strony (od 1). Musi wynosić co najmniej 1.

per_page
integer opcjonalny
50

Wierszy na stronę. Limit zależy od planu (Free 100, Starter/Pro 250); przekroczenie zwraca 422 zamiast przycinać. Musi wynosić co najmniej 1. Nie może przekraczać 100.

exchange
string opcjonalny
binance-exchange

Ogranicz do jednej giełdy według sluga (pomiń na liście danej giełdy, która jest już ograniczona). Musi pasować do wyrażenia regularnego /^[a-z0-9-]{1,120}$/.

pair
integer opcjonalny
1

Ogranicz do jednej pary według id. Musi wynosić co najmniej 1.

instrument
string opcjonalny
spot

Typ instrumentu: future, option, swap, spot lub margin (formy mnogie akceptowane).

Jeden z: future option swap spot margin

search
string opcjonalny
BTC

Dopasowanie tekstowe po symbolu tickera. Nie może przekraczać 50 znaków.

min_volume
number opcjonalny
1000000

Tylko tickery z wolumenem 24h w USD na tym poziomie lub wyższym. Musi wynosić co najmniej 0.

max_volume
number opcjonalny
100000000000

Tylko tickery z wolumenem 24h w USD na tym poziomie lub niższym. Musi wynosić co najmniej 0.

min_change
number opcjonalny
-50

Tylko tickery ze zmianą procentową 24h na tym poziomie lub wyższym.

max_change
number opcjonalny
50

Tylko tickery ze zmianą procentową 24h na tym poziomie lub niższym.

sort
string opcjonalny
-volume_usd

Pojedyncze pole sortowania (poprzedź znakiem - dla porządku malejącego). Sortowalne: volume_usd, change_24h, price_usd, updated. Domyślnie -volume_usd. Nie może przekraczać 100 znaków.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Monety giełdy

Free

Monety notowane na giełdzie, zwracane w tym samym kształcie co List coins i przyjmujące te same filtry/sortowanie.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
binance-exchange

Slug giełdy.

Parametry zapytania

page
integer opcjonalny
1

Numer strony (od 1). Musi wynosić co najmniej 1.

per_page
integer opcjonalny
50

Wierszy na stronę. Limit zależy od planu (Free 100, Starter/Pro 250); przekroczenie zwraca 422 zamiast przycinać. Musi wynosić co najmniej 1. Nie może przekraczać 100.

type
string opcjonalny
coin

Ogranicz do jednego typu aktywu: coin lub token.

Jeden z: coin token

status
string opcjonalny
active

Status notowania: active, delisted, untracked, progressing, awaiting lub preparing. Domyślnie wszystkie publiczne statusy.

Jeden z: active delisted untracked progressing awaiting preparing

search
string opcjonalny
bitcoin

Dopasowanie tekstowe po nazwie lub symbolu. Nie może przekraczać 100 znaków.

min_price
number opcjonalny
0.5

Tylko monety wyceniane na tę wartość w USD lub wyżej. Musi wynosić co najmniej 0.

max_price
number opcjonalny
100000

Tylko monety wyceniane na tę wartość w USD lub niżej. Musi wynosić co najmniej 0.

min_marketcap
number opcjonalny
1000000

Tylko monety z kapitalizacją rynkową w USD na tym poziomie lub wyższym. Musi wynosić co najmniej 0.

max_marketcap
number opcjonalny
5000000000000

Tylko monety z kapitalizacją rynkową w USD na tym poziomie lub niższym. Musi wynosić co najmniej 0.

min_volume
number opcjonalny
1000000

Tylko monety z wolumenem 24h w USD na tym poziomie lub wyższym. Musi wynosić co najmniej 0.

max_volume
number opcjonalny
100000000000

Tylko monety z wolumenem 24h w USD na tym poziomie lub niższym. Musi wynosić co najmniej 0.

ids
string opcjonalny
38,39

Ogranicz do konkretnych identyfikatorów monet (CSV, do 100 selektorów łącznie ze slugs/symbols). Nie może przekraczać 1000 znaków.

slugs
string opcjonalny
bitcoin,ethereum

Ogranicz do konkretnych slugów monet (CSV, do 100 selektorów łącznie). Nie może przekraczać 2000 znaków.

symbols
string opcjonalny
BTC,ETH

Ogranicz do konkretnych symboli monet (CSV, wielkość liter bez znaczenia, do 100 selektorów łącznie). Nie może przekraczać 1000 znaków.

sort
string opcjonalny
-marketcap

Pola sortowania oddzielone przecinkami; poprzedź znakiem - dla porządku malejącego. Sortowalne: marketcap, rank, price, volume_24h, change_24h, change_7d. Nie może przekraczać 100 znaków.

interval
string opcjonalny
24h

Okno zmian tylko dla /coins/gainers i /coins/losers: 24h lub 7d.

Jeden z: 24h 7d

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 endpointów

Portfele

Recenzje portfeli krypto - ocena score, liczba obsługiwanych aktywów, liczba zalet/wad, model cenowy i data wydania oraz zgrupowana taksonomia tagów w odpowiedziach szczegółowych/porównawczych. meta.top_score to najwyższa ocena wśród wszystkich portfeli (użyj jej do normalizacji ocen do zakresu 0–1).

Wypisz portfele

Free

Recenzowane portfele z oceną, liczbą aktywów, liczbą zalet/wad, modelem cenowym, statusem i datą wydania. Stronicowane w kopercie links + meta Laravela oraz meta.top_score.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

page
integer opcjonalny
1

Numer strony (od 1). Musi wynosić co najmniej 1.

per_page
integer opcjonalny
50

Wierszy na stronę. Limit zależy od planu (Free 100, Starter/Pro 250); przekroczenie zwraca 422 zamiast przycinać. Musi wynosić co najmniej 1. Nie może przekraczać 100.

search
string opcjonalny
ledger

Dopasowanie tekstowe po nazwie portfela. Nie może przekraczać 100 znaków.

min_score
integer opcjonalny
50

Tylko portfele z oceną recenzji na tym poziomie lub wyższym. Musi wynosić co najmniej 0.

max_score
integer opcjonalny
214

Tylko portfele z oceną recenzji na tym poziomie lub niższym. Musi wynosić co najmniej 0.

tags
string opcjonalny
12,34

Filtruj po taksonomii tagów: identyfikatory grup kategorii oddzielone przecinkami (te same identyfikatory, które wysyłają filtry fasetowe w serwisie). Nie może przekraczać 1000 znaków.

ids
string opcjonalny
175,317

Ogranicz do konkretnych identyfikatorów portfeli (CSV, do 100). Nie może przekraczać 1000 znaków.

slugs
string opcjonalny
frostsnap,coin98-fusion-card

Ogranicz do konkretnych slugów portfeli (CSV, do 100). Nie może przekraczać 2000 znaków.

sort
string opcjonalny
-score

Pola sortowania oddzielone przecinkami; poprzedź znakiem - dla porządku malejącego. Sortowalne: score, released_at, assets, pros, cons. Nie może przekraczać 100 znaków.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Chronologia wydań portfeli

Free

Lista portfeli przypięta do malejącego released_at (portfele bez daty na końcu). Taki sam kształt wiersza i koperta stronicowania jak w List wallets.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

page
integer opcjonalny
1

Numer strony (od 1). Musi wynosić co najmniej 1.

per_page
integer opcjonalny
50

Wierszy na stronę. Limit zależy od planu (Free 100, Starter/Pro 250); przekroczenie zwraca 422 zamiast przycinać. Musi wynosić co najmniej 1. Nie może przekraczać 100.

search
string opcjonalny
ledger

Dopasowanie tekstowe po nazwie portfela. Nie może przekraczać 100 znaków.

min_score
integer opcjonalny
50

Tylko portfele z oceną recenzji na tym poziomie lub wyższym. Musi wynosić co najmniej 0.

max_score
integer opcjonalny
214

Tylko portfele z oceną recenzji na tym poziomie lub niższym. Musi wynosić co najmniej 0.

tags
string opcjonalny
12,34

Filtruj po taksonomii tagów: identyfikatory grup kategorii oddzielone przecinkami (te same identyfikatory, które wysyłają filtry fasetowe w serwisie). Nie może przekraczać 1000 znaków.

ids
string opcjonalny
175,317

Ogranicz do konkretnych identyfikatorów portfeli (CSV, do 100). Nie może przekraczać 1000 znaków.

slugs
string opcjonalny
frostsnap,coin98-fusion-card

Ogranicz do konkretnych slugów portfeli (CSV, do 100). Nie może przekraczać 2000 znaków.

sort
string opcjonalny
-score

Pola sortowania oddzielone przecinkami; poprzedź znakiem - dla porządku malejącego. Sortowalne: score, released_at, assets, pros, cons. Nie może przekraczać 100 znaków.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Porównaj portfele

Free

Porównanie obok siebie 2–4 portfeli z pełną zgrupowaną taksonomią tagów. data[] zachowuje żądaną kolejność slugów, aby konsumenci mogli renderować kolumny pozycyjnie.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

slugs
string wymagany
frostsnap,coin98-fusion-card

2–4 różne slugi portfeli, oddzielone przecinkami.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Pobierz szczegóły portfela

Free

Pełny profil pojedynczego portfela wraz ze zgrupowaną taksonomią tagów: categories to lista {group, tags[]}, gdzie każdy tag ma slug, nazwę i opcjonalną wartość. meta.top_score to najwyższa ocena wśród wszystkich portfeli.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
frostsnap

Slug portfela.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Monety obsługiwane przez portfel

Free

Monety obsługiwane przez portfel, zwracane w tym samym kształcie co List coins i przyjmujące te same filtry/sortowanie.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
frostsnap

Slug portfela.

Parametry zapytania

page
integer opcjonalny
1

Numer strony (od 1). Musi wynosić co najmniej 1.

per_page
integer opcjonalny
50

Wierszy na stronę. Limit zależy od planu (Free 100, Starter/Pro 250); przekroczenie zwraca 422 zamiast przycinać. Musi wynosić co najmniej 1. Nie może przekraczać 100.

type
string opcjonalny
coin

Ogranicz do jednego typu aktywu: coin lub token.

Jeden z: coin token

status
string opcjonalny
active

Status notowania: active, delisted, untracked, progressing, awaiting lub preparing. Domyślnie wszystkie publiczne statusy.

Jeden z: active delisted untracked progressing awaiting preparing

search
string opcjonalny
bitcoin

Dopasowanie tekstowe po nazwie lub symbolu. Nie może przekraczać 100 znaków.

min_price
number opcjonalny
0.5

Tylko monety wyceniane na tę wartość w USD lub wyżej. Musi wynosić co najmniej 0.

max_price
number opcjonalny
100000

Tylko monety wyceniane na tę wartość w USD lub niżej. Musi wynosić co najmniej 0.

min_marketcap
number opcjonalny
1000000

Tylko monety z kapitalizacją rynkową w USD na tym poziomie lub wyższym. Musi wynosić co najmniej 0.

max_marketcap
number opcjonalny
5000000000000

Tylko monety z kapitalizacją rynkową w USD na tym poziomie lub niższym. Musi wynosić co najmniej 0.

min_volume
number opcjonalny
1000000

Tylko monety z wolumenem 24h w USD na tym poziomie lub wyższym. Musi wynosić co najmniej 0.

max_volume
number opcjonalny
100000000000

Tylko monety z wolumenem 24h w USD na tym poziomie lub niższym. Musi wynosić co najmniej 0.

ids
string opcjonalny
38,39

Ogranicz do konkretnych identyfikatorów monet (CSV, do 100 selektorów łącznie ze slugs/symbols). Nie może przekraczać 1000 znaków.

slugs
string opcjonalny
bitcoin,ethereum

Ogranicz do konkretnych slugów monet (CSV, do 100 selektorów łącznie). Nie może przekraczać 2000 znaków.

symbols
string opcjonalny
BTC,ETH

Ogranicz do konkretnych symboli monet (CSV, wielkość liter bez znaczenia, do 100 selektorów łącznie). Nie może przekraczać 1000 znaków.

sort
string opcjonalny
-marketcap

Pola sortowania oddzielone przecinkami; poprzedź znakiem - dla porządku malejącego. Sortowalne: marketcap, rank, price, volume_24h, change_24h, change_7d. Nie może przekraczać 100 znaków.

interval
string opcjonalny
24h

Okno zmian tylko dla /coins/gainers i /coins/losers: 24h lub 7d.

Jeden z: 24h 7d

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 endpointów

Rynek globalny

Agregaty ogólnorynkowe - całkowita kapitalizacja rynkowa i wolumen, liczba aktywów/giełd/par/rynków, dominacja BTC/ETH z rankingowym top-3, rynkowy odczyt strachu i chciwości, a także mapa cieplna top-100 oraz historia kapitalizacji rynkowej/wolumenu.

Migawka rynku globalnego

Free

Jednorazowy przegląd rynku: całkowita kapitalizacja rynkowa i wolumen 24h, liczba kryptowalut / tokenów / giełd / par / rynków, dominance (udział BTC i ETH oraz rankingowy top3) i rynkowy odczyt fear_greed.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Mapa cieplna rynku

Starter

Wiersze mapy drzewa top-100 oraz statystyki ramowe (całkowita kapitalizacja rynkowa/wolumen, dominacja i rynkowa ocena strachu i chciwości) - odpowiednik webowej mapy cieplnej w API.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Historia globalnej kapitalizacji / wolumenu

Starter

Szereg czasowy całego rynku dla marketcap lub volume. Ziarnistość zależy od period: 24h = półgodzinnie, 7d = godzinowo, 30d/all = dziennie (drobniejsze agregaty są usuwane).

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

metric
string wymagany
marketcap

Która seria: marketcap lub volume.

Parametry zapytania

period
string opcjonalny
7d

24h, 7d, 30d lub all (domyślnie 24h).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 endpointów

Sentyment

Indeksy sentymentu rynkowego i dla poszczególnych monet. Strach i chciwość oraz byk/niedźwiedź to MIGAWKI odświeżane co 15 minut - istnieje tylko bieżący odczyt, nie ma dla nich szeregu czasowego. Altseason niesie pełną historię dzienną. indicators to ogólnorynkowe zestawienie techniczne.

Indeks strachu i chciwości

Free

Bieżący odczyt strachu i chciwości (15-minutowa migawka - bez historii). Pomiń coin dla indeksu ogólnorynkowego lub przekaż slug monety dla odczytu dla pojedynczej monety. intervals niesie podoceny 7d/30d i ich rozkład na składowe.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

coin
string opcjonalny
bitcoin

Slug monety dla odczytu dla pojedynczej monety; pomiń dla indeksu rynkowego.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Indeks byka / niedźwiedzia

Starter

Bieżący odczyt byka/niedźwiedzia (15-minutowa migawka - bez historii). Pomiń coin dla indeksu ogólnorynkowego lub przekaż slug monety dla odczytu dla pojedynczej monety.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

coin
string opcjonalny
bitcoin

Slug monety dla odczytu dla pojedynczej monety; pomiń dla indeksu rynkowego.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Indeks altseasonu

Starter

Bieżący odczyt altseasonu (liczba monet pokonujących BTC wśród top 100), z opcjonalną dzienną history. W przeciwieństwie do strachu i chciwości, altseason ma pełną dzienną historię - przekaż days, aby ją dołączyć.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

days
integer opcjonalny
30

Liczba dni dziennej historii do uwzględnienia (1–365; 0/pominięcie = tylko bieżące).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Zestawienie wskaźników rynkowych

Pro

Ogólnorynkowe zestawienie techniczne - 25 kategorii wskaźników zagregowanych, każda z jej bieżącym stanem, oceną i danymi kategorii.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 endpointów

Wskaźniki

Wskaźniki techniczne dla poszczególnych monet. Każdy wskaźnik ma własny dedykowany endpoint - oscylatory momentum (RSI, Stoch-RSI, CCI, MFI, Williams %R), linie bazowe trendu i ceny (SMA, MACD, VWAP), przepływ wolumenu (OBV, CMF), siłę trendu (ADX) oraz zmienność - plus pojedynczą wieloskładnikową migawkę. Każda rodzina to DZIENNA seria obliczana z dziennych świec (pełna retencja; młode aktywa zwracają początkowe rozgrzewkowe wartości null, dopóki nie zbierze się wystarczająca historia). Rodziny w skali ceny (SMA, VWAP, MACD, OBV) emitują łańcuchy dziesiętne; ograniczone oscylatory emitują liczby. Kilka okresów o długim oknie wymaga płatnego planu - zaznaczono to przy każdym endpoincie.

Migawka wskaźników

Pro

Wieloskładnikowa migawka - najświeższy state każdej kategorii wskaźnika (bullish/bearish/sheepish…), score i surowe data, w jednym ładunku. Idealna do szybkiego przeglądu na pulpicie; użyj dedykowanych endpointów dla poszczególnych wskaźników poniżej, aby uzyskać pełną dzienną historię.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Slug monety.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 (Wskaźnik siły względnej)

Starter

Dzienny wskaźnik siły względnej - oscylator momentum ograniczony do 0–100, który mierzy szybkość i wielkość ostatnich ruchów ceny. Powyżej 70 jest to umownie wykupienie, poniżej 30 wyprzedanie. Okna: 7, 14, 21, 28 dni (domyślnie 14) - okna 21- i 28-dniowe wymagają planu Starter lub wyższego. Młode monety zwracają początkowe rozgrzewkowe wartości null.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Slug monety.

Parametry zapytania

period
integer opcjonalny
14

Długość okna - jedna z wartości 7, 14, 21, 28 (domyślnie 14).

start
string opcjonalny
2026-06-01

Dolna granica daty ISO.

end
string opcjonalny
2026-06-30

Górna granica daty ISO.

limit
integer opcjonalny
30

Maks. wierszy (1–1000, domyślnie 365).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Stochastyczny RSI

Pro

Dzienny stochastyczny RSI - stosuje oscylator stochastyczny do samego RSI, dając szybszy, bardziej czuły odczyt momentum 0–100 z liniami %K i %D, które przecinają się, sygnalizując zwroty. Okna: 7, 14, 21, 28 dni (domyślnie 14) - okna 21- i 28-dniowe wymagają planu Starter lub wyższego.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Slug monety.

Parametry zapytania

period
integer opcjonalny
14

Długość okna - jedna z wartości 7, 14, 21, 28 (domyślnie 14).

start
string opcjonalny
2026-06-01

Dolna granica daty ISO.

end
string opcjonalny
2026-06-30

Górna granica daty ISO.

limit
integer opcjonalny
30

Maks. wierszy (1–1000, domyślnie 365).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 (Prosta średnia krocząca)

Starter

Dzienna prosta średnia krocząca - średnia arytmetyczna ceny zamknięcia w danym oknie, klasyczna linia bazowa trendu, którą traderzy odczytują pod kątem wsparć, oporów oraz złotych krzyży i krzyży śmierci. Okna: 50, 100, 200 dni (domyślnie 50). Wartości to łańcuchy dziesiętne w skali ceny.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Slug monety.

Parametry zapytania

period
integer opcjonalny
50

Długość okna - jedna z wartości 50, 100, 200 (domyślnie 50).

start
string opcjonalny
2026-06-01

Dolna granica daty ISO.

end
string opcjonalny
2026-06-30

Górna granica daty ISO.

limit
integer opcjonalny
30

Maks. wierszy (1–1000, domyślnie 365).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 (Wskaźnik kanału towarowego)

Starter

Dzienny wskaźnik kanału towarowego - mierzy, jak bardzo cena odchyliła się od swojej statystycznej średniej; odczyty przekraczające ±100 sygnalizują silne trendy lub potencjalne odwrócenia. Okna: 20, 50, 100 dni (domyślnie 20).

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Slug monety.

Parametry zapytania

period
integer opcjonalny
20

Długość okna - jedna z wartości 20, 50, 100 (domyślnie 20).

start
string opcjonalny
2026-06-01

Dolna granica daty ISO.

end
string opcjonalny
2026-06-30

Górna granica daty ISO.

limit
integer opcjonalny
30

Maks. wierszy (1–1000, domyślnie 365).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 (Wskaźnik przepływu pieniądza)

Pro

Dzienny wskaźnik przepływu pieniądza - RSI ważony wolumenem (0–100), który uwzględnia wolumen obrotu w pomiarze momentum, często nazywany "RSI wolumenu"; powyżej 80 wykupienie, poniżej 20 wyprzedanie. Okna: 7, 14, 28 dni (domyślnie 14).

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Slug monety.

Parametry zapytania

period
integer opcjonalny
14

Długość okna - jedna z wartości 7, 14, 28 (domyślnie 14).

start
string opcjonalny
2026-06-01

Dolna granica daty ISO.

end
string opcjonalny
2026-06-30

Górna granica daty ISO.

limit
integer opcjonalny
30

Maks. wierszy (1–1000, domyślnie 365).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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

Dzienny Williams %R - oscylator momentum ograniczony do −100–0, który pokazuje, gdzie zamknięcie plasuje się w ostatnim zakresie maksimum-minimum; powyżej −20 wykupienie, poniżej −80 wyprzedanie. Okna: 14, 20, 50 dni (domyślnie 14).

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Slug monety.

Parametry zapytania

period
integer opcjonalny
14

Długość okna - jedna z wartości 14, 20, 50 (domyślnie 14).

start
string opcjonalny
2026-06-01

Dolna granica daty ISO.

end
string opcjonalny
2026-06-30

Górna granica daty ISO.

limit
integer opcjonalny
30

Maks. wierszy (1–1000, domyślnie 365).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Zmienność ceny

Pro

Dzienny indeks zmienności ceny - rozproszenie dziennych stóp zwrotu w danym oknie, znormalizowany odczyt tego, jak nerwowa była akcja cenowa. Okna: 7, 14, 30 dni (domyślnie 7) - okno 30-dniowe wymaga planu Starter lub wyższego.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Slug monety.

Parametry zapytania

period
integer opcjonalny
7

Długość okna - jedna z wartości 7, 14, 30 (domyślnie 7).

start
string opcjonalny
2026-06-01

Dolna granica daty ISO.

end
string opcjonalny
2026-06-30

Górna granica daty ISO.

limit
integer opcjonalny
30

Maks. wierszy (1–1000, domyślnie 365).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Zmienność wolumenu

Starter

Dzienny indeks zmienności wolumenu - rozproszenie dziennego wolumenu obrotu w oknie, odczyt tego, jak nieregularna była aktywność. Okna: 7, 14, 30 dni (domyślnie 7) - okno 30-dniowe wymaga planu Starter lub wyższego.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Slug monety.

Parametry zapytania

period
integer opcjonalny
7

Długość okna - jedna z wartości 7, 14, 30 (domyślnie 7).

start
string opcjonalny
2026-06-01

Dolna granica daty ISO.

end
string opcjonalny
2026-06-30

Górna granica daty ISO.

limit
integer opcjonalny
30

Maks. wierszy (1–1000, domyślnie 365).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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

Dzienny MACD (zbieżność/rozbieżność średnich kroczących) - różnica EMA 12/26 z 9-okresową linią sygnału i histogramem, podstawowy wskaźnik trendu i momentum odczytywany pod kątem przecięć linii sygnału oraz zmian względem linii zero. Zwraca macd, signal i histogram jako łańcuchy dziesiętne. Brak parametru okna.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Slug monety.

Parametry zapytania

start
string opcjonalny
2026-06-01

Dolna granica daty ISO.

end
string opcjonalny
2026-06-30

Górna granica daty ISO.

limit
integer opcjonalny
30

Maks. wierszy (1–1000, domyślnie 365).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 (Wolumen zbilansowany)

Pro

Dzienny wolumen zbilansowany - skumulowana linia wolumenu, która dodaje wolumen w dni wzrostowe i odejmuje go w dni spadkowe, śledząc netto presję kupna względem sprzedaży oraz potwierdzając trendy cenowe (lub od nich odbiegając). Pojedyncza seria łańcuchów dziesiętnych.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Slug monety.

Parametry zapytania

start
string opcjonalny
2026-06-01

Dolna granica daty ISO.

end
string opcjonalny
2026-06-30

Górna granica daty ISO.

limit
integer opcjonalny
30

Maks. wierszy (1–1000, domyślnie 365).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 (Wskaźnik średniego ruchu kierunkowego)

Starter

Dzienny ADX z +DI/−DI - mierzy siłę trendu (adx) i jego kierunek (kierunkowe wskaźniki plus_di/minus_di). ADX powyżej 25 sygnalizuje silny trend niezależnie od kierunku; przecięcie DI wskazuje, w którą stronę. Pojedyncza seria, brak parametru okna.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Slug monety.

Parametry zapytania

start
string opcjonalny
2026-06-01

Dolna granica daty ISO.

end
string opcjonalny
2026-06-30

Górna granica daty ISO.

limit
integer opcjonalny
30

Maks. wierszy (1–1000, domyślnie 365).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 (Średnia cena ważona wolumenem)

Pro

Dzienny VWAP - średnia cena ważona wolumenem, podstawowy punkt odniesienia wartości godziwej i realizacji zleceń; cena powyżej VWAP odczytywana jest jako bycza, poniżej - niedźwiedzia. Pojedyncza seria łańcuchów dziesiętnych, brak parametru okna.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Slug monety.

Parametry zapytania

start
string opcjonalny
2026-06-01

Dolna granica daty ISO.

end
string opcjonalny
2026-06-30

Górna granica daty ISO.

limit
integer opcjonalny
30

Maks. wierszy (1–1000, domyślnie 365).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 (Przepływ pieniądza Chaikina)

Starter

Dzienny przepływ pieniądza Chaikina - sumuje wolumen przepływu pieniądza w okresie, aby ocenić akumulację względem dystrybucji; wartość dodatnia to netto presja kupna, ujemna

  • presja sprzedaży. Ograniczony w okolicach ±1. Pojedyncza seria, brak parametru okna.
GET
https://bitculator.com/api/v1/coins/{slug}/indicators/cmf
Bearer
bc_••••••••••••••••

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Slug monety.

Parametry zapytania

start
string opcjonalny
2026-06-01

Dolna granica daty ISO.

end
string opcjonalny
2026-06-30

Górna granica daty ISO.

limit
integer opcjonalny
30

Maks. wierszy (1–1000, domyślnie 365).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 endpointów

Konwersja

Przelicz między dowolnymi dwoma aktywnymi aktywami (krypto ORAZ fiat) i wypisz waluty używalne jako składniki konwersji. Wartości to łańcuchy dziesiętne. Kursy fiat FX odświeżają się ~dwa razy dziennie; kursy krypto ~co minutę.

Przelicz między aktywami

Free

Konwersja po stronie serwera między dowolnymi dwoma aktywnymi aktywami (krypto ORAZ fiat). to przyjmuje CSV do konwersji na wiele celów; odwrócenie to po prostu zamiana from/to. Konwersja jest liniowa, więc value = unit_rate * amount. Kursy fiat FX odświeżają się ~dwa razy dziennie; kursy krypto ~co minutę.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

from
string wymagany
bitcoin

Slug aktywu źródłowego.

to
string wymagany
ethereum

Slug(i) aktywu docelowego, oddzielone przecinkami (do 10).

amount
number opcjonalny
2.5

Ilość aktywu źródłowego do przeliczenia (domyślnie 1).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Wypisz waluty fiat

Free

Aktywne waluty fiat z ich kursami FX względem USD: rate_per_usd (jednostki na USD) i jego odwrotność usd_value. Kursy fiat FX odświeżają się ~dwa razy dziennie.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Wypisz kursy konwersji

Free

Waluty odniesienia używalne jako składniki konwersji - najważniejsze waluty fiat, monety i tokeny - każda ze znormalizowanym usd_value (USD za jedną jednostkę). Wartości monet/tokenów odświeżają się ~co minutę; wolne kursy fiat są buforowane osobno (~dwa razy dziennie).

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 endpointów

Kalkulatory

Kalkulatory finansowe po stronie serwera odzwierciedlające narzędzia webowe: DCA, zysk/strata i pożyczka (które odczytują buforowane dane rynkowe) oraz bezstanowe obliczenia procentu składanego i stakingu.

Kalkulator DCA

Free

Backtest uśredniania ceny (DCA) na prawdziwej dziennej historii cen monety: jeden zakup za amount na interval między start a end. Przekaż series=true, aby dołączyć pełną serię poszczególnych zakupów.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

slug
string wymagany
bitcoin

Identyfikator sluga monety.

amount
number wymagany
100

USD wydane na zakup (0.01–1,000,000,000).

interval
string wymagany
weekly

Częstotliwość zakupów: daily, weekly, monthly, quarterly lub yearly.

start
string wymagany
2024-01-01

date Data pierwszego zakupu (po 2008-12-31).

end
string opcjonalny
2025-01-01

date Data ostatniego zakupu (domyślnie dzisiaj).

series
boolean opcjonalny
false

Dołącz serię poszczególnych zakupów do payloadu.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Kalkulator zysku / straty

Free

Wynik zakupu, a następnie sprzedaży między dwiema datami historycznymi, przy użyciu rzeczywistych cen monety w tych datach. Opłaty to stałe kwoty w USD, nie procenty.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

slug
string wymagany
bitcoin

Identyfikator sluga monety.

amount
number wymagany
1000

USD zainwestowane w buy_date (0.01–1,000,000,000).

buy_date
string wymagany
2023-01-01

date Data zakupu.

sell_date
string wymagany
2025-01-01

date Data sprzedaży (w dniu buy_date lub później).

buy_fee
number opcjonalny
10

Stała opłata za zakup w USD (domyślnie 0).

sell_fee
number opcjonalny
10

Stała opłata za sprzedaż w USD (domyślnie 0).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Kalkulator procentu składanego

Free

Czysta matematyka - bez danych rynkowych. Zwróć uwagę, że stopa dotyczy OKRESU KAPITALIZACJI (zgodnie z konwencją kalkulatora webowego), a nie roku.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

principal
number wymagany
10000

Saldo początkowe w USD.

rate
number wymagany
1

Stopa procentowa w % na okres kapitalizacji.

duration
integer wymagany
5

Długość projekcji (lata są ograniczone do 50).

duration_unit
string opcjonalny
years

years (domyślnie) lub months.

compound_frequency
string opcjonalny
monthly

daily, weekly, monthly (domyślnie), quarterly lub annually.

contribution
number opcjonalny
100

Cykliczna wpłata w USD (domyślnie 0).

contribution_frequency
string opcjonalny
monthly

daily, weekly, monthly (domyślnie), quarterly lub annually.

Zapytanie GET - brak ciała zapytania.

Zapytanie

curl --request GET \
    --get "https://bitculator.com/api/v1/calculators/compound-interest?principal=10000&rate=1&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"

Kalkulator pożyczki kontra sprzedaży

Free

Pożyczka pod zastaw krypto kontra sprzedaż - porównuje oba scenariusze przy użyciu AKTUALNEJ ceny monety. Projekcja informacyjna, nie porada finansowa.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

slug
string wymagany
bitcoin

Identyfikator sluga monety.

crypto_amount
number wymagany
2

Ile monety posiadasz.

needed_cash
number wymagany
50000

USD, które musisz uwolnić.

term_months
integer opcjonalny
36

Okres pożyczki w miesiącach (domyślnie 36).

interest_rate
number opcjonalny
10

Oprocentowanie pożyczki (APR) w % (domyślnie 10).

ltv
number opcjonalny
50

Wskaźnik LTV (loan-to-value) w % (domyślnie 50).

expected_growth
number opcjonalny
25

Oczekiwany wzrost ceny monety w okresie w % (domyślnie 25).

tax_rate
number opcjonalny
25

Podatek od zysków kapitałowych w % zastosowany do sprzedaży (domyślnie 25).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Kalkulator nagród za staking

Free

Czysta matematyka - nagrody za staking z opcjonalną kapitalizacją i prowizją walidatora. Żadne dane rynkowe nie są odczytywane.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

amount
number wymagany
1000

Zestakowana ilość, w jednostkach stakowanego aktywu.

period
number wymagany
2

Długość okresu stakowania (ograniczona do równowartości 50 lat).

period_unit
string opcjonalny
years

years (domyślnie), months lub days.

apy
number wymagany
5

Reklamowane APY w %.

compound_frequency
string opcjonalny
monthly

never, daily, weekly, monthly (domyślnie) lub yearly.

commission
number opcjonalny
10

Prowizja walidatora w %, pobierana z nagród (domyślnie 0).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 endpointów

Treści redakcyjne

Artykuły redakcyjne - tylko opublikowane (ACTIVE). locale wybiera język treści z fallbackiem na angielski dla każdego pola (payload informuje, który locale faktycznie zwyciężył). Artykuły można filtrować po tagu lub po powiązanym slugu monety/giełdy/portfela. Odczyty przez API celowo NIE zwiększają licznika wyświetleń.

Wideo monety

Free

Wyselekcjonowane wideo przypisane do monety (zakładka Wideo na stronie monety), stronicowane.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Identyfikator sluga monety.

Parametry zapytania

page
integer opcjonalny
1

Numer strony (od 1).

per_page
integer opcjonalny
10

Wierszy na stronę (1–50, domyślnie 10).

type
string opcjonalny
review

Filtruj po typie wideo (np. overview, tutorial, explainer, review, analysis, news).

search
string opcjonalny
halving

Dopasowanie tekstowe po tytule.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Oś czasu analiz monety

Free

Oś czasu analiz monety - ten sam payload, którego używa panel analiz na stronie aktywu, ograniczony oknem offset/limit.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
bitcoin

Identyfikator sluga monety.

Parametry zapytania

locale
string opcjonalny
en

Język treści (fallback na angielski).

offset
integer opcjonalny
0

Wierszy do pominięcia (0–500, domyślnie 0).

limit
integer opcjonalny
5

Wierszy do zwrócenia (1–50, domyślnie 5).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Wypisz artykuły

Free

Opublikowane artykuły, najnowsze najpierw, stronicowane. Filtruj po tag lub po powiązanym slugu coin / exchange / wallet albo tekstowym search. Każdy wiersz to podsumowanie (tytuł, podtytuł, tagi, czas czytania, obraz główny, powiązane encje, daty).

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

page
integer opcjonalny
1

Numer strony (od 1).

per_page
integer opcjonalny
20

Wierszy na stronę (1–50, domyślnie 20).

locale
string opcjonalny
en

Język treści (fallback na angielski).

tag
string opcjonalny
guide

Filtruj po tagu: news, guide, tutorial, explainer, analysis, review, trading, overview lub information.

coin
string opcjonalny
bitcoin

Ogranicz do artykułów powiązanych z tym slugiem monety.

exchange
string opcjonalny
binance-exchange

Ogranicz do artykułów powiązanych z tym slugiem giełdy.

wallet
string opcjonalny
frostsnap

Ogranicz do artykułów powiązanych z tym slugiem portfela.

search
string opcjonalny
halving

Dopasowanie tekstowe po nagłówku/podnagłówku.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Pobierz artykuł

Free

Jeden opublikowany artykuł z pełną treścią, tagami, obrazem głównym, licznikami przydatności i powiązanymi encjami. locale wybiera język treści z fallbackiem na angielski dla każdego pola (payload informuje, który locale faktycznie zwyciężył).

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
what-is-bitcoin

Slug artykułu.

Parametry zapytania

locale
string opcjonalny
en

Język treści (fallback na angielski).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Prześlij opinię o artykule

Free

Rejestruje kciuk w górę/dół dla artykułu - te same liczniki, których używają przyciski przydatności w serwisie. Ograniczanie przepustowości per klucz obowiązuje wyżej.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

slug
string wymagany
what-is-bitcoin

Slug artykułu.

Parametry ciała

helpful
boolean wymagany
true

true dla przydatne, false dla nieprzydatne.

Zapytanie

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
}"

Pobierz wideo

Free

Jedno wyselekcjonowane wideo z jego identyfikatorem YouTube, tytułem, typem, czasem trwania oraz monetami/giełdami/portfelami, do których jest przypisane.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

id
integer wymagany
87

Identyfikator wideo.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Wypisz analizy

Free

Analizy rynkowe generowane przez AI, stronicowane. Filtruj po type, powiązanym slugu coin lub tekstowym search; locale wybiera język nagłówka/podsumowania z angielskim fallbackiem.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

page
integer opcjonalny
1

Numer strony (od 1).

per_page
integer opcjonalny
20

Wierszy na stronę (1–50, domyślnie 20).

locale
string opcjonalny
en

Język treści (fallback na angielski).

type
string opcjonalny
per_asset

Filtruj po typie analizy: per_asset, market_overview lub narrative.

coin
string opcjonalny
bitcoin

Ogranicz do analiz dotyczących tego sluga monety.

search
string opcjonalny
etf

Dopasowanie tekstowe po nagłówku.

sort
string opcjonalny
first_reported

Porządek sortowania: first_reported (domyślnie) lub last_updated.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Pobierz analizę

Free

Jedna analiza z pełnym payloadem - nagłówek, podsumowanie, oś czasu artykułów źródłowych i powiązane monety.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

id
integer wymagany
101

Identyfikator analizy.

Parametry zapytania

locale
string opcjonalny
en

Język treści (fallback na angielski).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 endpointów

Alarmy

CRUD alarmów cenowych - te same alarmy, którymi zarządza aplikacja webowa. Alarmy zużywają saldo inwentarza alarmów właściciela klucza, są typu TARGET tylko na monetach, a zabezpieczenie above/below względem bieżącej wartości blokuje alarmy, które wyzwoliłyby się natychmiast. Powiązane z kluczem (klucz API ustala właściciela) i nigdy nie buforowane w odpowiedzi.

Wypisz alarmy

Free

Alarmy właściciela klucza, najnowsze najpierw, stronicowane. Filtruj po status, direction lub kanale notification.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry zapytania

page
integer opcjonalny
1

Numer strony (od 1).

per_page
integer opcjonalny
25

Wierszy na stronę (1–100, domyślnie 25).

status
string opcjonalny
active

Filtruj po stanie: active lub triggered.

direction
string opcjonalny
above

Filtruj po kierunku wyzwalania: above lub below.

notification
string opcjonalny
email

Filtruj po kanale dostarczania: email, push lub webhook.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Utwórz alarm

Free

Tworzy alarm typu TARGET na monecie i zużywa jeden slot alarmu z salda właściciela klucza. Wartość docelowa jest sprawdzana względem bieżącej wartości monety, aby alarm nie mógł natychmiast się wyzwolić: alarm above musi mieć wartość docelową wyższą niż bieżąca wartość, a alarm below niższą.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ciała

name
string wymagany
BTC six figures

Etykieta alarmu (maks. 255 znaków).

coin
string wymagany
bitcoin

Identyfikator sluga monety.

metric
string wymagany
rate

Obserwowana metryka: rate, volume lub marketcap.

direction
string wymagany
above

Kierunek wyzwalania: above lub below.

target
number wymagany
100000

Wartość progowa (musi znajdować się po stronie direction względem bieżącej wartości monety).

notification
string wymagany
email

Kanał dostarczania: email, push lub webhook.

Zapytanie

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\"
}"

Usuń alarm

Free

Usuwa jeden z alarmów właściciela klucza i zwraca slot alarmu, który zajmował.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

id
integer wymagany
42

Identyfikator alarmu.

Zapytanie

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 endpointów

Webhooki

Bitculator wysyła każde zdarzenie metodą POST jako JSON z nagłówkiem podpisu HMAC:

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

Zweryfikuj go, przeliczając ponownie HMAC z "." przy użyciu sekretu Twojego endpointu i porównując w stałym czasie; odrzuć, jeśli t jest starsze niż kilka minut (ochrona przed powtórzeniem). Przykład (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);

Obsługiwane zdarzenia: alarm.triggered. Dostarczenia są ponawiane 3× z odczekiwaniem; endpoint wyłącza się automatycznie po 10 kolejnych nieudanych dostarczeniach.

Wypisz endpointy webhooków

Free

Endpointy webhooków właściciela klucza, najnowsze najpierw. Sekrety podpisujące nigdy nie są dołączane - każdy sekret jest pokazywany dokładnie raz, przy tworzeniu.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Utwórz endpoint webhooka

Free

Rejestruje endpoint HTTPS (maks. 5 na konto) do dostarczania zdarzeń. Odpowiedź zawiera secret do podpisywania - JEDYNY raz, kiedy jest pokazywany, więc zapisz go natychmiast.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ciała

url
string wymagany
https://example.com/webhooks/bitculator

Adres URL dostarczania HTTPS. Tylko hosty publiczne - adresy wewnętrzne/prywatne są odrzucane.

events
string[] wymagany
["alarm.triggered"]

Zdarzenia do subskrypcji. Dozwolone wartości: alarm.triggered.

Zapytanie

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\"
    ]
}"

Usuń endpoint webhooka

Free

Usuwa jeden z endpointów webhooków właściciela klucza. Oczekujące dostarczenia do niego są porzucane.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

id
integer wymagany
7

Identyfikator endpointu webhooka.

Zapytanie

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"

Wyślij zdarzenie testowe

Free

Wyzwala podpisane testowe zdarzenie alarm.triggered (test: true w payloadzie, prawdziwe nagłówki podpisu), aby odbiorcy mogli zostać zweryfikowani od początku do końca.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

id
integer wymagany
7

Identyfikator endpointu webhooka.

Zapytanie

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"

Dziennik dostarczeń webhooka

Free

Próby dostarczenia endpointu (przechowywane 30 dni), najnowsze najpierw, stronicowane.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Parametry ścieżki

id
integer wymagany
7

Identyfikator endpointu webhooka.

Parametry zapytania

page
integer opcjonalny
1

Numer strony (od 1).

per_page
integer opcjonalny
25

Wierszy na stronę (1–100, domyślnie 25).

Zapytanie GET - brak ciała zapytania.

Zapytanie

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 endpointów

Meta

Metadane i introspekcja API: uwierzytelniony ping weryfikujący klucz i stos middleware, zużycie/limit bieżącego klucza oraz maszynowo czytelną specyfikację OpenAPI.

Specyfikacja OpenAPI

Free

Maszynowo czytelny dokument OpenAPI 3 dla tego API, jako JSON - skieruj generatory kodu lub narzędzia API na ten adres URL. Publiczny: klucz nie jest wymagany.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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

Uwierzytelniona operacja pusta do sprawdzenia klucza Data API od początku do końca (auth.api → limit chwilowy zależny od planu → miesięczny limit). Liczy się do limitu jak każde inne wywołanie.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"

Zużycie i limit klucza

Free

Introspekcja zużycia dla właściciela wywołującego klucza: plan Data API, jego miesięczny limit, zużyte i pozostałe (zawsze zgodne z nagłówkami X-Quota-*), bieżące okno okresu oraz rozkłady dla poszczególnych endpointów / tokenów. Zużycie widżetów embed ma własny plan i pulę - nigdy nie pojawia się tutaj.

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

Klucze działają wyłącznie jako Bearer i niosą uprawnienie data-api - przechowuj je po stronie serwera.

Zapytanie GET - brak ciała zapytania.

Zapytanie

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"