Získat API klíč
Obchodní API

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.

Kniha, obchody a svíčky jsou tytéž údaje, jaké ukazuje graf v aplikaci Coinero (Trading Pro). Neobsahují poplatek Coinera ani měnovou přirážku, takže se od ceny vašeho pokynu liší. Cenu, za kterou skutečně nakoupíte nebo prodáte, vrací GET /v1/ticker a odhad pokynu z POST /v1/orders/validate.

Co budete potřebovat.

API klíč s oprávněním 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.

  • symbol je povinný, například BTCEUR.
  • limit je počet úrovní na stranu, od 1 do 100, výchozí 25.
  • Coinero drží 25 úrovní na stranu, takže vyšší limit vrátí nejvýš tolik, kolik snímek obsahuje.
  • Snímek platí 30 s. Když chybí, endpoint vrací 503 MARKET_DATA_UNAVAILABLE s hlavičkou Retry-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á.

  • symbol je povinný.
  • limit je od 1 do 500, výchozí 100. Coinero drží posledních 100 obchodů, takže odpověď jich obsahuje nejvýš 100.
  • Prázdné pole trades je 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.

ParametrHodnoty
symbolpovinný
intervalpovinný: 1m, 5m, 15m, 30m, 1h, 4h, 1d nebo 1w; záleží na velikosti písmen
limitod 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.
  • derivedFrom uvádí symbol zdrojového trhu, conversionRate použitý kurz bez zaokrouhlení (počet CZK na 1 EUR) a conversionRateTime s conversionRateTimeMs okamžik, kdy byl kurz načten. U trhů s vlastními daty jsou všechna tato pole v odpovědi vždy a mají hodnotu null.
  • 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í conversionRate a conversionRateTime, a platí pro všechny její ceny.

Odvozená kniha se mění i tehdy, když se kniha v EUR nezměnila.

Každá cena v knize se násobí kurzem, takže se při změně kurzu změní všechny ceny. Na WebSocketu proto kanál 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 USDCBTC nad burzovním párem BTC/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

StavKódKdy
400INVALID_PARAMETERChybí nebo je vadný symbol, limit či interval.
404UNKNOWN_SYMBOLCoinero tento pár neobchoduje.
404MARKET_HAS_NO_DEPTHData trhu nejde vydat ani odvodit.
404NOT_FOUNDCoinero referenční data provozně vypnulo.
503MARKET_DATA_UNAVAILABLEChybí 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.