Bitculator
Bitculator · API de date · v1

Bitculator Data API

Endpointuri: 76 Grupuri: 15 X-Quota-* la fiecare apel https://bitculator.com/api/v1

Toate endpointurile se află sub /api/v1 și necesită o cheie Bearer cu permisiunea data-api - creați una în consola dumneavoastră pentru dezvoltatori.

Primul dumneavoastră apel:

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

Răspunsurile sunt în format JSON. Prețurile, cursurile și ofertele sunt șiruri zecimale (numerele în virgulă mobilă nu pot păstra precizia pieței); numărătorile și valorile de statistici sunt numere. Fiecare răspuns transmite cota dumneavoastră în timp real în anteturile X-Quota-Limit / X-Quota-Used / X-Quota-Reset, iar erorile folosesc întotdeauna structura {"error": {"code", "message", "details"}}.

API-ul de date are propria cotă lunară, legată de abonamentul dumneavoastră de API și complet separată de widget-urile dumneavoastră încorporabile. Plafoanele per_page depind de abonament (Gratuit 100, Starter/Pro 250); depășirea unui plafon returnează 422 în loc să limiteze valoarea.

Biblioteci client

Nu aveți nevoie de un SDK - fiecare endpoint funcționează prin HTTP simplu. Dar, dacă preferați unul, există opt SDK-uri oficiale, licențiate MIT, care acoperă integral API-ul, cu paginare, erori tipizate și precizie cu șiruri zecimale incluse.

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

Autentificare

Pentru a autentifica cererile, includeți un antet Authorization: Bearer {YOUR_API_KEY} la fiecare cerere.

Creați o cheie pentru API-ul de date în consola dumneavoastră pentru dezvoltatori - cheile sunt doar de tip Bearer și au permisiunea data-api. Păstrați-le pe server; ele nu sunt niciodată destinate încorporării în partea de client.

Antetul Authorization
Creați o cheie →
Bearer
bc_••••••••••••••••

Se trimite ca Authorization: Bearer {YOUR_API_KEY} la fiecare cerere.

Fiecare endpoint afișează abonamentul minim necesar pentru a-l apela. Gratuit Starter Pro
Endpointuri: 9

Monede

Date de piață clasate pentru monede și tokenuri: listări paginate, detalii pentru o singură monedă, variații (creșteri/scăderi), adăugate recent, în tendință și serii temporale pentru fiecare monedă. Prețurile și oferta sunt ȘIRURI zecimale (numerele în virgulă mobilă nu pot păstra precizia pieței); capitalizarea de piață, volumul pe 24h, variațiile procentuale, rangurile și numărătorile sunt numere.

Listează monedele

Gratuit

Monede clasate, cu prețuri, filtre și selectoare, paginate cu structura links + meta din Laravel. Prețurile și circulating_supply sunt șiruri zecimale; capitalizarea de piață, volume_24h, variațiile și rangurile sunt numere.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

page
integer opțional
1

Numărul paginii (numerotare de la 1). Trebuie să fie cel puțin 1.

per_page
integer opțional
50

Rânduri pe pagină. Plafonul depinde de abonament (Gratuit 100, Starter/Pro 250); depășirea lui returnează 422 în loc să fie limitat. Trebuie să fie cel puțin 1. Nu trebuie să fie mai mare de 100.

type
string opțional
coin

Restrânge la un singur tip de activ: coin sau token.

Una dintre: coin token

status
string opțional
active

Stare de listare: active, delisted, untracked, progressing, awaiting sau preparing. Implicit, toate stările publice.

Una dintre: active delisted untracked progressing awaiting preparing

search
string opțional
bitcoin

Potrivire în text liber pe nume sau simbol. Nu trebuie să depășească 100 de caractere.

min_price
number opțional
0.5

Doar monedele cu preț mai mare sau egal cu această valoare în USD. Trebuie să fie cel puțin 0.

max_price
number opțional
100000

Doar monedele cu preț mai mic sau egal cu această valoare în USD. Trebuie să fie cel puțin 0.

min_marketcap
number opțional
1000000

Doar monedele cu o capitalizare de piață în USD mai mare sau egală cu această valoare. Trebuie să fie cel puțin 0.

max_marketcap
number opțional
5000000000000

Doar monedele cu o capitalizare de piață în USD mai mică sau egală cu această valoare. Trebuie să fie cel puțin 0.

min_volume
number opțional
1000000

Doar monedele cu volum în USD pe 24h mai mare sau egal cu această valoare. Trebuie să fie cel puțin 0.

max_volume
number opțional
100000000000

Doar monedele cu volum în USD pe 24h mai mic sau egal cu această valoare. Trebuie să fie cel puțin 0.

ids
string opțional
38,39

Limitați la anumite ID-uri de monede (CSV, până la 100 de selectoare combinate cu slugs/symbols). Nu trebuie să depășească 1000 de caractere.

slugs
string opțional
bitcoin,ethereum

Limitați la anumite sluguri de monede (CSV, până la 100 de selectoare combinate). Nu trebuie să depășească 2000 de caractere.

symbols
string opțional
BTC,ETH

Limitați la anumite simboluri de monede (CSV, fără diferențiere între majuscule și minuscule, până la 100 de selectoare combinate). Nu trebuie să depășească 1000 de caractere.

sort
string opțional
-marketcap

Câmpuri de sortare separate prin virgulă; prefixați cu - pentru ordine descrescătoare. Sortabile: marketcap, rank, price, volume_24h, change_24h, change_7d. Nu trebuie să depășească 100 de caractere.

interval
string opțional
24h

Intervalul pentru variații, doar pentru /coins/gainers și /coins/losers: 24h sau 7d.

Una dintre: 24h 7d

Cerere GET - fără corp al cererii.

Cerere

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

Monede adăugate recent

Gratuit

Cele mai noi listări - sortate după status_updated_at (momentul trecerii în starea activă; created_at este data indexării, care precedă listarea cu intervale arbitrare). Un sort înlocuiește ordinea implicită de la cele mai noi, ca la Listează monedele. Aceeași formă de rând și aceeași structură de paginare ca la Listează monedele.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

page
integer opțional
1

Numărul paginii (numerotare de la 1). Trebuie să fie cel puțin 1.

per_page
integer opțional
50

Rânduri pe pagină. Plafonul depinde de abonament (Gratuit 100, Starter/Pro 250); depășirea lui returnează 422 în loc să fie limitat. Trebuie să fie cel puțin 1. Nu trebuie să fie mai mare de 100.

type
string opțional
coin

Restrânge la un singur tip de activ: coin sau token.

Una dintre: coin token

status
string opțional
active

Stare de listare: active, delisted, untracked, progressing, awaiting sau preparing. Implicit, toate stările publice.

Una dintre: active delisted untracked progressing awaiting preparing

search
string opțional
bitcoin

Potrivire în text liber pe nume sau simbol. Nu trebuie să depășească 100 de caractere.

min_price
number opțional
0.5

Doar monedele cu preț mai mare sau egal cu această valoare în USD. Trebuie să fie cel puțin 0.

max_price
number opțional
100000

Doar monedele cu preț mai mic sau egal cu această valoare în USD. Trebuie să fie cel puțin 0.

min_marketcap
number opțional
1000000

Doar monedele cu o capitalizare de piață în USD mai mare sau egală cu această valoare. Trebuie să fie cel puțin 0.

max_marketcap
number opțional
5000000000000

Doar monedele cu o capitalizare de piață în USD mai mică sau egală cu această valoare. Trebuie să fie cel puțin 0.

min_volume
number opțional
1000000

Doar monedele cu volum în USD pe 24h mai mare sau egal cu această valoare. Trebuie să fie cel puțin 0.

max_volume
number opțional
100000000000

Doar monedele cu volum în USD pe 24h mai mic sau egal cu această valoare. Trebuie să fie cel puțin 0.

ids
string opțional
38,39

Limitați la anumite ID-uri de monede (CSV, până la 100 de selectoare combinate cu slugs/symbols). Nu trebuie să depășească 1000 de caractere.

slugs
string opțional
bitcoin,ethereum

Limitați la anumite sluguri de monede (CSV, până la 100 de selectoare combinate). Nu trebuie să depășească 2000 de caractere.

symbols
string opțional
BTC,ETH

Limitați la anumite simboluri de monede (CSV, fără diferențiere între majuscule și minuscule, până la 100 de selectoare combinate). Nu trebuie să depășească 1000 de caractere.

sort
string opțional
-marketcap

Câmpuri de sortare separate prin virgulă; prefixați cu - pentru ordine descrescătoare. Sortabile: marketcap, rank, price, volume_24h, change_24h, change_7d. Nu trebuie să depășească 100 de caractere.

interval
string opțional
24h

Intervalul pentru variații, doar pentru /coins/gainers și /coins/losers: 24h sau 7d.

Una dintre: 24h 7d

Cerere GET - fără corp al cererii.

Cerere

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

Top creșteri

Gratuit

Cele mai mari creșteri din fereastra interval (implicit 24h, sau 7d). Aceeași formă de rând și același înveliș de paginare ca la Listează monedele.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

page
integer opțional
1

Numărul paginii (numerotare de la 1). Trebuie să fie cel puțin 1.

per_page
integer opțional
50

Rânduri pe pagină. Plafonul depinde de abonament (Gratuit 100, Starter/Pro 250); depășirea lui returnează 422 în loc să fie limitat. Trebuie să fie cel puțin 1. Nu trebuie să fie mai mare de 100.

type
string opțional
coin

Restrânge la un singur tip de activ: coin sau token.

Una dintre: coin token

status
string opțional
active

Stare de listare: active, delisted, untracked, progressing, awaiting sau preparing. Implicit, toate stările publice.

Una dintre: active delisted untracked progressing awaiting preparing

search
string opțional
bitcoin

Potrivire în text liber pe nume sau simbol. Nu trebuie să depășească 100 de caractere.

min_price
number opțional
0.5

Doar monedele cu preț mai mare sau egal cu această valoare în USD. Trebuie să fie cel puțin 0.

max_price
number opțional
100000

Doar monedele cu preț mai mic sau egal cu această valoare în USD. Trebuie să fie cel puțin 0.

min_marketcap
number opțional
1000000

Doar monedele cu o capitalizare de piață în USD mai mare sau egală cu această valoare. Trebuie să fie cel puțin 0.

max_marketcap
number opțional
5000000000000

Doar monedele cu o capitalizare de piață în USD mai mică sau egală cu această valoare. Trebuie să fie cel puțin 0.

min_volume
number opțional
1000000

Doar monedele cu volum în USD pe 24h mai mare sau egal cu această valoare. Trebuie să fie cel puțin 0.

max_volume
number opțional
100000000000

Doar monedele cu volum în USD pe 24h mai mic sau egal cu această valoare. Trebuie să fie cel puțin 0.

ids
string opțional
38,39

Limitați la anumite ID-uri de monede (CSV, până la 100 de selectoare combinate cu slugs/symbols). Nu trebuie să depășească 1000 de caractere.

slugs
string opțional
bitcoin,ethereum

Limitați la anumite sluguri de monede (CSV, până la 100 de selectoare combinate). Nu trebuie să depășească 2000 de caractere.

symbols
string opțional
BTC,ETH

Limitați la anumite simboluri de monede (CSV, fără diferențiere între majuscule și minuscule, până la 100 de selectoare combinate). Nu trebuie să depășească 1000 de caractere.

sort
string opțional
-marketcap

Câmpuri de sortare separate prin virgulă; prefixați cu - pentru ordine descrescătoare. Sortabile: marketcap, rank, price, volume_24h, change_24h, change_7d. Nu trebuie să depășească 100 de caractere.

interval
string opțional
24h

Intervalul pentru variații, doar pentru /coins/gainers și /coins/losers: 24h sau 7d.

Una dintre: 24h 7d

Cerere GET - fără corp al cererii.

Cerere

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

Top scăderi

Gratuit

Cele mai mari scăderi din fereastra interval (implicit 24h, sau 7d). Aceeași formă de rând și același înveliș de paginare ca la Listează monedele.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

page
integer opțional
1

Numărul paginii (numerotare de la 1). Trebuie să fie cel puțin 1.

per_page
integer opțional
50

Rânduri pe pagină. Plafonul depinde de abonament (Gratuit 100, Starter/Pro 250); depășirea lui returnează 422 în loc să fie limitat. Trebuie să fie cel puțin 1. Nu trebuie să fie mai mare de 100.

type
string opțional
coin

Restrânge la un singur tip de activ: coin sau token.

Una dintre: coin token

status
string opțional
active

Stare de listare: active, delisted, untracked, progressing, awaiting sau preparing. Implicit, toate stările publice.

Una dintre: active delisted untracked progressing awaiting preparing

search
string opțional
bitcoin

Potrivire în text liber pe nume sau simbol. Nu trebuie să depășească 100 de caractere.

min_price
number opțional
0.5

Doar monedele cu preț mai mare sau egal cu această valoare în USD. Trebuie să fie cel puțin 0.

max_price
number opțional
100000

Doar monedele cu preț mai mic sau egal cu această valoare în USD. Trebuie să fie cel puțin 0.

min_marketcap
number opțional
1000000

Doar monedele cu o capitalizare de piață în USD mai mare sau egală cu această valoare. Trebuie să fie cel puțin 0.

max_marketcap
number opțional
5000000000000

Doar monedele cu o capitalizare de piață în USD mai mică sau egală cu această valoare. Trebuie să fie cel puțin 0.

min_volume
number opțional
1000000

Doar monedele cu volum în USD pe 24h mai mare sau egal cu această valoare. Trebuie să fie cel puțin 0.

max_volume
number opțional
100000000000

Doar monedele cu volum în USD pe 24h mai mic sau egal cu această valoare. Trebuie să fie cel puțin 0.

ids
string opțional
38,39

Limitați la anumite ID-uri de monede (CSV, până la 100 de selectoare combinate cu slugs/symbols). Nu trebuie să depășească 1000 de caractere.

slugs
string opțional
bitcoin,ethereum

Limitați la anumite sluguri de monede (CSV, până la 100 de selectoare combinate). Nu trebuie să depășească 2000 de caractere.

symbols
string opțional
BTC,ETH

Limitați la anumite simboluri de monede (CSV, fără diferențiere între majuscule și minuscule, până la 100 de selectoare combinate). Nu trebuie să depășească 1000 de caractere.

sort
string opțional
-marketcap

Câmpuri de sortare separate prin virgulă; prefixați cu - pentru ordine descrescătoare. Sortabile: marketcap, rank, price, volume_24h, change_24h, change_7d. Nu trebuie să depășească 100 de caractere.

interval
string opțional
24h

Intervalul pentru variații, doar pentru /coins/gainers și /coins/losers: 24h sau 7d.

Una dintre: 24h 7d

Cerere GET - fără corp al cererii.

Cerere

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

Obțineți detaliile unei monede

Gratuit

Profilul complet al unei singure monede. Pe lângă câmpurile din listă, adaugă: supply (circulantă/totală/maximă), OHLC pentru today, all_time_high / all_time_low (preț, data și percent_from față de prețul curent), fully_diluted_valuation (oferta maximă, altfel oferta totală, înmulțită cu prețul; null când niciuna nu este cunoscută), counts de piață (burse/perechi/tickere/portofele), decimals, genesis_date, links oficiale (listă de URL-uri tipizate), contracts ale tokenului și o description HTML localizată (revine la engleză atunci când limba solicitată lipsește). Toate câmpurile de preț/ofertă sunt șiruri zecimale.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Slugul monedei.

Parametri de interogare

locale
string opțional
en

Limba conținutului pentru descriere (revine la engleză).

Cerere GET - fără corp al cererii.

Cerere

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

Istoricul lumânărilor

Gratuit

Serii temporale OHLC + volum + capitalizare de piață, pentru fiecare monedă. Alegeți interval: minutely, half-hourly, hourly sau daily. Perioada de păstrare este o proprietate fixă a conductei de agregare - minutely 8 zile, half-hourly 3 luni, hourly 6 luni, daily pentru totdeauna; cererile care depășesc o fereastră returnează ceea ce există. Când este setat un limit, primiți CELE MAI RECENTE N rânduri din fereastră, emise de la cel mai vechi. Prețurile sunt șiruri zecimale.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Slugul monedei.

Parametri de interogare

interval
string opțional
daily

minutely, half-hourly, hourly sau daily (implicit daily).

start
string opțional
2026-06-01

Limita inferioară a datei/orei ISO.

end
string opțional
2026-06-30

Limita superioară a datei/orei ISO (o valoare care conține doar data înseamnă până la sfârșitul zilei respective).

limit
integer opțional
30

Număr maxim de rânduri (1–2000, implicit 1000).

Cerere GET - fără corp al cererii.

Cerere

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

Istoricul capitalizării de piață

Gratuit

Aceleași agregări per monedă ca la Istoricul lumânărilor, proiectate doar la {time, marketcap}. Aceleași opțiuni de interval și aceleași perioade de păstrare (minutely 8 zile, half-hourly 3 luni, hourly 6 luni, daily pentru totdeauna), cele mai recente N atunci când un limit este setat.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Slugul monedei.

Parametri de interogare

interval
string opțional
daily

minutely, half-hourly, hourly sau daily (implicit daily).

start
string opțional
2026-06-01

Limita inferioară a datei/orei ISO.

end
string opțional
2026-06-30

Limita superioară a datei/orei ISO.

limit
integer opțional
30

Număr maxim de rânduri (1–2000, implicit 1000).

Cerere GET - fără corp al cererii.

Cerere

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

Sparkline-ul monedei

Gratuit

O serie compactă de prețuri pentru monedă, pe intervalul period ales, pentru desenarea sparkline-urilor.

points este un eșantion de cel mult 480 de citiri, cele mai vechi primele, fiecare cu un price ca șir zecimal la un time în format ISO-8601. low și high sunt extremele reale ale întregii perioade - ele mărginesc fiecare punct, dar nu apar neapărat printre cele eșantionate. change este variația pe întreaga perioadă, în PROCENTE (1.25 înseamnă +1.25%).

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Slugul monedei.

Parametri de interogare

period
string opțional
7d

24h, 7d, 30d, 60d, 90d, 180d sau 365d (implicit 7d).

Cerere GET - fără corp al cererii.

Cerere

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

Prețuri

Calea rapidă și ușoară pentru prețuri - preț curent, capitalizare de piață, volum pe 24h și variații recente pentru un set de monede cerut. /prices necesită un selector (ids, slugs sau symbols); /prices/{slug} vizează o singură monedă. Opțional, cu convert puteți transforma într-o monedă fiat (prețurile cripto se reîmprospătează ~la fiecare minut, cursurile fiat ~de două ori pe zi). Prețurile sunt șiruri zecimale; capitalizarea de piață și volumul pe 24h sunt numere.

Obțineți prețuri

Gratuit

Prețurile pentru un set de monede cerut. Transmiteți cel puțin un selector - ids, slugs sau symbols (până la 100 în total). meta.currency repetă ținta conversiei (USD, dacă convert nu este setat).

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

ids
string opțional
38,39

ID-urile monedelor pentru care se afișează prețul (CSV). Este necesar cel puțin unul dintre ids, slugs sau symbols; cele trei liste sunt limitate la 100 de selectoare în total. Acest câmp este obligatoriu când nu sunt prezente nici slugs, nici symbols. Nu trebuie să depășească 1000 de caractere.

slugs
string opțional
bitcoin,ethereum

Slugurile monedelor pentru care se afișează prețul (CSV). Este necesar cel puțin unul dintre ids, slugs sau symbols. Acest câmp este obligatoriu când nu sunt prezente nici ids, nici symbols. Nu trebuie să depășească 2000 de caractere.

symbols
string opțional
BTC,ETH

Simbolurile monedelor pentru care se afișează prețul (CSV, fără diferențiere între majuscule și minuscule). Este necesar cel puțin unul dintre ids, slugs sau symbols. Acest câmp este obligatoriu când nu sunt prezente nici ids, nici slugs. Nu trebuie să depășească 1000 de caractere.

convert
string opțional
EUR

Convertiți prețurile/capitalizarea de piață în orice monedă fiat activă, după simbol (implicit USD). Cursurile valutare se actualizează de ~două ori pe zi.

Una dintre: 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

Cerere GET - fără corp al cererii.

Cerere

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

Obțineți prețul unei monede

Gratuit

Instantaneu de preț pentru o singură monedă. Opțional, cu convert puteți transforma în orice monedă fiat activă, după simbol (implicit USD).

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Slugul monedei.

Parametri de interogare

convert
string opțional
EUR

Simbolul monedei fiat active în care se exprimă prețul (implicit USD).

Cerere GET - fără corp al cererii.

Cerere

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

Preț istoric

Gratuit

Prețul în USD al monedei la o anumită dată, citit din istoricul zilnic (ziua exactă, rezervă de ±3 zile - același rezolvator folosit de portofoliu). Doar cripto: rândurile fiat nu au istoric zilnic.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

slug
string obligatoriu
bitcoin

Identificatorul slug al monedei.

date
string obligatoriu
2021-04-14

date Data căutată (după 2008-12-31, nu în viitor).

Cerere GET - fără corp al cererii.

Cerere

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

Piețe

Tickere (piețe per bursă) și perechi (piețe agregate pe platformă), plus piețele unei monede și simbolurile brute de tranzacționare per bursă. Toate sunt date de tip instantaneu - nu există istoric per ticker sau pereche. Volumele în USD sunt numere; prețurile sunt șiruri zecimale.

Piețele monedei

Gratuit

Toate piețele pentru o monedă - tickerele a căror pereche are moneda drept bază SAU cotare. Aceeași formă de rând și aceleași filtre ca la Listează tickerele.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Slugul monedei.

Parametri de interogare

page
integer opțional
1

Numărul paginii (numerotare de la 1). Trebuie să fie cel puțin 1.

per_page
integer opțional
50

Rânduri pe pagină. Plafonul depinde de abonament (Gratuit 100, Starter/Pro 250); depășirea lui returnează 422 în loc să fie limitat. Trebuie să fie cel puțin 1. Nu trebuie să fie mai mare de 100.

exchange
string opțional
binance-exchange

Restrânge la o singură bursă, după slug (omiteți pe listarea per bursă, care este deja delimitată). Trebuie să corespundă expresiei regulate /^[a-z0-9-]{1,120}$/.

pair
integer opțional
1

Restrânge la o singură pereche, după ID. Trebuie să fie cel puțin 1.

instrument
string opțional
spot

Tipul instrumentului: future, option, swap, spot sau margin (se acceptă și formele de plural).

Una dintre: future option swap spot margin

search
string opțional
BTC

Potrivire în text liber pe simbolul tickerului. Nu trebuie să depășească 50 de caractere.

min_volume
number opțional
1000000

Doar tickerele cu volum în USD pe 24h mai mare sau egal cu această valoare. Trebuie să fie cel puțin 0.

max_volume
number opțional
100000000000

Doar tickerele cu volum în USD pe 24h mai mic sau egal cu această valoare. Trebuie să fie cel puțin 0.

min_change
number opțional
-50

Doar tickerele cu o variație procentuală pe 24h mai mare sau egală cu această valoare.

max_change
number opțional
50

Doar tickerele cu o variație procentuală pe 24h mai mică sau egală cu această valoare.

sort
string opțional
-volume_usd

Un singur câmp de sortare (prefixați cu - pentru ordine descrescătoare). Sortabile: volume_usd, change_24h, price_usd, updated. Implicit -volume_usd. Nu trebuie să depășească 100 de caractere.

Cerere GET - fără corp al cererii.

Cerere

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

Simbolurile de tranzacționare ale monedelor

Gratuit

Simbolurile brute de tranzacționare ale monedei, pentru fiecare bursă - date de referință incomplete (acoperirea este pe cât posibil).

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Slugul monedei.

Cerere GET - fără corp al cererii.

Cerere

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

Listează tickerele

Gratuit

Piețe individuale pentru fiecare bursă (tickere), paginate. Filtrați după bursă, pereche, instrument și intervale de volum/variație. Volumele în USD sunt numere; prețurile sunt șiruri zecimale.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

page
integer opțional
1

Numărul paginii (numerotare de la 1). Trebuie să fie cel puțin 1.

per_page
integer opțional
50

Rânduri pe pagină. Plafonul depinde de abonament (Gratuit 100, Starter/Pro 250); depășirea lui returnează 422 în loc să fie limitat. Trebuie să fie cel puțin 1. Nu trebuie să fie mai mare de 100.

exchange
string opțional
binance-exchange

Restrânge la o singură bursă, după slug (omiteți pe listarea per bursă, care este deja delimitată). Trebuie să corespundă expresiei regulate /^[a-z0-9-]{1,120}$/.

pair
integer opțional
1

Restrânge la o singură pereche, după ID. Trebuie să fie cel puțin 1.

instrument
string opțional
spot

Tipul instrumentului: future, option, swap, spot sau margin (se acceptă și formele de plural).

Una dintre: future option swap spot margin

search
string opțional
BTC

Potrivire în text liber pe simbolul tickerului. Nu trebuie să depășească 50 de caractere.

min_volume
number opțional
1000000

Doar tickerele cu volum în USD pe 24h mai mare sau egal cu această valoare. Trebuie să fie cel puțin 0.

max_volume
number opțional
100000000000

Doar tickerele cu volum în USD pe 24h mai mic sau egal cu această valoare. Trebuie să fie cel puțin 0.

min_change
number opțional
-50

Doar tickerele cu o variație procentuală pe 24h mai mare sau egală cu această valoare.

max_change
number opțional
50

Doar tickerele cu o variație procentuală pe 24h mai mică sau egală cu această valoare.

sort
string opțional
-volume_usd

Un singur câmp de sortare (prefixați cu - pentru ordine descrescătoare). Sortabile: volume_usd, change_24h, price_usd, updated. Implicit -volume_usd. Nu trebuie să depășească 100 de caractere.

Cerere GET - fără corp al cererii.

Cerere

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

Listează perechile

Gratuit

Perechi de tranzacționare agregate pe platforme, clasate după volumul USD pe 24h. Filtrați după slugul unei monede (bază sau cotare) și după intervalul de volum.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

page
integer opțional
1

Numărul paginii (numerotare de la 1). Trebuie să fie cel puțin 1.

per_page
integer opțional
50

Rânduri pe pagină. Plafonul depinde de abonament (Gratuit 100, Starter/Pro 250); depășirea lui returnează 422 în loc să fie limitat. Trebuie să fie cel puțin 1. Nu trebuie să fie mai mare de 100.

search
string opțional
BTC

Potrivire în text liber pe simbolul perechii. Nu trebuie să depășească 50 de caractere.

coin
string opțional
bitcoin

Restrânge la perechile în care acest slug de monedă este activul de bază sau de cotare. Trebuie să corespundă expresiei regulate /^[a-z0-9-]{1,120}$/.

min_volume
number opțional
1000000

Doar perechile cu volum în USD pe 24h mai mare sau egal cu această valoare. Trebuie să fie cel puțin 0.

max_volume
number opțional
100000000000

Doar perechile cu volum în USD pe 24h mai mic sau egal cu această valoare. Trebuie să fie cel puțin 0.

sort
string opțional
-volume_usd

Câmpul de sortare: volume_usd sau updated (prefixați cu - pentru ordine descrescătoare). Implicit -volume_usd.

Una dintre: volume_usd -volume_usd updated -updated

Cerere GET - fără corp al cererii.

Cerere

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

Obțineți detaliile unei perechi

Gratuit

O pereche plus fiecare ticker de bursă care o listează, ordonate după volum.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

id
integer obligatoriu
1

ID-ul perechii.

Cerere GET - fără corp al cererii.

Cerere

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

Burse

Clasamente de burse, detalii, scoruri de încredere, serii temporale și listări de piețe/monede pentru fiecare bursă. Volumele sunt în USD. Nu există o coloană CEX/DEX - type este derivat din taxonomia burselor, deci poate fi "cex", "dex" sau null.

Listează bursele

Gratuit

Burse clasate, cu volum pe 24h, dominanță, numărul de perechi/active și variații recente. Paginate cu structura links + meta din Laravel.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

page
integer opțional
1

Numărul paginii (numerotare de la 1). Trebuie să fie cel puțin 1.

per_page
integer opțional
50

Rânduri pe pagină. Plafonul depinde de abonament (Gratuit 100, Starter/Pro 250); depășirea lui returnează 422 în loc să fie limitat. Trebuie să fie cel puțin 1. Nu trebuie să fie mai mare de 100.

type
string opțional
cex

Restrânge la un tip de platformă: cex sau dex (rezolvat prin taxonomia burselor).

Una dintre: cex dex

search
string opțional
binance

Potrivire în text liber pe numele bursei. Nu trebuie să depășească 100 de caractere.

min_pairs
integer opțional
100

Doar bursele care listează cel puțin acest număr de perechi. Trebuie să fie cel puțin 0.

max_pairs
integer opțional
2000

Doar bursele care listează cel mult acest număr de perechi. Trebuie să fie cel puțin 0.

min_assets
integer opțional
50

Doar bursele care listează cel puțin acest număr de active. Trebuie să fie cel puțin 0.

max_assets
integer opțional
1000

Doar bursele care listează cel mult acest număr de active. Trebuie să fie cel puțin 0.

min_volume
number opțional
1000000

Doar bursele cu volum în USD pe 24h mai mare sau egal cu această valoare. Trebuie să fie cel puțin 0.

max_volume
number opțional
100000000000

Doar bursele cu volum în USD pe 24h mai mic sau egal cu această valoare. Trebuie să fie cel puțin 0.

ids
string opțional
1,12

Limitați la anumite ID-uri de burse (CSV, până la 100). Nu trebuie să depășească 1000 de caractere.

slugs
string opțional
binance-exchange,gateio

Limitați la anumite sluguri de burse (CSV, până la 100). Nu trebuie să depășească 2000 de caractere.

sort
string opțional
-volume

Câmpuri de sortare separate prin virgulă; prefixați cu - pentru ordine descrescătoare. Sortabile: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets. Nu trebuie să depășească 100 de caractere.

Cerere GET - fără corp al cererii.

Cerere

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

Obțineți detaliile unei burse

Gratuit

Profilul complet al unei singure burse: rang, volum/dominanță, numărul de perechi și de active, data established, location, website de recomandare și type-ul derivat (cex/dex/null).

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
binance-exchange

Slugul bursei.

Cerere GET - fără corp al cererii.

Cerere

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

Obțineți scorul de încredere al unei burse

Gratuit

Un score agregat de încredere 0–10 plus breakdown-ul său cu 13 factori (rank, volume, age, volume_trend, stability, rank_stability, ticker_health, pairs, community, assets, dominance, market_breadth, transparency). Calculat pentru fiecare bursă și păstrat în cache 24h.

O bursă fără rang (încă fără volum spot activ, deci rank este null) nu primește scor: score și breakdown sunt ambele null.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
binance-exchange

Slugul bursei.

Cerere GET - fără corp al cererii.

Cerere

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

Istoricul bursei

Starter

Serii temporale de volum / dominanță / perechi / active (agregările burselor nu conțin OHLC). Alegeți interval: minutely, hourly sau daily. Retenția este o proprietate fixă a fluxului de agregare - minutely 8 zile, hourly 6 luni, daily pentru totdeauna; când este setat un limit, primiți cele mai recente N rânduri din interval, cele mai vechi primele.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
binance-exchange

Slugul bursei.

Parametri de interogare

interval
string opțional
daily

minutely, hourly sau daily (implicit daily).

start
string opțional
2026-06-01

Limita inferioară a datei/orei ISO.

end
string opțional
2026-06-30

Limita superioară a datei/orei ISO (o valoare care conține doar data înseamnă până la sfârșitul zilei respective).

limit
integer opțional
30

Număr maxim de rânduri (1–2000, implicit 1000).

Cerere GET - fără corp al cererii.

Cerere

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

Sparkline-ul bursei

Starter

Seria sparkline de volum a bursei pentru o perioadă (implicit 7d) - aceeași serie pe care o redau rândurile de burse din web.

points este un eșantion de cel mult 480 de citiri, de la cel mai vechi, fiecare cu un volume la un time ISO-8601. low și high sunt extremele reale ale întregii perioade - ele mărginesc fiecare punct, dar nu trebuie să apară printre cele eșantionate. change este variația pe întreaga perioadă, în PROCENTE (1.25 înseamnă +1.25%).

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
binance-exchange

Slugul bursei.

Parametri de interogare

period
string opțional
7d

Una dintre valorile 24h, 7d (implicit), 30d, 60d, 90d, 180d, 365d.

Cerere GET - fără corp al cererii.

Cerere

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

Piețele bursei

Gratuit

Listările de tickere ale bursei (piețele sale), paginate. Sunt deja delimitate la bursă - nu transmiteți aici un parametru exchange.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
binance-exchange

Slugul bursei.

Parametri de interogare

page
integer opțional
1

Numărul paginii (numerotare de la 1). Trebuie să fie cel puțin 1.

per_page
integer opțional
50

Rânduri pe pagină. Plafonul depinde de abonament (Gratuit 100, Starter/Pro 250); depășirea lui returnează 422 în loc să fie limitat. Trebuie să fie cel puțin 1. Nu trebuie să fie mai mare de 100.

exchange
string opțional
binance-exchange

Restrânge la o singură bursă, după slug (omiteți pe listarea per bursă, care este deja delimitată). Trebuie să corespundă expresiei regulate /^[a-z0-9-]{1,120}$/.

pair
integer opțional
1

Restrânge la o singură pereche, după ID. Trebuie să fie cel puțin 1.

instrument
string opțional
spot

Tipul instrumentului: future, option, swap, spot sau margin (se acceptă și formele de plural).

Una dintre: future option swap spot margin

search
string opțional
BTC

Potrivire în text liber pe simbolul tickerului. Nu trebuie să depășească 50 de caractere.

min_volume
number opțional
1000000

Doar tickerele cu volum în USD pe 24h mai mare sau egal cu această valoare. Trebuie să fie cel puțin 0.

max_volume
number opțional
100000000000

Doar tickerele cu volum în USD pe 24h mai mic sau egal cu această valoare. Trebuie să fie cel puțin 0.

min_change
number opțional
-50

Doar tickerele cu o variație procentuală pe 24h mai mare sau egală cu această valoare.

max_change
number opțional
50

Doar tickerele cu o variație procentuală pe 24h mai mică sau egală cu această valoare.

sort
string opțional
-volume_usd

Un singur câmp de sortare (prefixați cu - pentru ordine descrescătoare). Sortabile: volume_usd, change_24h, price_usd, updated. Implicit -volume_usd. Nu trebuie să depășească 100 de caractere.

Cerere GET - fără corp al cererii.

Cerere

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

Monedele bursei

Gratuit

Monedele listate la bursă, returnate în aceeași formă ca la Listează monedele și acceptând aceleași filtre/sortări.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
binance-exchange

Slugul bursei.

Parametri de interogare

page
integer opțional
1

Numărul paginii (numerotare de la 1). Trebuie să fie cel puțin 1.

per_page
integer opțional
50

Rânduri pe pagină. Plafonul depinde de abonament (Gratuit 100, Starter/Pro 250); depășirea lui returnează 422 în loc să fie limitat. Trebuie să fie cel puțin 1. Nu trebuie să fie mai mare de 100.

type
string opțional
coin

Restrânge la un singur tip de activ: coin sau token.

Una dintre: coin token

status
string opțional
active

Stare de listare: active, delisted, untracked, progressing, awaiting sau preparing. Implicit, toate stările publice.

Una dintre: active delisted untracked progressing awaiting preparing

search
string opțional
bitcoin

Potrivire în text liber pe nume sau simbol. Nu trebuie să depășească 100 de caractere.

min_price
number opțional
0.5

Doar monedele cu preț mai mare sau egal cu această valoare în USD. Trebuie să fie cel puțin 0.

max_price
number opțional
100000

Doar monedele cu preț mai mic sau egal cu această valoare în USD. Trebuie să fie cel puțin 0.

min_marketcap
number opțional
1000000

Doar monedele cu o capitalizare de piață în USD mai mare sau egală cu această valoare. Trebuie să fie cel puțin 0.

max_marketcap
number opțional
5000000000000

Doar monedele cu o capitalizare de piață în USD mai mică sau egală cu această valoare. Trebuie să fie cel puțin 0.

min_volume
number opțional
1000000

Doar monedele cu volum în USD pe 24h mai mare sau egal cu această valoare. Trebuie să fie cel puțin 0.

max_volume
number opțional
100000000000

Doar monedele cu volum în USD pe 24h mai mic sau egal cu această valoare. Trebuie să fie cel puțin 0.

ids
string opțional
38,39

Limitați la anumite ID-uri de monede (CSV, până la 100 de selectoare combinate cu slugs/symbols). Nu trebuie să depășească 1000 de caractere.

slugs
string opțional
bitcoin,ethereum

Limitați la anumite sluguri de monede (CSV, până la 100 de selectoare combinate). Nu trebuie să depășească 2000 de caractere.

symbols
string opțional
BTC,ETH

Limitați la anumite simboluri de monede (CSV, fără diferențiere între majuscule și minuscule, până la 100 de selectoare combinate). Nu trebuie să depășească 1000 de caractere.

sort
string opțional
-marketcap

Câmpuri de sortare separate prin virgulă; prefixați cu - pentru ordine descrescătoare. Sortabile: marketcap, rank, price, volume_24h, change_24h, change_7d. Nu trebuie să depășească 100 de caractere.

interval
string opțional
24h

Intervalul pentru variații, doar pentru /coins/gainers și /coins/losers: 24h sau 7d.

Una dintre: 24h 7d

Cerere GET - fără corp al cererii.

Cerere

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

Portofele

Recenzii de portofele cripto - score-ul recenziei, numărul de active acceptate, numărul de avantaje/dezavantaje, modelul de preț și data lansării, plus o taxonomie de etichete grupate în răspunsurile de detaliu/comparație. meta.top_score este cel mai mare scor dintre toate portofelele (folosiți-l pentru a normaliza scorurile într-un interval 0–1).

Listează portofelele

Gratuit

Portofele recenzate, cu scor, numărul de active, numărul de avantaje/dezavantaje, model de preț, stare și dată de lansare. Paginate cu structura links + meta din Laravel, plus meta.top_score.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

page
integer opțional
1

Numărul paginii (numerotare de la 1). Trebuie să fie cel puțin 1.

per_page
integer opțional
50

Rânduri pe pagină. Plafonul depinde de abonament (Gratuit 100, Starter/Pro 250); depășirea lui returnează 422 în loc să fie limitat. Trebuie să fie cel puțin 1. Nu trebuie să fie mai mare de 100.

search
string opțional
ledger

Potrivire în text liber pe numele portofelului. Nu trebuie să depășească 100 de caractere.

min_score
integer opțional
50

Doar portofelele cu un scor de recenzie mai mare sau egal cu această valoare. Trebuie să fie cel puțin 0.

max_score
integer opțional
214

Doar portofelele cu un scor de recenzie mai mic sau egal cu această valoare. Trebuie să fie cel puțin 0.

tags
string opțional
12,34

Filtrați după taxonomia de etichete: ID-uri de grupuri de categorii separate prin virgulă (aceleași ID-uri pe care le trimit filtrele pe fațete din site). Nu trebuie să depășească 1000 de caractere.

ids
string opțional
175,317

Limitați la anumite ID-uri de portofele (CSV, până la 100). Nu trebuie să depășească 1000 de caractere.

slugs
string opțional
frostsnap,coin98-fusion-card

Limitați la anumite sluguri de portofele (CSV, până la 100). Nu trebuie să depășească 2000 de caractere.

sort
string opțional
-score

Câmpuri de sortare separate prin virgulă; prefixați cu - pentru ordine descrescătoare. Sortabile: score, released_at, assets, pros, cons. Nu trebuie să depășească 100 de caractere.

Cerere GET - fără corp al cererii.

Cerere

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

Cronologia lansărilor portofelului

Gratuit

Lista de portofele fixată pe released_at descrescător (portofelele fără dată la final). Aceeași formă de rând și aceeași structură de paginare ca la Listează portofelele.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

page
integer opțional
1

Numărul paginii (numerotare de la 1). Trebuie să fie cel puțin 1.

per_page
integer opțional
50

Rânduri pe pagină. Plafonul depinde de abonament (Gratuit 100, Starter/Pro 250); depășirea lui returnează 422 în loc să fie limitat. Trebuie să fie cel puțin 1. Nu trebuie să fie mai mare de 100.

search
string opțional
ledger

Potrivire în text liber pe numele portofelului. Nu trebuie să depășească 100 de caractere.

min_score
integer opțional
50

Doar portofelele cu un scor de recenzie mai mare sau egal cu această valoare. Trebuie să fie cel puțin 0.

max_score
integer opțional
214

Doar portofelele cu un scor de recenzie mai mic sau egal cu această valoare. Trebuie să fie cel puțin 0.

tags
string opțional
12,34

Filtrați după taxonomia de etichete: ID-uri de grupuri de categorii separate prin virgulă (aceleași ID-uri pe care le trimit filtrele pe fațete din site). Nu trebuie să depășească 1000 de caractere.

ids
string opțional
175,317

Limitați la anumite ID-uri de portofele (CSV, până la 100). Nu trebuie să depășească 1000 de caractere.

slugs
string opțional
frostsnap,coin98-fusion-card

Limitați la anumite sluguri de portofele (CSV, până la 100). Nu trebuie să depășească 2000 de caractere.

sort
string opțional
-score

Câmpuri de sortare separate prin virgulă; prefixați cu - pentru ordine descrescătoare. Sortabile: score, released_at, assets, pros, cons. Nu trebuie să depășească 100 de caractere.

Cerere GET - fără corp al cererii.

Cerere

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

Comparați portofele

Gratuit

Comparație în paralel a 2–4 portofele, cu întreaga taxonomie de etichete grupate. data[] păstrează ordinea slugurilor cerute, astfel încât consumatorii pot reda coloanele pozițional.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

slugs
string obligatoriu
frostsnap,coin98-fusion-card

2–4 sluguri distincte de portofel, separate prin virgulă.

Cerere GET - fără corp al cererii.

Cerere

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

Obțineți detaliile unui portofel

Gratuit

Profilul complet al unui singur portofel, inclusiv taxonomia de etichete grupate: categories este o listă de {group, tags[]}, în care fiecare etichetă are un slug, un nume și o valoare opțională. meta.top_score este cel mai mare scor dintre toate portofelele.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
frostsnap

Slugul portofelului.

Cerere GET - fără corp al cererii.

Cerere

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

Monede acceptate de portofel

Gratuit

Monedele acceptate de portofel, returnate în aceeași formă ca la Listează monedele și acceptând aceleași filtre/sortări.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
frostsnap

Slugul portofelului.

Parametri de interogare

page
integer opțional
1

Numărul paginii (numerotare de la 1). Trebuie să fie cel puțin 1.

per_page
integer opțional
50

Rânduri pe pagină. Plafonul depinde de abonament (Gratuit 100, Starter/Pro 250); depășirea lui returnează 422 în loc să fie limitat. Trebuie să fie cel puțin 1. Nu trebuie să fie mai mare de 100.

type
string opțional
coin

Restrânge la un singur tip de activ: coin sau token.

Una dintre: coin token

status
string opțional
active

Stare de listare: active, delisted, untracked, progressing, awaiting sau preparing. Implicit, toate stările publice.

Una dintre: active delisted untracked progressing awaiting preparing

search
string opțional
bitcoin

Potrivire în text liber pe nume sau simbol. Nu trebuie să depășească 100 de caractere.

min_price
number opțional
0.5

Doar monedele cu preț mai mare sau egal cu această valoare în USD. Trebuie să fie cel puțin 0.

max_price
number opțional
100000

Doar monedele cu preț mai mic sau egal cu această valoare în USD. Trebuie să fie cel puțin 0.

min_marketcap
number opțional
1000000

Doar monedele cu o capitalizare de piață în USD mai mare sau egală cu această valoare. Trebuie să fie cel puțin 0.

max_marketcap
number opțional
5000000000000

Doar monedele cu o capitalizare de piață în USD mai mică sau egală cu această valoare. Trebuie să fie cel puțin 0.

min_volume
number opțional
1000000

Doar monedele cu volum în USD pe 24h mai mare sau egal cu această valoare. Trebuie să fie cel puțin 0.

max_volume
number opțional
100000000000

Doar monedele cu volum în USD pe 24h mai mic sau egal cu această valoare. Trebuie să fie cel puțin 0.

ids
string opțional
38,39

Limitați la anumite ID-uri de monede (CSV, până la 100 de selectoare combinate cu slugs/symbols). Nu trebuie să depășească 1000 de caractere.

slugs
string opțional
bitcoin,ethereum

Limitați la anumite sluguri de monede (CSV, până la 100 de selectoare combinate). Nu trebuie să depășească 2000 de caractere.

symbols
string opțional
BTC,ETH

Limitați la anumite simboluri de monede (CSV, fără diferențiere între majuscule și minuscule, până la 100 de selectoare combinate). Nu trebuie să depășească 1000 de caractere.

sort
string opțional
-marketcap

Câmpuri de sortare separate prin virgulă; prefixați cu - pentru ordine descrescătoare. Sortabile: marketcap, rank, price, volume_24h, change_24h, change_7d. Nu trebuie să depășească 100 de caractere.

interval
string opțional
24h

Intervalul pentru variații, doar pentru /coins/gainers și /coins/losers: 24h sau 7d.

Una dintre: 24h 7d

Cerere GET - fără corp al cererii.

Cerere

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

Piața globală

Agregate pentru întreaga piață - capitalizare de piață și volum total, numărul de active/burse/perechi/piețe, dominanța BTC/ETH cu un top-3 bazat pe rang, valoarea indicelui de frică și lăcomie al pieței, plus o hartă termică a top-100 și istoricul capitalizării de piață și al volumului.

Instantaneu al pieței globale

Gratuit

Privire de ansamblu asupra pieței, într-un singur apel: capitalizare de piață totală și volum pe 24h, numărul de criptomonede / tokenuri / burse / perechi / piețe, dominance (cota BTC & ETH plus top3 bazat pe rang) și valoarea fear_greed a pieței. index: indicele Fear & Greed de la 0 la 100, așa cum îl afișează Bitculator – folosiți-l pentru afișare; score: valoarea compusă brută de −100…+100 din care este derivat index.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Cerere GET - fără corp al cererii.

Cerere

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

Hartă termică a pieței

Starter

Rândurile treemap ale top-100 plus statistici de context (capitalizare de piață/volum total, dominanță și scorul indicelui de frică și lăcomie al pieței) - copia API a hărții termice din web. În meta.fear_greed: index: indicele Fear & Greed de la 0 la 100, așa cum îl afișează Bitculator – folosiți-l pentru afișare; score: valoarea compusă brută de −100…+100 din care este derivat index.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Cerere GET - fără corp al cererii.

Cerere

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

Istoricul global al capitalizării de piață / volumului

Starter

Serii temporale pentru întreaga piață, pentru marketcap sau volume. Granularitatea urmează period: 24h = la jumătate de oră, 7d = la oră, 30d/all = zilnic (agregările mai fine sunt curățate).

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

metric
string obligatoriu
marketcap

Ce serie: marketcap sau volume.

Parametri de interogare

period
string opțional
7d

24h, 7d, 30d sau all (implicit 24h).

Cerere GET - fără corp al cererii.

Cerere

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

Sentiment

Indici de sentiment pentru piață și pentru fiecare monedă. Indicele de frică și lăcomie și Bull/Bear sunt INSTANTANEE reîmprospătate la 15 minute - există doar valoarea curentă, nu există serie temporală pentru ele. Altseason are istoric zilnic complet. indicators este bilanțul tehnic pentru întreaga piață.

Indicele de frică și lăcomie

Gratuit

Valoarea curentă a indicelui de frică și lăcomie (un instantaneu la 15 minute - fără istoric). Omiteți coin pentru indicele întregii piețe sau transmiteți un slug de monedă pentru o valoare per monedă. intervals conține subscorurile 7d/30d și defalcarea lor pe componente.

index: indicele Fear & Greed de la 0 la 100, așa cum îl afișează Bitculator – folosiți-l pentru afișare (0–19 frică extremă, 20–39 frică, 40–59 neutru, 60–79 lăcomie, 80–100 lăcomie extremă). score: valoarea compusă brută de −100…+100 din care este derivat index. Fiecare interval le conține pe amândouă.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

coin
string opțional
bitcoin

Slugul monedei, pentru o citire specifică unei monede; omiteți-l pentru indicele de piață.

Cerere GET - fără corp al cererii.

Cerere

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

Indicele Bull / Bear

Starter

Valoarea curentă Bull/Bear (un instantaneu la 15 minute - fără istoric). Omiteți coin pentru indicele întregii piețe sau transmiteți un slug de monedă pentru o valoare per monedă.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

coin
string opțional
bitcoin

Slugul monedei, pentru o citire specifică unei monede; omiteți-l pentru indicele de piață.

Cerere GET - fără corp al cererii.

Cerere

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

Indicele altseason

Starter

Valoarea curentă a indicelui altseason (numărul de monede care depășesc BTC din top 100), cu history zilnic opțional. Spre deosebire de indicele de frică și lăcomie, altseason are istoric zilnic complet - transmiteți days pentru a-l include.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

days
integer opțional
30

Numărul de zile de istoric zilnic care se includ (1–365; 0/omis = doar valorile curente).

Cerere GET - fără corp al cererii.

Cerere

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

Bilanțul indicatorilor de piață

Pro

Bilanțul tehnic pentru întreaga piață - 25 de categorii de indicatori agregate, fiecare cu starea curentă, scorul și datele de categorie.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Cerere GET - fără corp al cererii.

Cerere

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

Indicatori

Indicatori tehnici pentru fiecare monedă. Fiecare indicator are propriul endpoint dedicat - oscilatoare de impuls (RSI, Stoch-RSI, CCI, MFI, Williams %R), referințe de tendință și de preț (SMA, MACD, VWAP), flux de volum (OBV, CMF), forța tendinței (ADX) și volatilitate - plus un instantaneu unic cu mai mulți indicatori. Fiecare familie este o serie ZILNICĂ calculată din lumânări zilnice (păstrare completă; activele tinere returnează la început valori null de încălzire, până când există suficient istoric). Familiile la scara prețului (SMA, VWAP, MACD, OBV) emit șiruri zecimale; oscilatoarele mărginite emit numere. Câteva perioade cu fereastră lungă necesită un abonament plătit - se menționează la fiecare endpoint.

Instantaneu al indicatorilor

Pro

Instantaneul cu mai mulți indicatori - cel mai recent state (bullish/bearish/sheepish…), score și data brute pentru fiecare categorie de indicatori, într-un singur răspuns. Ideal pentru o privire rapidă într-un tablou de bord; folosiți mai jos endpointurile dedicate pentru fiecare indicator, pentru istoricul zilnic complet.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Slugul monedei.

Cerere GET - fără corp al cererii.

Cerere

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

RSI (Indicele de forță relativă)

Starter

Indicele zilnic de forță relativă - un oscilator de impuls mărginit între 0–100, care măsoară viteza și amplitudinea mișcărilor recente de preț. Peste 70 este considerat convențional supracumpărat, sub 30 supravândut. Ferestre: 7, 14, 21, 28 de zile (implicit 14) - ferestrele de 21 și 28 de zile necesită abonamentul Starter sau unul superior. Monedele noi returnează valori null la început, în perioada de încălzire.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Slugul monedei.

Parametri de interogare

period
integer opțional
14

Lungimea ferestrei - una dintre valorile 7, 14, 21, 28 (implicit 14).

start
string opțional
2026-06-01

Limita inferioară a datei ISO.

end
string opțional
2026-06-30

Limita superioară a datei ISO.

limit
integer opțional
30

Număr maxim de rânduri (1–1000, implicit 365).

Cerere GET - fără corp al cererii.

Cerere

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

RSI stocastic

Pro

RSI stocastic zilnic - aplică oscilatorul stocastic asupra RSI-ului însuși, oferind o citire a impulsului 0–100 mai rapidă și mai sensibilă, cu liniile %K și %D care se încrucișează pentru a semnala schimbările de direcție. Ferestre: 7, 14, 21, 28 de zile (implicit 14) - ferestrele de 21 și 28 de zile necesită abonamentul Starter sau unul superior.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Slugul monedei.

Parametri de interogare

period
integer opțional
14

Lungimea ferestrei - una dintre valorile 7, 14, 21, 28 (implicit 14).

start
string opțional
2026-06-01

Limita inferioară a datei ISO.

end
string opțional
2026-06-30

Limita superioară a datei ISO.

limit
integer opțional
30

Număr maxim de rânduri (1–1000, implicit 365).

Cerere GET - fără corp al cererii.

Cerere

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

SMA (Medie mobilă simplă)

Starter

Media mobilă simplă zilnică - media aritmetică a prețului de închidere pe fereastră, referința clasică de tendință pe care traderii o citesc pentru suport, rezistență și pentru golden cross/death cross. Ferestre: 50, 100, 200 de zile (implicit 50). Valorile sunt șiruri zecimale, pe scara prețului.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Slugul monedei.

Parametri de interogare

period
integer opțional
50

Lungimea ferestrei - una dintre valorile 50, 100, 200 (implicit 50).

start
string opțional
2026-06-01

Limita inferioară a datei ISO.

end
string opțional
2026-06-30

Limita superioară a datei ISO.

limit
integer opțional
30

Număr maxim de rânduri (1–1000, implicit 365).

Cerere GET - fără corp al cererii.

Cerere

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

CCI (Indicele canalului de mărfuri)

Starter

Indicele zilnic al canalului de mărfuri - măsoară cât de mult s-a abătut prețul de la media sa statistică; valorile dincolo de ±100 semnalează tendințe puternice sau posibile inversări. Ferestre: 20, 50, 100 de zile (implicit 20).

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Slugul monedei.

Parametri de interogare

period
integer opțional
20

Lungimea ferestrei - una dintre valorile 20, 50, 100 (implicit 20).

start
string opțional
2026-06-01

Limita inferioară a datei ISO.

end
string opțional
2026-06-30

Limita superioară a datei ISO.

limit
integer opțional
30

Număr maxim de rânduri (1–1000, implicit 365).

Cerere GET - fără corp al cererii.

Cerere

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

MFI (Indicele fluxului de bani)

Pro

Indicele zilnic al fluxului monetar - un RSI ponderat cu volumul (0–100) care include volumul tranzacționat în calculul impulsului, numit adesea "RSI de volum"; peste 80 supracumpărat, sub 20 supravândut. Ferestre: 7, 14, 28 de zile (implicit 14).

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Slugul monedei.

Parametri de interogare

period
integer opțional
14

Lungimea ferestrei - una dintre valorile 7, 14, 28 (implicit 14).

start
string opțional
2026-06-01

Limita inferioară a datei ISO.

end
string opțional
2026-06-30

Limita superioară a datei ISO.

limit
integer opțional
30

Număr maxim de rânduri (1–1000, implicit 365).

Cerere GET - fără corp al cererii.

Cerere

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

Williams %R

Pro

Williams %R zilnic - un oscilator de impuls mărginit între −100–0, care arată unde se situează închiderea în intervalul recent minim-maxim; peste −20 supracumpărat, sub −80 supravândut. Ferestre: 14, 20, 50 de zile (implicit 14).

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Slugul monedei.

Parametri de interogare

period
integer opțional
14

Lungimea ferestrei - una dintre valorile 14, 20, 50 (implicit 14).

start
string opțional
2026-06-01

Limita inferioară a datei ISO.

end
string opțional
2026-06-30

Limita superioară a datei ISO.

limit
integer opțional
30

Număr maxim de rânduri (1–1000, implicit 365).

Cerere GET - fără corp al cererii.

Cerere

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

Volatilitatea prețului

Pro

Indicele zilnic de volatilitate a prețului - dispersia randamentelor zilnice pe fereastră, o citire normalizată a cât de agitată a fost evoluția prețului. Ferestre: 7, 14, 30 de zile (implicit 7) - fereastra de 30 de zile necesită abonamentul Starter sau unul superior.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Slugul monedei.

Parametri de interogare

period
integer opțional
7

Lungimea ferestrei - una dintre valorile 7, 14, 30 (implicit 7).

start
string opțional
2026-06-01

Limita inferioară a datei ISO.

end
string opțional
2026-06-30

Limita superioară a datei ISO.

limit
integer opțional
30

Număr maxim de rânduri (1–1000, implicit 365).

Cerere GET - fără corp al cererii.

Cerere

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

Volatilitatea volumului

Starter

Indicele zilnic de volatilitate a volumului - dispersia volumului zilnic tranzacționat pe fereastră, o citire a cât de neregulată a fost participarea. Ferestre: 7, 14, 30 de zile (implicit 7) - fereastra de 30 de zile necesită abonamentul Starter sau unul superior.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Slugul monedei.

Parametri de interogare

period
integer opțional
7

Lungimea ferestrei - una dintre valorile 7, 14, 30 (implicit 7).

start
string opțional
2026-06-01

Limita inferioară a datei ISO.

end
string opțional
2026-06-30

Limita superioară a datei ISO.

limit
integer opțional
30

Număr maxim de rânduri (1–1000, implicit 365).

Cerere GET - fără corp al cererii.

Cerere

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

MACD

Pro

MACD zilnic (Moving Average Convergence Divergence) - diferența dintre EMA 12/26, cu o linie de semnal pe 9 perioade și o histogramă, un indicator clasic de tendință și de impuls, citit pentru încrucișările liniei de semnal și pentru trecerile peste linia zero. Returnează macd, signal și histogram ca șiruri zecimale. Fără parametru de fereastră.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Slugul monedei.

Parametri de interogare

start
string opțional
2026-06-01

Limita inferioară a datei ISO.

end
string opțional
2026-06-30

Limita superioară a datei ISO.

limit
integer opțional
30

Număr maxim de rânduri (1–1000, implicit 365).

Cerere GET - fără corp al cererii.

Cerere

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

OBV (Volum de echilibru)

Pro

Volumul zilnic On-Balance - o linie cumulativă de volum care adaugă volumul în zilele de creștere și îl scade în zilele de scădere, urmărind presiunea netă de cumpărare vs. vânzare și confirmând (sau contrazicând) tendințele de preț. O singură serie de șiruri zecimale.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Slugul monedei.

Parametri de interogare

start
string opțional
2026-06-01

Limita inferioară a datei ISO.

end
string opțional
2026-06-30

Limita superioară a datei ISO.

limit
integer opțional
30

Număr maxim de rânduri (1–1000, implicit 365).

Cerere GET - fără corp al cererii.

Cerere

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

ADX (Indicele direcțional mediu)

Starter

ADX zilnic cu +DI/−DI - măsoară forța tendinței (adx) și direcția (indicatorii direcționali plus_di/minus_di). Un ADX peste 25 semnalează o tendință puternică, indiferent de direcție; încrucișarea DI arată în ce sens. O singură serie, fără parametru de fereastră.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Slugul monedei.

Parametri de interogare

start
string opțional
2026-06-01

Limita inferioară a datei ISO.

end
string opțional
2026-06-30

Limita superioară a datei ISO.

limit
integer opțional
30

Număr maxim de rânduri (1–1000, implicit 365).

Cerere GET - fără corp al cererii.

Cerere

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

VWAP (Prețul mediu ponderat cu volumul)

Pro

VWAP zilnic - prețul mediu ponderat cu volumul, o referință fundamentală pentru valoarea justă și pentru execuție; un preț peste VWAP se citește ca optimist, iar sub ca pesimist. O singură serie de șiruri zecimale, fără parametru de fereastră.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Slugul monedei.

Parametri de interogare

start
string opțional
2026-06-01

Limita inferioară a datei ISO.

end
string opțional
2026-06-30

Limita superioară a datei ISO.

limit
integer opțional
30

Număr maxim de rânduri (1–1000, implicit 365).

Cerere GET - fără corp al cererii.

Cerere

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

CMF (Fluxul monetar Chaikin)

Starter

Fluxul monetar Chaikin zilnic - însumează volumul fluxului monetar pe perioadă, pentru a evalua acumularea vs. distribuția; valorile pozitive se citesc ca presiune netă de cumpărare, iar cele negative ca presiune de vânzare. Mărginit în jurul lui ±1. O singură serie, fără parametru de fereastră.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Slugul monedei.

Parametri de interogare

start
string opțional
2026-06-01

Limita inferioară a datei ISO.

end
string opțional
2026-06-30

Limita superioară a datei ISO.

limit
integer opțional
30

Număr maxim de rânduri (1–1000, implicit 365).

Cerere GET - fără corp al cererii.

Cerere

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

Conversie

Convertiți între oricare două active aflate în stare activă (cripto ȘI fiat) și listați monedele utilizabile drept componente ale conversiei. Valorile sunt șiruri zecimale. Cursurile valutare fiat se actualizează de ~două ori pe zi; cursurile cripto ~la fiecare minut.

Convertiți între active

Gratuit

Conversie pe server între oricare două active aflate în stare activă (cripto ȘI fiat). to acceptă o listă CSV pentru conversie către mai multe ținte; inversarea presupune doar schimbarea from/to. Conversia este liniară, deci value = unit_rate * amount. Cursurile valutare fiat se reîmprospătează ~de două ori pe zi; cursurile cripto ~la fiecare minut.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

from
string obligatoriu
bitcoin

Slugul activului sursă.

to
string obligatoriu
ethereum

Slugul (slugurile) activului țintă, separate prin virgulă (până la 10).

amount
number opțional
2.5

Cantitatea din activul sursă care se convertește (implicit 1).

Cerere GET - fără corp al cererii.

Cerere

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

Listează monedele fiat

Gratuit

Monedele fiat active, cu cursurile lor față de USD: rate_per_usd (unități per USD) și inversul său, usd_value. Cursurile valutare fiat se reîmprospătează ~de două ori pe zi.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Cerere GET - fără corp al cererii.

Cerere

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

Listează cursurile de conversie

Gratuit

Monedele de referință utilizabile ca etape de conversie - principalele monede fiat, monede și tokenuri - fiecare cu un usd_value normalizat (USD per unitate). Valorile monedelor/tokenurilor se reîmprospătează ~la fiecare minut; cursurile fiat, mai lente, sunt păstrate separat în cache (~de două ori pe zi).

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Cerere GET - fără corp al cererii.

Cerere

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

Calculatoare

Calculatoare financiare pe server care reproduc instrumentele web: DCA, profit/pierdere și împrumut (care citesc date de piață din cache), plus calcule fără stare pentru dobândă compusă și staking.

Calculator DCA

Gratuit

Backtest Dollar-cost averaging pe istoricul real de prețuri zilnice al monedei: o achiziție de amount la fiecare interval, între start și end. Transmiteți series=true pentru a include seria completă, pentru fiecare achiziție.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

slug
string obligatoriu
bitcoin

Identificatorul slug al monedei.

amount
number obligatoriu
100

USD cheltuiți per achiziție (0.01–1.000.000.000).

interval
string obligatoriu
weekly

Ritmul achizițiilor: daily, weekly, monthly, quarterly sau yearly.

start
string obligatoriu
2024-01-01

date Data primei achiziții (după 2008-12-31).

end
string opțional
2025-01-01

date Data ultimei achiziții (implicit, ziua de azi).

series
boolean opțional
false

Include în răspuns seria pentru fiecare achiziție.

Cerere GET - fără corp al cererii.

Cerere

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

Calculator de profit / pierdere

Gratuit

Cât a adus o cumpărare urmată de o vânzare între două date istorice, folosind prețurile reale ale monedei la acele date. Comisioanele sunt sume fixe în USD, nu procente.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

slug
string obligatoriu
bitcoin

Identificatorul slug al monedei.

amount
number obligatoriu
1000

USD investiți la buy_date (0.01–1.000.000.000).

buy_date
string obligatoriu
2023-01-01

date Data achiziției.

sell_date
string obligatoriu
2025-01-01

date Data vânzării (la sau după buy_date).

buy_fee
number opțional
10

Comision fix de achiziție, în USD (implicit 0).

sell_fee
number opțional
10

Comision fix de vânzare, în USD (implicit 0).

Cerere GET - fără corp al cererii.

Cerere

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

Calculator de dobândă compusă

Gratuit

Matematică pură - fără date de piață. rate este rata nominală anuală: fiecare perioadă de capitalizare aduce rate împărțită la numărul de perioade pe an (5% cu capitalizare lunară înseamnă 5/12% pe lună).

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

principal
number obligatoriu
10000

Sold inițial în USD.

rate
number obligatoriu
5

Rata anuală a dobânzii, în % (nominală, împărțită egal între perioadele de capitalizare).

duration
integer obligatoriu
5

Durata proiecției (anii sunt limitați la 50).

duration_unit
string opțional
years

years (implicit) sau months.

compound_frequency
string opțional
monthly

daily, weekly, monthly (implicit), quarterly sau annually.

contribution
number opțional
100

Depunere recurentă în USD (implicit 0).

contribution_frequency
string opțional
monthly

daily, weekly, monthly (implicit), quarterly sau annually.

Cerere GET - fără corp al cererii.

Cerere

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

Calculator împrumut vs vânzare

Gratuit

Împrumut garantat cu cripto vs vânzare - compară ambele scenarii folosind prețul CURENT al monedei. Proiecție informativă, nu sfat financiar.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

slug
string obligatoriu
bitcoin

Identificatorul slug al monedei.

crypto_amount
number obligatoriu
2

Ce cantitate dețineți din monedă.

needed_cash
number obligatoriu
50000

Suma în USD pe care trebuie să o eliberați.

term_months
integer opțional
36

Durata împrumutului în luni (implicit 36).

interest_rate
number opțional
10

APR-ul împrumutului în % (implicit 10).

ltv
number opțional
50

Raportul împrumut-valoare în % (implicit 50).

expected_growth
number opțional
25

Creșterea așteptată a prețului monedei pe durata perioadei, în % (implicit 25).

tax_rate
number opțional
25

Impozitul pe câștiguri de capital, în %, aplicat vânzării (implicit 25).

Cerere GET - fără corp al cererii.

Cerere

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

Calculator de recompense din staking

Gratuit

Matematică pură - recompense din staking, cu capitalizare opțională și un comision de validator. Nu se citesc date de piață.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

amount
number obligatoriu
1000

Suma pusă la staking, exprimată în unitățile activului respectiv.

period
number obligatoriu
2

Durata perioadei de staking (limitată la echivalentul a 50 de ani).

period_unit
string opțional
years

years (implicit), months sau days.

apy
number obligatoriu
5

APY-ul anunțat, în %.

compound_frequency
string opțional
monthly

never, daily, weekly, monthly (implicit) sau yearly.

commission
number opțional
10

Comisionul validatorului în %, luat din recompense (implicit 0).

Cerere GET - fără corp al cererii.

Cerere

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

Editorial

Articole editoriale - doar cele publicate (ACTIVE). locale alege limba conținutului, cu revenire la engleză pentru fiecare câmp (răspunsul indică ce locale a fost efectiv folosit). Articolele pot fi filtrate după etichetă sau după slugul unei monede, burse ori al unui portofel asociat. Citirile prin API NU incrementează, în mod deliberat, numărul de vizualizări.

Videoclipurile monedei

Gratuit

Videoclipuri selectate atașate unei monede (fila Videoclipuri de pe pagina monedei), paginate.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Identificatorul slug al monedei.

Parametri de interogare

page
integer opțional
1

Numărul paginii (numerotare de la 1).

per_page
integer opțional
10

Rânduri pe pagină (1–50, implicit 10).

type
string opțional
review

Filtrați după tipul videoclipului (de ex. overview, tutorial, explainer, review, analysis, news).

search
string opțional
halving

Potrivire în text liber pe titlu.

Cerere GET - fără corp al cererii.

Cerere

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

Cronologia analizelor unei monede

Gratuit

Cronologia analizelor pentru monedă - aceleași date folosite de panoul de analize din pagina activului, delimitate prin offset/limit.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
bitcoin

Identificatorul slug al monedei.

Parametri de interogare

locale
string opțional
en

Limba conținutului (revine la engleză).

offset
integer opțional
0

Rânduri omise (0–500, implicit 0).

limit
integer opțional
5

Rânduri returnate (1–50, implicit 5).

Cerere GET - fără corp al cererii.

Cerere

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

Listează articolele

Gratuit

Articolele publicate, cele mai noi primele, paginate. Filtrați după tag sau după slugul unei entități asociate coin / exchange / wallet, ori după text liber cu search. Fiecare rând este un sumar (titlu, subtitlu, etichete, timp de citire, imagine principală, entități asociate, date).

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

page
integer opțional
1

Numărul paginii (numerotare de la 1).

per_page
integer opțional
20

Rânduri pe pagină (1–50, implicit 20).

locale
string opțional
en

Limba conținutului (revine la engleză).

tag
string opțional
guide

Filtrați după etichetă: news, guide, tutorial, explainer, analysis, review, trading, overview sau information.

coin
string opțional
bitcoin

Limitați la articolele asociate acestui slug de monedă.

exchange
string opțional
binance-exchange

Limitați la articolele asociate acestui slug de bursă.

wallet
string opțional
frostsnap

Limitați la articolele asociate acestui slug de portofel.

search
string opțional
halving

Potrivire în text liber pe titlu/subtitlu.

Cerere GET - fără corp al cererii.

Cerere

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

Obțineți un articol

Gratuit

Un articol publicat, cu tot conținutul, etichetele, imaginea principală, contoarele de utilitate și entitățile asociate. locale alege limba conținutului, cu rezervă în engleză per câmp (răspunsul indică ce limbă a fost folosită efectiv).

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
what-is-bitcoin

Slugul articolului.

Parametri de interogare

locale
string opțional
en

Limba conținutului (revine la engleză).

Cerere GET - fără corp al cererii.

Cerere

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

Trimite feedback pentru articol

Gratuit

Înregistrează un vot pozitiv/negativ pentru un articol - aceleași contoare folosite de butoanele de utilitate din web. Limitarea per cheie se aplică în amonte.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

slug
string obligatoriu
what-is-bitcoin

Slugul articolului.

Parametri din corpul cererii

helpful
boolean obligatoriu
true

true pentru util, false pentru neutil.

Cerere

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

Obțineți un videoclip

Gratuit

Un videoclip selectat, cu ID-ul YouTube, titlul, tipul, durata și monedele/bursele/portofelele la care este atașat.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

id
integer obligatoriu
87

ID-ul videoclipului.

Cerere GET - fără corp al cererii.

Cerere

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

Listează analizele

Gratuit

Analize de piață generate de AI, paginate. Filtrați după type, după slugul coin al unei monede asociate sau după text liber search; locale alege limba titlului/rezumatului, cu revenire la engleză.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

page
integer opțional
1

Numărul paginii (numerotare de la 1).

per_page
integer opțional
20

Rânduri pe pagină (1–50, implicit 20).

locale
string opțional
en

Limba conținutului (revine la engleză).

type
string opțional
per_asset

Filtrați după tipul analizei: per_asset, market_overview sau narrative.

coin
string opțional
bitcoin

Limitați la analizele despre acest slug de monedă.

search
string opțional
etf

Potrivire în text liber pe titlu.

sort
string opțional
first_reported

Ordinea de sortare: first_reported (implicit) sau last_updated.

Cerere GET - fără corp al cererii.

Cerere

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

Obțineți o analiză

Gratuit

O analiză cu setul complet de date - titlu, sumar, cronologia articolelor-sursă și monedele asociate.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

id
integer obligatoriu
101

ID-ul analizei.

Parametri de interogare

locale
string opțional
en

Limba conținutului (revine la engleză).

Cerere GET - fără corp al cererii.

Cerere

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

Alarme

CRUD pentru alarme de preț - aceleași alarme pe care le gestionează aplicația web. Alarmele consumă soldul de inventar de alarme al proprietarului cheii, sunt de tip TARGET doar pe monede, iar o verificare above/below față de valoarea curentă blochează alarmele care s-ar declanșa instantaneu. Delimitate de cheie (cheia API stabilește proprietarul) și niciodată păstrate în cache-ul de răspunsuri.

Listează alarmele

Gratuit

Alarmele proprietarului cheii, cele mai noi primele, paginate. Filtrați după status, direction sau după canalul notification.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de interogare

page
integer opțional
1

Numărul paginii (numerotare de la 1).

per_page
integer opțional
25

Rânduri pe pagină (1–100, implicit 25).

status
string opțional
active

Filtrați după stare: active sau triggered.

direction
string opțional
above

Filtrați după direcția de declanșare: above sau below.

notification
string opțional
email

Filtrați după canalul de livrare: email, push sau webhook.

Cerere GET - fără corp al cererii.

Cerere

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

Creați o alarmă

Gratuit

Creează o alarmă de tip TARGET pentru o monedă și consumă un slot de alarmă din soldul deținătorului cheii. Ținta este verificată față de valoarea curentă a monedei, astfel încât alarma să nu se poată declanșa singură instantaneu: o alarmă above trebuie să vizeze mai mult decât valoarea curentă, iar una below mai puțin. O monedă fără valoare curentă pentru metrica aleasă (de ex. fără capitalizare de piață, pentru că nu are ofertă circulantă) este respinsă cu 422.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri din corpul cererii

name
string obligatoriu
BTC six figures

O etichetă pentru alarmă (max. 255 de caractere).

coin
string obligatoriu
bitcoin

Identificatorul slug al monedei.

metric
string obligatoriu
rate

Metrica urmărită: rate, volume sau marketcap.

direction
string obligatoriu
above

Direcția de declanșare: above sau below.

target
number obligatoriu
100000

Valoarea de prag (trebuie să se afle pe partea direction față de valoarea curentă a monedei).

notification
string obligatoriu
email

Canal de livrare: email, push sau webhook.

Cerere

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

Ștergeți o alarmă

Gratuit

Șterge una dintre alarmele deținătorului cheii și restituie slotul de alarmă consumat.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

id
integer obligatoriu
42

ID-ul alarmei.

Cerere

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

Webhookuri

Bitculator trimite fiecare eveniment prin POST, în format JSON, cu un antet de semnătură HMAC:

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

Verificați-o recalculând HMAC-ul peste "." cu secretul endpointului dumneavoastră și comparând în timp constant; respingeți dacă t este mai vechi de câteva minute (protecție împotriva reluării). Exemplu (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);

Evenimente acceptate: alarm.triggered. Livrările se reiau de 3× cu întârziere progresivă; un endpoint se dezactivează automat după 10 livrări eșuate consecutive.

Listează endpointurile webhook

Gratuit

Endpointurile webhook ale proprietarului cheii, cele mai noi primele. Cheile secrete de semnare nu sunt incluse niciodată - fiecare cheie secretă este afișată exact o dată, la creare.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Cerere GET - fără corp al cererii.

Cerere

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

Creați un endpoint de webhook

Gratuit

Înregistrează un endpoint HTTPS (maximum 5 pe cont) pentru livrarea evenimentelor. Răspunsul include cheia de semnare secret - singura dată când este afișată, așa că stocați-o imediat.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri din corpul cererii

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

URL-ul HTTPS de livrare. Doar gazde publice - adresele interne/private sunt respinse.

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

Evenimentele la care se face abonarea. Valori permise: alarm.triggered.

Cerere

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

Ștergeți un endpoint de webhook

Gratuit

Șterge unul dintre endpointurile de webhook ale deținătorului cheii. Livrările în așteptare către acesta sunt abandonate.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

id
integer obligatoriu
7

ID-ul endpointului webhook.

Cerere

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

Trimite un eveniment de test

Gratuit

Trimite un eveniment de test alarm.triggered semnat (test: true în conținut, cu antete de semnătură reale), astfel încât receptorii să poată fi verificați de la un capăt la altul.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

id
integer obligatoriu
7

ID-ul endpointului webhook.

Cerere

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

Jurnalul livrărilor webhook

Gratuit

Încercările de livrare ale endpointului (păstrate 30 de zile), cele mai noi primele, paginate.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Parametri de cale

id
integer obligatoriu
7

ID-ul endpointului webhook.

Parametri de interogare

page
integer opțional
1

Numărul paginii (numerotare de la 1).

per_page
integer opțional
25

Rânduri pe pagină (1–100, implicit 25).

Cerere GET - fără corp al cererii.

Cerere

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

Meta

Metadate și introspecție pentru API: un ping autentificat pentru verificarea unei chei și a lanțului de middleware, utilizarea/cota cheii curente și specificația OpenAPI citibilă de mașină.

Specificație OpenAPI

Gratuit

Documentul OpenAPI 3 citibil de mașini pentru acest API, în format JSON - îndreptați generatoarele de cod sau uneltele API către acest URL. Public: nu este necesară o cheie.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Cerere GET - fără corp al cererii.

Cerere

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

Ping

Gratuit

O operațiune fără efect, autentificată, pentru verificarea de la un capăt la altul a unei chei a API-ului de date (auth.api → limitare de rafală în funcție de abonament → cota lunară). Se contorizează în cotă la fel ca orice alt apel.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Cerere GET - fără corp al cererii.

Cerere

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

Utilizarea cheii și cota

Gratuit

Introspecția utilizării pentru proprietarul cheii apelante, pe produsul de care aparține cheia: abonamentul, limita lunară, consumul și restul (întotdeauna corelate cu antetele X-Quota-*), fereastra perioadei curente și defalcări per endpoint / per token. Apelat prin MCP, raportează abonamentul și pool-ul MCP. Utilizarea widget-urilor de încorporare are propriul abonament și propriul pool - nu apare niciodată aici.

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

Cheile sunt doar de tip Bearer și au permisiunea data-api - păstrați-le pe server.

Cerere GET - fără corp al cererii.

Cerere

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