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

GET /v1/trades

Vrací poslední veřejné obchody jednoho trhu na burze od nejstaršího.

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 obchodů od 1 do 500; výchozí je 100. Odpověď nemá víc obchodů, než kolik Coinero drží.

Odpověď

200 · application/json · MarketTradesResponse

Vrací 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.

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.
tradespole MarketTradeResponsePoslední veřejné obchody na burze od nejstaršího.
trades[].tradeIdstringIdentifikátor obchodu na burze jako řetězec číslic.
trades[].pricestringCena za jednotku základní měny jako desetinný řetězec v kotovací měně.
trades[].quantitystringZobchodované množství jako desetinný řetězec v základní měně.
trades[].sidestringStrana 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[].timestringKdy obchod proběhl, ISO 8601, UTC, s milisekundami.
trades[].timeMsinteger (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.

Hodnoty stavů

Nové hodnoty mohou přibýt i v rámci v1; neznámou hodnotu zpracujte bez selhání.

PublicOrderSideVýznam
buynákup: platíte kotovací měnou a získáváte základní měnu
sellprodej: 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.

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.