Piaci adatok
Eszköz
search_coins
Érme vagy token feloldása szabad szöveges név vagy szimbólum alapján a kanonikus slugjára, találatonként rangsorolt piaci összefoglalóval. Ez a belépési pont: az összes többi érme-eszközt slug alapján kell megcímezni.
| Paraméter |
Típus |
Leírás |
query
kötelező
|
string |
Szabad szöveges keresés érmenevekre és szimbólumokra. |
type
|
enum |
Találatok szűkítése: coin vagy token. |
limit
|
integer |
Visszaadott találatok maximuma (1–50, alapértelmezés 10). |
Eszköz
get_coin
Egy érme teljes profilja: kínálati adatok, helyezés és helyezésváltozások, történelmi csúcs/mélypont és a tőlük mért távolság, teljesen felhígított értékelés, linkek, szerződések és leírás.
| Paraméter |
Típus |
Leírás |
slug
kötelező
|
string |
Kanonikus érme-slug, pl. bitcoin. |
Eszköz
get_prices
Akár 100 érme aktuális spotára egyetlen hívásban, igény szerint fiatvalutára átszámítva. A legköltséghatékonyabb módja az árkérdések megválaszolásának – pontosan egy szelektor kötelező.
| Paraméter |
Típus |
Leírás |
slugs
|
string |
Vesszővel elválasztott érme-slugok – ez az előnyben részesített szelektor. |
symbols
|
string |
Vesszővel elválasztott ticker szimbólumok; a többértelmű szimbólumok a legjobb helyezésű találatra oldódnak fel. |
ids
|
string |
Vesszővel elválasztott numerikus Bitculator érme-azonosítók. |
convert
|
string |
A fiatvaluta szimbóluma, amelyre az árak átszámítódnak, pl. EUR. Alapértelmezés: USD. |
Eszköz
get_top_movers
A legnagyobb nyertesek vagy vesztesek százalékos változás alapján az elmúlt 24 órában vagy 7 napban.
| Paraméter |
Típus |
Leírás |
direction
kötelező
|
enum |
gainers vagy losers. |
interval
|
enum |
A rangsorolás alapjául szolgáló változási ablak: 24h vagy 7d (alapértelmezés 24h). |
limit
|
integer |
Visszaadott érmék maximuma (1–50, alapértelmezés 10). |
Eszköz
get_trending_coins
A Bitculatoron éppen a legnagyobb figyelmet kapó érmék, tömör piaci sorokként.
| Paraméter |
Típus |
Leírás |
limit
|
integer |
Visszaadott érmék maximuma (1–20, alapértelmezés 10). |
Előzmények
Eszköz
get_price_history
Egy érme OHLCV-gyertyái adott dátumtartományban. Megőrzés: perces ~8 nap, félórás ~3 hónap, órás ~6 hónap, napi = teljes előzmény. Az ablakban lévő legfrissebb gyertyákat adja vissza, a legrégebbivel kezdve.
| Paraméter |
Típus |
Leírás |
slug
kötelező
|
string |
Kanonikus érme-slug. |
interval
|
enum |
Gyertyaintervallum: minutely, half-hourly, hourly vagy daily (alapértelmezés daily). |
start
|
date |
Az ablak kezdete YYYY-MM-DD formában; alapértelmezés szerint az intervallumhoz illő friss ablak. |
end
|
date |
Az ablak vége YYYY-MM-DD formában; alapértelmezés szerint a jelenlegi idő. |
limit
|
integer |
Visszaadott gyertyák maximuma (1–500, alapértelmezés 90). |
Eszköz
get_historical_price
Egy érme árfolyama egy adott korábbi dátumon; ha az adott napra nincs adat, legfeljebb 3 napot lép vissza.
| Paraméter |
Típus |
Leírás |
slug
kötelező
|
string |
Kanonikus érme-slug. |
date
kötelező
|
date |
A dátum YYYY-MM-DD formában (2009-01-01 vagy későbbi, nem lehet a jövőben). |
Eszköz
get_global_history
A teljes kriptopiaci kapitalizáció vagy a teljes forgalom időbeli sora. A felbontás a periódushoz igazodik: 24h félórás, 7d órás, 30d és all napi.
| Paraméter |
Típus |
Leírás |
metric
kötelező
|
enum |
Melyik sort adja vissza: marketcap vagy volume. |
period
|
enum |
Ablak: 24h, 7d, 30d vagy all (alapértelmezés 24h). |
Hangulat és globális adatok
Eszköz
get_global_market
Teljes piaci pillanatkép: összes piaci kapitalizáció, 24 órás összforgalom, BTC/ETH-dominancia, valamint érme-, token-, tőzsde- és párszámok. A piaci Fear & Greed értéket is tartalmazza – az index értéket (0–100) idézze, ne a nyers score értéket.
Ez az eszköz nem vesz át paramétert.
Eszköz
get_fear_greed
A félelem és kapzsiság hangulatindex a teljes piacra, vagy egy érmére, ha slugot adsz meg, a 7d/30d intervallumok részpontszámaival együtt. Az index értéket (0–100, ahogy a Bitculator mutatja) idézze, ne a nyers score értéket (−100…+100).
| Paraméter |
Típus |
Leírás |
coin
|
string |
Opcionális érme-slug az érménkénti értékhez; hagyd el a piac egészére vonatkozó indexhez. |
Eszköz
get_altseason_index
Az altszezon-index – azt mutatja, hogy az altcoinok felülteljesítik-e a Bitcoint –, opcionális napi előzménnyel.
| Paraméter |
Típus |
Leírás |
days
|
integer |
A napi előzményből bevont napok száma (0–365; a 0 csak az aktuális értéket adja vissza). |
Eszköz
get_liquidations_summary
A mai határidős likvidálások összesítése a long/short megosztással és a dominanciával. Közvetlenül a napi váltás után az adat null lehet.
Ez az eszköz nem vesz át paramétert.
Tőzsdék
Eszköz
list_exchanges
Rangsorolt tőzsdék 24 órás forgalommal, forgalmi dominanciával, valamint pár- és eszközszámokkal. Tőzsdenevek slugra való feloldására is használható.
| Paraméter |
Típus |
Leírás |
type
|
enum |
Szűkítés centralizált (cex) vagy decentralizált (dex) tőzsdékre. |
search
|
string |
Szabad szöveges keresés tőzsdenevekre. |
sort
|
string |
Vesszővel elválasztott rendezési mezők, csökkenő sorrendhez „-” előtaggal: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets. |
limit
|
integer |
Visszaadott tőzsdék maximuma (1–50, alapértelmezés 10). |
Eszköz
get_exchange
Egy tőzsde teljes profilja: helyezés, forgalom és változások, dominancia, listázott párok és eszközök, valamint linkek.
| Paraméter |
Típus |
Leírás |
slug
kötelező
|
string |
Kanonikus tőzsde-slug, pl. binance-exchange. |
Eszköz
get_exchange_trust_score
Egy tőzsde bizalmi pontszáma (0–10) a teljes, 13 tényezős lebontással. A rangsorban nem szereplő tőzsde (még nincs aktív spotforgalma) null pontszámot és lebontást ad vissza: nincs pontozva, ami nem ugyanaz, mint az alacsony pontszám.
| Paraméter |
Típus |
Leírás |
slug
kötelező
|
string |
Kanonikus tőzsde-slug. |
Eszköz
get_coin_markets
Hol kereskednek egy érmével: a piacai a különböző tőzsdéken párral, árral és 24 órás forgalommal, forgalom szerint rendezve.
| Paraméter |
Típus |
Leírás |
slug
kötelező
|
string |
Kanonikus érme-slug. |
exchange
|
string |
Opcionális tőzsde-slug az eredmények egyetlen helyszínre szűkítéséhez. |
instrument
|
enum |
Szűkítés egy instrumentumtípusra: spot, future, option, swap vagy margin. |
limit
|
integer |
Visszaadott piacok maximuma (1–50, alapértelmezés 10). |
Elemzés és segédeszközök
Eszköz
get_coin_technicals
Egy érme többindikátoros technikai pillanatképe egyetlen hívásban: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, volatilitás és több más, mindegyik a legfrissebb állapotával és pontszámával.
| Paraméter |
Típus |
Leírás |
slug
kötelező
|
string |
Kanonikus érme-slug. |
Eszköz
convert_currency
Összeg átszámítása bármely kripto- és/vagy fiatvaluta között (hívásonként legfeljebb 10 célvaluta) élő árfolyamokkal, teljes decimális pontossággal.
| Paraméter |
Típus |
Leírás |
from
kötelező
|
string |
A forrásvaluta slugja, pl. bitcoin vagy united-states-dollar. |
to
kötelező
|
string |
Vesszővel elválasztott célvaluta-slugok, legfeljebb 10. |
amount
|
number |
Az átszámítandó forrásvaluta összege (alapértelmezés 1). |
Eszköz
calculate_dca
Dollárköltség-átlagolási stratégia visszatesztelése valós árfolyam-előzményeken: összes befektetett összeg, felhalmozott érmék, jelenlegi érték és nyereség/veszteség.
| Paraméter |
Típus |
Leírás |
slug
kötelező
|
string |
Kanonikus érme-slug. |
amount
kötelező
|
number |
Az egyes intervallumokban vásárolt USD-összeg. |
interval
kötelező
|
enum |
Vásárlási ütem: daily, weekly, monthly, quarterly vagy yearly. |
start
kötelező
|
date |
Az első vásárlás dátuma YYYY-MM-DD formában (a mai nap előtt). |
end
|
date |
Az utolsó vásárlás dátuma YYYY-MM-DD formában; alapértelmezés szerint a mai nap. |
series
|
boolean |
A vásárlásonkénti sor is szerepeljen (nagy kimenet – hagyd false értéken, ha nem kérik). |