GET /v1/depth
Vrací knihu pokynů jednoho trhu: nejvýše limit cenových úrovní na každé straně.
Referenční data burzy
Parametry dotazu
| Parametr | Popis |
|---|---|
| symbolpovinnéstring | Symbol trhu z GET /v1/markets, například BTCEUR nebo BTCCZK; velikost písmen nerozhoduje. Povinný. |
| limitvolitelnéstring | Poč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 · DepthResponseNá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.
| Pole | Popis |
|---|---|
| symbolstring | Symbol páru: základní a kotovací měna bez oddělovače, například BTCEUR. |
| basestring | Kód základní měny, například BTC. |
| quotestring | Kó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 string | Ná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 string | Prodejní pokyny jako dvojice desetinných řetězců [cena, množství] od nejnižší ceny. |
| timestampstring | Kdy 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 null | U 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 null | U 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 null | Kdy 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 null | Stejný 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.
| Stav | Kódy | Řešení |
|---|---|---|
| 400 | INVALID_PARAMETER | Opravte parametry uvedené v poli detail podle dokumentace. Opakovaný parametr se bere jako chybný. |
| 401 | MISSING_API_KEY, INVALID_API_KEY | Doplňte hlavičku X-COINERO-APIKEY. Ověřte hodnotu a stav klíče i aktivitu účtu. |
| 403 | IP_NOT_ALLOWED | Odešlete požadavek z adresy povolené u klíče, nebo vytvořte nový klíč, jehož seznam adresu obsahuje; seznam nelze dodatečně změnit. |
| 404 | UNKNOWN_SYMBOL, MARKET_HAS_NO_DEPTH, NOT_FOUND | Vyberte 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. |
| 405 | METHOD_NOT_ALLOWED | Použijte metodu z hlavičky Allow: GET a HEAD ke čtení, POST a DELETE jen u operací, které je mají v dokumentaci. |
| 429 | RATE_LIMIT_EXCEEDED | Před dalším pokusem vyčkejte počet sekund z Retry-After. |
| 503 | MARKET_DATA_UNAVAILABLE, SERVICE_MAINTENANCE | Data 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. |