Date de piață
Instrument
search_coins
Identifică o monedă sau un token după nume ori simbol în text liber și returnează slugul canonic, cu un sumar de piață clasat pentru fiecare potrivire. Punctul de intrare: orice alt instrument pentru monede este adresat prin slug.
| Parametru |
Tip |
Descriere |
query
obligatoriu
|
string |
Căutare în text liber, comparată cu numele și simbolurile monedelor. |
type
|
enum |
Restrânge potrivirile: coin sau token. |
limit
|
integer |
Numărul maxim de potriviri returnate (1–50, implicit 10). |
Instrument
get_coin
Profil complet pentru o monedă: ofertele, rangul și variațiile de rang, maximul/minimul istoric și distanța până la ele, evaluarea complet diluată, linkuri, contracte și descriere.
| Parametru |
Tip |
Descriere |
slug
obligatoriu
|
string |
Slug canonic de monedă, de ex. bitcoin. |
Instrument
get_prices
Prețurile spot actuale pentru până la 100 de monede într-un singur apel, opțional convertite într-o monedă fiat. Cea mai ieftină cale de a răspunde la întrebări despre preț - este obligatoriu exact un selector.
| Parametru |
Tip |
Descriere |
slugs
|
string |
Sluguri de monede separate prin virgulă - selectorul preferat. |
symbols
|
string |
Simboluri de ticker separate prin virgulă; simbolurile ambigue se rezolvă către potrivirea cu cel mai bun rang. |
ids
|
string |
ID-uri numerice Bitculator de monede, separate prin virgulă. |
convert
|
string |
Simbolul monedei fiat în care se convertesc prețurile, de ex. EUR. Implicit USD. |
Instrument
get_top_movers
Cele mai mari creșteri sau scăderi după variația procentuală din ultimele 24 de ore sau 7 zile.
| Parametru |
Tip |
Descriere |
direction
obligatoriu
|
enum |
gainers sau losers. |
interval
|
enum |
Intervalul de variație după care se face clasarea: 24h sau 7d (implicit 24h). |
limit
|
integer |
Numărul maxim de monede returnate (1–50, implicit 10). |
Instrument
get_trending_coins
Monedele care atrag acum cea mai multă atenție pe Bitculator, sub formă de rânduri de piață compacte.
| Parametru |
Tip |
Descriere |
limit
|
integer |
Numărul maxim de monede returnate (1–20, implicit 10). |
Istoric
Instrument
get_price_history
Lumânări OHLCV pentru o monedă pe un interval de date. Retenție: minutely ~8 zile, half-hourly ~3 luni, hourly ~6 luni, daily = istoric complet. Returnează cele mai recente lumânări din interval, începând cu cele mai vechi.
| Parametru |
Tip |
Descriere |
slug
obligatoriu
|
string |
Slug canonic de monedă. |
interval
|
enum |
Intervalul lumânărilor: minutely, half-hourly, hourly sau daily (implicit daily). |
start
|
date |
Începutul intervalului, în format YYYY-MM-DD; implicit, o perioadă recentă potrivită pentru intervalul ales. |
end
|
date |
Sfârșitul intervalului, în format YYYY-MM-DD; implicit, momentul actual. |
limit
|
integer |
Numărul maxim de lumânări returnate (1–500, implicit 90). |
Instrument
get_historical_price
Prețul unei monede la o anumită dată din trecut, cu o rezervă de până la 3 zile atunci când ziua exactă nu are date.
| Parametru |
Tip |
Descriere |
slug
obligatoriu
|
string |
Slug canonic de monedă. |
date
obligatoriu
|
date |
Data în format YYYY-MM-DD (2009-01-01 sau ulterioară, nu în viitor). |
Instrument
get_global_history
Serie temporală a capitalizării totale de piață cripto sau a volumului total. Granularitatea urmează perioada: 24h este la jumătate de oră, 7d la oră, iar 30d și all zilnic.
| Parametru |
Tip |
Descriere |
metric
obligatoriu
|
enum |
Seria care se returnează: marketcap sau volume. |
period
|
enum |
Perioada: 24h, 7d, 30d sau all (implicit 24h). |
Sentiment și date globale
Instrument
get_global_market
Instantaneu al întregii piețe: capitalizare totală de piață, volum total pe 24h, dominanța BTC/ETH și numărul de monede/tokenuri/burse/perechi. Include și citirea Fear & Greed a pieței – citați index (0–100), nu valoarea brută score.
Acest instrument nu primește parametri.
Instrument
get_fear_greed
Indicele de sentiment frică și lăcomie pentru întreaga piață sau pentru o singură monedă atunci când se transmite un slug, inclusiv subscorurile pe intervalele 7d/30d. Citați index (0–100, așa cum apare pe Bitculator), nu valoarea brută score (−100…+100).
| Parametru |
Tip |
Descriere |
coin
|
string |
Slug opțional de monedă pentru o citire per monedă; omiteți-l pentru indicele la nivelul întregii piețe. |
Instrument
get_altseason_index
Indicele Altseason - dacă altcoinurile depășesc Bitcoin în performanță - cu istoric zilnic opțional.
| Parametru |
Tip |
Descriere |
days
|
integer |
Numărul de zile de istoric zilnic incluse (0–365; 0 returnează doar citirea actuală). |
Instrument
get_liquidations_summary
Totalurile lichidărilor de futures de astăzi, cu împărțirea long/short și dominanța. Datele pot fi null imediat după schimbarea zilei.
Acest instrument nu primește parametri.
Burse
Instrument
list_exchanges
Burse clasate, cu volum pe 24h, dominanța volumului și numărul de perechi/active. Convertește de asemenea numele burselor în sluguri.
| Parametru |
Tip |
Descriere |
type
|
enum |
Restrânge la burse centralizate (cex) sau descentralizate (dex). |
search
|
string |
Căutare în text liber, comparată cu numele burselor. |
sort
|
string |
Câmpuri de sortare separate prin virgulă, prefixul "-" pentru ordine descrescătoare: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets. |
limit
|
integer |
Numărul maxim de burse returnate (1–50, implicit 10). |
Instrument
get_exchange
Profil complet pentru o bursă: rang, volum și variații, dominanță, perechi și active listate, plus linkuri.
| Parametru |
Tip |
Descriere |
slug
obligatoriu
|
string |
Slug canonic de bursă, de ex. binance-exchange. |
Instrument
get_exchange_trust_score
Scorul de încredere al unei burse (0–10), cu defalcarea completă pe 13 factori. O bursă neclasată (fără volum spot activ încă) returnează un scor și o defalcare null: nu a fost evaluată, ceea ce nu este același lucru cu un scor mic.
| Parametru |
Tip |
Descriere |
slug
obligatoriu
|
string |
Slug canonic de bursă. |
Instrument
get_coin_markets
Unde se tranzacționează o monedă: piețele sale de pe burse, cu perechea, prețul și volumul pe 24h, sortate după volum.
| Parametru |
Tip |
Descriere |
slug
obligatoriu
|
string |
Slug canonic de monedă. |
exchange
|
string |
Slug opțional de bursă, pentru a restrânge rezultatele la o singură platformă. |
instrument
|
enum |
Restrânge la un singur tip de instrument: spot, future, option, swap sau margin. |
limit
|
integer |
Numărul maxim de piețe returnate (1–50, implicit 10). |
Analiză și utilitare
Instrument
get_coin_technicals
Instantaneul tehnic cu mai mulți indicatori pentru o monedă, într-un singur apel: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, volatilitate și altele, fiecare cu starea și scorul cele mai recente.
| Parametru |
Tip |
Descriere |
slug
obligatoriu
|
string |
Slug canonic de monedă. |
Instrument
convert_currency
Convertește o sumă între orice monede cripto și/sau fiat (până la 10 ținte pe apel), folosind cursuri în timp real, cu precizie zecimală completă.
| Parametru |
Tip |
Descriere |
from
obligatoriu
|
string |
Slugul monedei sursă, de ex. bitcoin sau united-states-dollar. |
to
obligatoriu
|
string |
Sluguri de monede țintă separate prin virgulă, până la 10. |
amount
|
number |
Suma din moneda sursă care se convertește (implicit 1). |
Instrument
calculate_dca
Rulează un backtest al unei strategii de dollar-cost averaging pe istoricul real al prețurilor: total investit, monede acumulate, valoare actuală și profit/pierdere.
| Parametru |
Tip |
Descriere |
slug
obligatoriu
|
string |
Slug canonic de monedă. |
amount
obligatoriu
|
number |
Suma în USD cumpărată la fiecare interval. |
interval
obligatoriu
|
enum |
Cadența achizițiilor: daily, weekly, monthly, quarterly sau yearly. |
start
obligatoriu
|
date |
Data primei achiziții, în format YYYY-MM-DD (anterioară zilei de azi). |
end
|
date |
Data ultimei achiziții, în format YYYY-MM-DD; implicit, ziua de azi. |
series
|
boolean |
Include seria pentru fiecare achiziție (rezultat mare - păstrați false dacă nu vi se cere altfel). |