GET /v1/trades
Vrací poslední veřejné obchody jednoho trhu na burze od nejstaršího.
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 obchodů od 1 do 500; výchozí je 100. Odpověď nemá víc obchodů, než kolik Coinero drží. |
Odpověď
200 · application/json · MarketTradesResponseVrací nejvýše limit obchodů a nejvýše tolik, kolik Coinero drží (nyní posledních 100). Strana (side) je strana pokynu, který si vzal likviditu; typ pokynu se nezveřejňuje. Prázdný seznam je platná odpověď: trh v poslední době neměl obchody.
Jsou to referenční data burzy, ne ceny, za které klient obchoduje v Coineru; neobsahují poplatek Coinera ani měnovou přirážku u trhů v CZK.
Trhy v CZK se odvozují z trhu, na kterém se provádějí, středním kurzem bez přirážky, stejně jako u GET /v1/depth; zdroj a kurz uvádí derivedFrom a conversionRate.
Trh bez vlastních dat, který nelze odvodit, vrací 404 MARKET_HAS_NO_DEPTH. Když Coinero referenční tržní data provozně vypne, endpoint odpovídá 404 NOT_FOUND.
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. |
| tradespole MarketTradeResponse | Poslední veřejné obchody na burze od nejstaršího. |
| trades[].tradeIdstring | Identifikátor obchodu na burze jako řetězec číslic. |
| trades[].pricestring | Cena za jednotku základní měny jako desetinný řetězec v kotovací měně. |
| trades[].quantitystring | Zobchodované množství jako desetinný řetězec v základní měně. |
| trades[].sidestring | Strana pokynu, který si vzal likviditu: buy, když kupující přijal prodejní pokyn, sell, když prodávající přijal nákupní pokyn. Hodnoty: buy, sell. |
| trades[].timestring | Kdy obchod proběhl, ISO 8601, UTC, s milisekundami. |
| trades[].timeMsinteger (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. |
Hodnoty stavů
Nové hodnoty mohou přibýt i v rámci v1; neznámou hodnotu zpracujte bez selhání.
| PublicOrderSide | Význam |
|---|---|
buy | nákup: platíte kotovací měnou a získáváte základní měnu |
sell | prodej: platíte základní měnou a získáváte kotovací měnu |
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. |