Bitculator
Bitculator · Data API · v1

Bitculator Data API

73 endpointów 15 grup X-Quota-* w każdym wywołaniu http://localhost/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ść.

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.

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

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
http://localhost/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 "http://localhost/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

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
http://localhost/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 "http://localhost/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

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

GET
http://localhost/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 "http://localhost/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

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

GET
http://localhost/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 "http://localhost/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

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
http://localhost/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 "http://localhost/api/v1/coins/bitcoin?locale=en" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Historia świec

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
http://localhost/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 "http://localhost/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

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
http://localhost/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 "http://localhost/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

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

GET
http://localhost/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 "http://localhost/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

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
http://localhost/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 "http://localhost/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

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

GET
http://localhost/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 "http://localhost/api/v1/prices/bitcoin?convert=EUR" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Cena historyczna

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
http://localhost/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 "http://localhost/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

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
http://localhost/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 "http://localhost/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

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

GET
http://localhost/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 "http://localhost/api/v1/coins/bitcoin/symbols" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Wypisz tickery

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
http://localhost/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 "http://localhost/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

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

GET
http://localhost/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 "http://localhost/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

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

GET
http://localhost/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 "http://localhost/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

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

GET
http://localhost/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 "http://localhost/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

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
http://localhost/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 "http://localhost/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

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
http://localhost/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 "http://localhost/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

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
http://localhost/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 "http://localhost/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

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

GET
http://localhost/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 "http://localhost/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

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

GET
http://localhost/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 "http://localhost/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

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

GET
http://localhost/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 "http://localhost/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

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
http://localhost/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 "http://localhost/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

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
http://localhost/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 "http://localhost/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

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
http://localhost/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 "http://localhost/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

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
http://localhost/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 "http://localhost/api/v1/wallets/frostsnap" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Monety obsługiwane przez portfel

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

GET
http://localhost/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 "http://localhost/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

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
http://localhost/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 "http://localhost/api/v1/global" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Mapa cieplna rynku

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
http://localhost/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 "http://localhost/api/v1/global/heatmap" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Historia globalnej kapitalizacji / wolumenu

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
http://localhost/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 "http://localhost/api/v1/global/history/marketcap?period=7d" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
6 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.

Zestawienie głosów społeczności

Bycze/niedźwiedzie zestawienia społeczności dla monety w kroczącym oknie 24h.

GET
http://localhost/api/v1/coins/{slug}/votes
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.

Zapytanie GET — brak ciała zapytania.

Zapytanie

curl --request GET \
    --get "http://localhost/api/v1/coins/bitcoin/votes" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Oddaj głos sentymentu

Oddaje głos sentymentu właściciela klucza dla monety. Jeden głos na właściciela klucza na monetę w kroczącym oknie 24h — ponowne głosowanie w oknie aktualizuje istniejący głos.

POST
http://localhost/api/v1/coins/{slug}/votes
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 ciała

vote
string wymagany
bullish

Twój sentyment: bullish lub bearish.

Zapytanie

curl --request POST \
    "http://localhost/api/v1/coins/bitcoin/votes" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"vote\": \"bullish\"
}"

Indeks strachu i chciwości

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
http://localhost/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 "http://localhost/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

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
http://localhost/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 "http://localhost/api/v1/sentiment/bull-bear?coin=bitcoin" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Indeks altseasonu

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
http://localhost/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 "http://localhost/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

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

GET
http://localhost/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 "http://localhost/api/v1/sentiment/indicators" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
2 endpointów

Wskaźniki

Wskaźniki techniczne dla monety — wieloskładnikowa migawka oraz dzienne szeregi czasowe dla każdej rodziny. Wszystkie rodziny to serie DZIENNE obliczane ze świec dziennych (pełna retencja; młode aktywa zwracają null z rozgrzewki, dopóki nie istnieje wystarczająca historia). Rodziny w skali cenowej (sma, vwap, macd, obv) emitują łańcuchy dziesiętne; ograniczone oscylatory emitują liczby. Niektóre okresy o długim oknie wymagają planu płatnego (zobacz endpoint rodziny).

Migawka wskaźników

Wieloskładnikowa migawka wskaźników — najnowszy state każdej kategorii wskaźnika (byczy/niedźwiedzi/owczy…), score i surowe data, w jednym payloadzie.

GET
http://localhost/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 "http://localhost/api/v1/coins/bitcoin/indicators" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Seria rodziny wskaźników

Dzienny szereg czasowy jednej rodziny wskaźników. Rodziny z wieloma oknami przyjmują period, a prawidłowe okna różnią się w zależności od rodziny: RSI/Stoch-RSI 7/14/21/28, SMA 50/100/200, CCI 20/50/100, MFI 7/14/28, Williams %R 14/20/50, zmienność ceny/wolumenu 7/14/30. Rodziny jednoseryjne (MACD, OBV, ADX, VWAP, CMF) ignorują period. Młode monety zwracają początkowe null z okresu rozgrzewki.

Niektóre długie okna wymagają planu płatnego: RSI i Stoch-RSI 21/28-dniowe oraz 30-dniowe okna zmienności wymagają planu Starter lub wyższego — żądanie ich w planie Free zwraca 403 z kodem plan_required.

GET
http://localhost/api/v1/coins/{slug}/indicators/{family}
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.

family
string wymagany
rsi

Rodzina wskaźników — jedna z rsi, stoch-rsi, sma, cci, mfi, williams-r, price-volatility, volume-volatility, macd, obv, adx, vwap, cmf.

Parametry zapytania

period
integer opcjonalny
14

Długość okna (tylko tam, gdzie rodzina ma okna; musi być jednym z prawidłowych okien tej rodziny).

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 "http://localhost/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"
6 endpointów

Likwidacje

Likwidacje derywatów. Zakres źródła obejmuje obecnie tylko rynki swap OKX (podane w każdym meta.note). SUROWY strumień (lista /liquidations i rozkład godzinowy) jest usuwany po ~48 godzinach; agregaty dzienne są przechowywane na zawsze. Dzisiejsze agregaty są częściowe i aktualizują się co ~15 minut.

Strumień likwidacji

Surowy strumień likwidacji (~ostatnie 48h, potem usuwany), najnowsze najpierw. Zakres źródła obejmuje obecnie rynki swap OKX. Ceny to łańcuchy dziesiętne. meta niesie pola stronicowania oraz retention i note.

GET
http://localhost/api/v1/liquidations
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
okx

Ogranicz do jednej giełdy według sluga. Zakres źródła obejmuje obecnie rynki swap OKX. Musi pasować do wyrażenia regularnego /^[a-z0-9-]{1,120}$/.

instrument
string opcjonalny
swap

Typ instrumentu: future, option, swap, spot lub margin.

Jeden z: future option swap spot margin

position
string opcjonalny
short

Strona likwidowanej pozycji: long lub short.

Jeden z: long short

order
string opcjonalny
buy

Strona realizacji, która wyzwoliła likwidację: buy lub sell.

Jeden z: buy sell

symbol
string opcjonalny
BTC

Dopasowanie prefiksowe do instId platformy (np. BTC pasuje do BTC-USDT-SWAP). Musi pasować do wyrażenia regularnego /^[A-Za-z0-9$.-]{1,25}$/.

min_usd
number opcjonalny
1000

Tylko likwidacje o wartości w USD na tym progu lub wyższym. Musi wynosić co najmniej 0.

Zapytanie GET — brak ciała zapytania.

Zapytanie

curl --request GET \
    --get "http://localhost/api/v1/liquidations?page=1&per_page=50&exchange=okx&instrument=swap&position=short&order=buy&symbol=BTC&min_usd=1000" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Godzinowe likwidacje

Godzinowe sumy long/short w USD z surowego strumienia. Ponieważ surowy strumień jest usuwany po ~48h, hours jest ograniczone do 48. Zakres źródła obejmuje obecnie rynki swap OKX.

GET
http://localhost/api/v1/liquidations/hourly
Bearer
bc_••••••••••••••••

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

Parametry zapytania

hours
integer opcjonalny
24

Okno wsteczne w godzinach (1–48, domyślnie 24).

Zapytanie GET — brak ciała zapytania.

Zapytanie

curl --request GET \
    --get "http://localhost/api/v1/liquidations/hourly?hours=24" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Dzienne likwidacje

Agregaty dzienne (przechowywane na zawsze), sumowane między giełdami/instrumentami na dzień — total/long/short USD oraz liczby pozycji long/short. Wiersz z dzisiaj jest częściowy i aktualizuje się co ~15 minut. Zakres źródła obejmuje obecnie rynki swap OKX.

GET
http://localhost/api/v1/liquidations/daily
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 kalendarzowych włącznie z dzisiejszym (1–365, domyślnie 30).

Zapytanie GET — brak ciała zapytania.

Zapytanie

curl --request GET \
    --get "http://localhost/api/v1/liquidations/daily?days=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Podsumowanie dzisiejszych likwidacji

Dzisiaj do tej pory — total/long/short USD, liczby pozycji i dominance long kontra short. Dane są częściowe i aktualizują się co ~15 minut; data jest null do momentu zarejestrowania pierwszej likwidacji dnia. Zakres źródła obejmuje obecnie rynki swap OKX.

GET
http://localhost/api/v1/liquidations/summary
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 "http://localhost/api/v1/liquidations/summary" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Przepływ netto likwidacji

Dzienny przepływ likwidacji long kontra short w USD w oknie. Zakres źródła obejmuje obecnie rynki swap OKX.

GET
http://localhost/api/v1/liquidations/netflow
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 kalendarzowych włącznie z dzisiejszym (1–90, domyślnie 30).

Zapytanie GET — brak ciała zapytania.

Zapytanie

curl --request GET \
    --get "http://localhost/api/v1/liquidations/netflow?days=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Najczęściej likwidowane monety

Najlepsze monety według wolumenu likwidacji w ostatnim oknie, z podziałem long/short w USD na monetę. Zakres źródła obejmuje obecnie rynki swap OKX.

GET
http://localhost/api/v1/liquidations/coins
Bearer
bc_••••••••••••••••

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

Parametry zapytania

hours
integer opcjonalny
24

Okno wsteczne w godzinach (1–48, domyślnie 24).

limit
integer opcjonalny
8

Liczba monet do zwrócenia (1–20, domyślnie 8).

Zapytanie GET — brak ciała zapytania.

Zapytanie

curl --request GET \
    --get "http://localhost/api/v1/liquidations/coins?hours=24&limit=8" \
    --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

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
http://localhost/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 "http://localhost/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

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
http://localhost/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 "http://localhost/api/v1/fiats" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Wypisz kursy konwersji

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
http://localhost/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 "http://localhost/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

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
http://localhost/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 "http://localhost/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

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
http://localhost/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 "http://localhost/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

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

GET
http://localhost/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 "http://localhost/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

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

GET
http://localhost/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 "http://localhost/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

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

GET
http://localhost/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 "http://localhost/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

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

GET
http://localhost/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 "http://localhost/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

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

GET
http://localhost/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 "http://localhost/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

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
http://localhost/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 "http://localhost/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ł

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
http://localhost/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 "http://localhost/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

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
http://localhost/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 \
    "http://localhost/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

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

GET
http://localhost/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 "http://localhost/api/v1/videos/87" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Wypisz analizy

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
http://localhost/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 "http://localhost/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ę

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

GET
http://localhost/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 "http://localhost/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

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

GET
http://localhost/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 "http://localhost/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

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
http://localhost/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 \
    "http://localhost/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

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

DELETE
http://localhost/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 \
    "http://localhost/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

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
http://localhost/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 "http://localhost/api/v1/webhooks" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Utwórz endpoint webhooka

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
http://localhost/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 \
    "http://localhost/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

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

DELETE
http://localhost/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 \
    "http://localhost/api/v1/webhooks/7" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Wyślij zdarzenie testowe

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
http://localhost/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 \
    "http://localhost/api/v1/webhooks/7/test" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Dziennik dostarczeń webhooka

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

GET
http://localhost/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 "http://localhost/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

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
http://localhost/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 "http://localhost/api/v1/openapi.json" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Ping

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
http://localhost/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 "http://localhost/api/v1/ping" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Zużycie i limit klucza

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
http://localhost/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 "http://localhost/api/v1/usage" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"