Tržní data
Kniha pokynů, veřejné obchody a svíčky burzy. Referenční data pro grafy a analýzu, ne ceny, za které obchodujete.
Referenční data burzy, ne cena, za kterou obchodujete.
Co budete potřebovat.
market. Požadavky se nepodepisují, stačí hlavička X-COINERO-APIKEY. Odpovědi mají stejné konvence jako ostatní endpointy: ceny a množství jsou desetinné řetězce a čas je v ISO 8601 i v milisekundách.Kniha pokynů
GET /v1/depth vrací nákupní úrovně (bids, od nejvyšší ceny) a prodejní úrovně (asks, od nejnižší ceny) jako pole dvojic [cena, množství]. Pole timestamp a timestampMs říkají, kdy byl snímek knihy pořízen.
symbolje povinný, napříkladBTCEUR.limitje počet úrovní na stranu, od 1 do 100, výchozí 25.- Coinero drží 25 úrovní na stranu, takže vyšší
limitvrátí nejvýš tolik, kolik snímek obsahuje. - Snímek platí 30 s. Když chybí, endpoint vrací 503
MARKET_DATA_UNAVAILABLEs hlavičkouRetry-After.
Veřejné obchody
GET /v1/trades vrací poslední obchody na burze od nejstaršího po nejnovější. Položka nese tradeId, price, quantity, side (strana agresora, buy nebo sell) a čas time a timeMs. Typ pokynu se nevydává.
symbolje povinný.limitje od 1 do 500, výchozí 100. Coinero drží posledních 100 obchodů, takže odpověď jich obsahuje nejvýš 100.- Prázdné pole
tradesje platná odpověď 200: na nelikvidním trhu se dlouho neobchodovalo.
Svíčky
GET /v1/ohlc vrací svíčky od nejstarší po nejnovější s poli open, high, low, close, volume (v základní měně trhu) a časy openTime a closeTime.
| Parametr | Hodnoty |
|---|---|
symbol | povinný |
interval | povinný: 1m, 5m, 15m, 30m, 1h, 4h, 1d nebo 1w; záleží na velikosti písmen |
limit | od 1 do 1000, výchozí 100 |
Prázdné pole svíček je platná odpověď 200. Chybějící nebo vadné parametry vrací 400 INVALID_PARAMETER se všemi vadnými parametry najednou, neznámý symbol 404 UNKNOWN_SYMBOL.
Trhy v CZK
Trhy kotované v CZK, například BTCCZK, nemají na burze vlastní knihu, obchody ani svíčky: Coinero je provádí přes trh v EUR. API proto data odvozuje stejně jako graf v aplikaci:
- Ceny ze zdrojového trhu (typicky
BTCEUR) se vynásobí středním kurzem EUR/CZK bez přirážky. Množství zůstávají beze změny. derivedFromuvádí symbol zdrojového trhu,conversionRatepoužitý kurz bez zaokrouhlení (počet CZK na 1 EUR) aconversionRateTimesconversionRateTimeMsokamžik, kdy byl kurz načten. U trhů s vlastními daty jsou všechna tato pole v odpovědi vždy a mají hodnotunull.- Ceny odvozeného trhu mají nejméně šest platných číslic a jednotný počet desetinných míst v celé odpovědi.
- Všechny svíčky, i staré, se přepočítají aktuálním kurzem. Graf v aplikaci dělá totéž.
- Odpověď má jeden kurz, ten z polí
conversionRateaconversionRateTime, a platí pro všechny její ceny.
Odvozená kniha se mění i tehdy, když se kniha v EUR nezměnila.
book pošle po změně kurzu nový snapshot, i když se kniha v EUR nehýbala.Limitní pokyn v CZK. Zadáváte-li limitní pokyn na trhu v CZK, cena je v CZK, ale pokyn se provede na trhu v EUR. Coinero zadanou cenu při zadání přepočte klientským kurzem, který na rozdíl od kurzu v knize obsahuje měnovou přirážku, a zaokrouhlí ji na cenový krok trhu v EUR. Použitý kurz zůstane pro pokyn pevný a najdete ho v poli conversion (viz Obchodování). Cena v odvozené knize v CZK proto není přesně cena, při které se váš limitní pokyn naplní.
Trh bez knihy
Trh, pro který nejde data ani odvodit, vrací 404 MARKET_HAS_NO_DEPTH. Jeden kód platí pro knihu, obchody i svíčky. Nastane ve dvou případech:
- Trh obchodovaný přes most, kde kotovaná měna nebo měna mostu není fiat, takže pro přepočet neexistuje fiat kurz.
- Trh kotovaný opačně než na burze, například
USDCBTCnad burzovním páremBTC/USDC. Převrácení ceny by změnilo i množství, proto se neodvozuje.
Opakování nepomůže, zvolte jiný pár. Cenu pro klienta takového trhu vrací GET /v1/ticker a odhad pokynu z POST /v1/orders/validate. Chybějící kurz EUR/CZK je naopak dočasný stav: 503 MARKET_DATA_UNAVAILABLE.
Chyby
| Stav | Kód | Kdy |
|---|---|---|
| 400 | INVALID_PARAMETER | Chybí nebo je vadný symbol, limit či interval. |
| 404 | UNKNOWN_SYMBOL | Coinero tento pár neobchoduje. |
| 404 | MARKET_HAS_NO_DEPTH | Data trhu nejde vydat ani odvodit. |
| 404 | NOT_FOUND | Coinero referenční data provozně vypnulo. |
| 503 | MARKET_DATA_UNAVAILABLE | Chybí snímek knihy, kurz nebo katalog trhů. Počkejte podle Retry-After. |
Změny knihy a obchodů nesledujte opakovaným dotazováním. Odebírejte kanály book a trades WebSocketu; zapínají se spolu s těmito endpointy.