Získat API klíč
Přehled API · Tržní data

GET /v1/depth

Vrací knihu pokynů jednoho trhu: nejvýše limit cenových úrovní na každé straně.

Referenční data burzy

Data nejsou ceny, za které obchodujete v Coineru: neobsahují poplatek Coinera ani měnovou přirážku. Klientské ceny vracejí GET /v1/ticker a odhad pokynu z POST /v1/orders/validate.

Parametry dotazu

ParametrPopis
symbolpovinnéstringSymbol trhu z GET /v1/markets, například BTCEUR nebo BTCCZK; velikost písmen nerozhoduje. Povinný.
limitvolitelnéstringPočet cenových úrovní na stranu od 1 do 100; výchozí je 25. Odpověď nemá víc úrovní, než kolik má snímek.

Odpověď

200 · application/json · DepthResponse

Nákupní úrovně (bids) jdou od nejvyšší ceny, prodejní (asks) od nejnižší; každá úroveň je dvojice desetinných řetězců [cena, množství]. Hloubka nepřesáhne snímek, který Coinero drží (nyní 25 úrovní na stranu), takže vyšší limit může vrátit méně úrovní.

Jsou to referenční data burzy, na které Coinero provádí pokyny, ne ceny, za které klient obchoduje. Neobsahují poplatek Coinera ani měnovou přirážku u trhů v CZK. Ceny pro klienta jsou v GET /v1/ticker a v odhadu pokynu z POST /v1/orders/validate.

Trhy v CZK nemají na burze vlastní data. Vrací se data trhu, na kterém se provádějí (BTCEUR pro BTCCZK), s každou cenou vynásobenou středním kurzem EUR/CZK bez přirážky; množství zůstávají. Odpověď pak uvádí zdrojový trh v derivedFrom a kurz s časem v conversionRate a conversionRateTime, u trhů s vlastními daty jsou tato pole null.

Trh obchodovaný opačně než na burze (například USDCBTC) knihu nemá a nelze ji odvodit: odpověď je 404 MARKET_HAS_NO_DEPTH.

Když Coinero referenční tržní data provozně vypne, endpoint odpovídá 404 NOT_FOUND, jako by cesta neexistovala, a GET /v1/status hlásí komponenty depth, trades a ohlc jako disabled.

Odpověď se neukládá do cache.

Částky a ceny jsou desetinné řetězce, aby nedocházelo ke ztrátě přesnosti.

PolePopis
symbolstringSymbol páru: základní a kotovací měna bez oddělovače, například BTCEUR.
basestringKód základní měny, například BTC.
quotestringKód kotovací měny. Kromě EUR a CZK Coinero kotuje páry i v BTC, ETH a USDC. Páry v CZK Coinero kotuje v CZK a na burze provádí přes EUR; převod je už součástí cen z GET /v1/ticker.
bidspole pole stringNákupní pokyny jako dvojice desetinných řetězců [cena, množství] od nejvyšší ceny: cena v kotovací měně za jednotku základní měny a množství v základní měně. Ceny odvozeného trhu mají nejméně šest platných číslic a všechny stejný počet desetinných míst.
askspole pole stringProdejní pokyny jako dvojice desetinných řetězců [cena, množství] od nejnižší ceny.
timestampstringKdy byl pořízen snímek knihy pokynů, ISO 8601, UTC, s milisekundami.
timestampMsinteger (int64)Stejný okamžik jako Unix timestamp v milisekundách.
derivedFromstring nebo nullU trhu bez vlastních dat na burze (trhy v CZK) symbol trhu, ze kterého se data odvozují, například BTCEUR; jinak null. Pole je v odpovědi vždy.
conversionRatestring nebo nullU odvozeného trhu střední kurz, kterým se vynásobila každá cena: počet jednotek kotovací měny tohoto trhu na jednu jednotku kotovací měny zdrojového trhu, například 25.134 CZK za 1 EUR, bez přirážky; jinak null. Desetinný řetězec bez zaokrouhlení. Pole je v odpovědi vždy.
conversionRateTimestring nebo nullKdy byl kurz načten, ISO 8601, UTC; u trhu s vlastními daty null. Liší se od času samotných dat. Pole je v odpovědi vždy.
conversionRateTimeMsinteger nebo nullStejný okamžik jako Unix timestamp v milisekundách. Případně null.

Chyby

Chyby mají formát application/problem+json; zpracovávejte je podle pole code. Podrobnosti najdete v přehledu chyb.

StavKódyŘešení
400INVALID_PARAMETEROpravte parametry uvedené v poli detail podle dokumentace. Opakovaný parametr se bere jako chybný.
401MISSING_API_KEY, INVALID_API_KEYDoplňte hlavičku X-COINERO-APIKEY. Ověřte hodnotu a stav klíče i aktivitu účtu.
403IP_NOT_ALLOWEDOdešlete požadavek z adresy povolené u klíče, nebo vytvořte nový klíč, jehož seznam adresu obsahuje; seznam nelze dodatečně změnit.
404UNKNOWN_SYMBOL, MARKET_HAS_NO_DEPTH, NOT_FOUNDVyberte pár se stavem trading nebo paused z GET /v1/markets; neznámý i vyřazený pár vrací 404 a pole detail je od sebe odliší. Trh nemá vlastní knihu pokynů, obchody ani svíčky a nelze je odvodit; opakování nepomůže, zvolte jiný pár. Ověřte cestu a požadovaný zdroj; opakování stejného požadavku nepomůže.
405METHOD_NOT_ALLOWEDPoužijte metodu z hlavičky Allow: GET a HEAD ke čtení, POST a DELETE jen u operací, které je mají v dokumentaci.
429RATE_LIMIT_EXCEEDEDPřed dalším pokusem vyčkejte počet sekund z Retry-After.
503MARKET_DATA_UNAVAILABLE, SERVICE_MAINTENANCEData dočasně chybí; vyčkejte počet sekund z Retry-After a požadavek zopakujte. Probíhá údržba nebo je dočasně vypnuté obchodování či WebSocket; ověřte GET /v1/status a vyčkejte podle Retry-After.