Získat API klíč
Přehled API · Subúčty

GET /v1/subaccounts/{externalClientRef}/account/trades

Stejný endpoint jako GET /v1/account/trades, pro subúčet z cesty.

Partnerský klíč s oprávněním subaccounts

Endpoint patří do sekce Subúčty. Vyžaduje partnerský API klíč (prefix pk_) s oprávněním subaccounts a podpis požadavku; klientský klíč dostane 403 INSUFFICIENT_PERMISSION. Postup je na stránkách Podpis požadavků a Klíč partnera.

Parametry cesty

ParametrPopis
externalClientRefpovinnéstringIdentifikátor klienta ve vašem systému přesně tak, jak jste ho poslali při založení subúčtu, včetně velikosti písmen: 1 až 64 písmen bez diakritiky, číslic, pomlček a podtržítek.

Parametry dotazu

ParametrPopis
symbolvolitelnéstringJen obchody na tomto trhu, například BTCEUR nebo BTCCZK; velikost písmen nerozhoduje. Vyřazený pár API přijme; pár, který Coinero nikdy neobchodovalo, vrací 404 UNKNOWN_SYMBOL.
fromvolitelnéstringJen obchody uzavřené v tomto okamžiku nebo později. ISO 8601 (bez posunu se čas bere jako UTC) nebo milisekundy od 1. 1. 1970.
tovolitelnéstringJen obchody uzavřené před tímto okamžikem. ISO 8601 nebo milisekundy; nesmí být dřívější než from.
pagevolitelnéstringČíslo stránky od 1; výchozí je 1.
limitvolitelnéstringPočet obchodů na stránce od 1 do 200; výchozí je 50.

Odpověď

200 · application/json · TradeListResponse

Vyžaduje partnerský API klíč s oprávněním subaccounts a podepsaný požadavek. Funguje pro subúčet v každém stavu kromě zamítnutého; neexistující, cizí nebo zamítnutý subúčet vrací 404 CLIENT_NOT_FOUND.

Obchod je pokyn naplněný celý nebo zčásti. Jednotlivá naplnění se nevydávají, proto se tradeId rovná orderId; pokyn si přečtete z GET /v1/orders/{orderId}.

Čas obchodu je okamžik úplného naplnění pokynu; u pokynu naplněného jen zčásti (například zrušeného po částečném naplnění) je to čas jeho vytvoření.

Obchody před migrací z CoinBank a prodeje drobných zůstatků, které aplikace v historii ukazuje, se nevydávají.

Stránkování funguje podle offsetu; omezení a doporučený postup popisuje stránka Účet. Odpověď se neukládá do cache.

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

PolePopis
itemspole TradeResponseObchody na této stránce od nejnovějšího podle času obchodu.
items[].tradeIdstringIdentifikátor obchodu. Každá položka je jeden naplněný pokyn, takže se rovná orderId; jednotlivá naplnění se nevydávají.
items[].orderIdstringIdentifikátor pokynu, ze kterého obchod vznikl, jako v GET /v1/orders/{orderId}.
items[].symbolstringSymbol trhu tak, jak byl zadán při zadání pokynu, například BTCCZK.
items[].basestringKód základní měny trhu.
items[].quotestringKód kotovací měny trhu.
items[].sidestringStrana obchodu z pohledu základní měny. Hodnoty: buy, sell.
items[].typestringTyp pokynu. Hodnoty: market, limit.
items[].quantitystring nebo nullNaplněné množství v základní měně jako desetinný řetězec, tedy filledQuantity pokynu. Null na trhu, který Coinero kotuje opačně než burza (například USDCBTC). Pole je v odpovědi vždy.
items[].pricestring nebo nullPrůměrná cena naplnění v kotovací měně za jednotku základní měny, tedy averagePrice pokynu; u trhů v CZK přepočtená kurzem pokynu. Null jen tehdy, když kurz není znám. Pole je v odpovědi vždy.
items[].feeApiMoney nebo nullPoplatek Coinera za obchod, tedy údaj, který aplikace ukazuje jako poplatek. Null jen tehdy, když není známa měna poplatku. Pole je v odpovědi vždy.
items[].fee.amountstringČástka jako desetinný řetězec s tečkou a nejméně s tolika místy, kolik má její měna. Zpracujte ji jako desetinné číslo, ne jako číslo s pohyblivou řádovou čárkou.
items[].fee.currencystringKód měny částky, například BTC nebo CZK.
items[].spentApiMoneyČástka, kterou jste skutečně zaplatili, v měně, kterou pokyn utrácí; jako spent u pokynu.
items[].spent.amountstringČástka jako desetinný řetězec s tečkou a nejméně s tolika místy, kolik má její měna. Zpracujte ji jako desetinné číslo, ne jako číslo s pohyblivou řádovou čárkou.
items[].spent.currencystringKód měny částky, například BTC nebo CZK.
items[].receivedApiMoneyČástka, kterou jste skutečně získali, v měně, do které pokyn nakupuje nebo prodává, po poplatku Coinera; jako received u pokynu.
items[].received.amountstringČástka jako desetinný řetězec s tečkou a nejméně s tolika místy, kolik má její měna. Zpracujte ji jako desetinné číslo, ne jako číslo s pohyblivou řádovou čárkou.
items[].received.currencystringKód měny částky, například BTC nebo CZK.
items[].settledbooleanTrue, jakmile je obchod vypořádaný na účtu; do té doby se získaná částka ještě může změnit.
items[].timestringKdy byl obchod uzavřen, ISO 8601, UTC, s milisekundami: při úplném naplnění pokynu, u pokynu naplněného jen zčásti při jeho vytvoření.
items[].timeMsinteger (int64)Stejný okamžik jako Unix timestamp v milisekundách.
items[].settledAtstring nebo nullKdy byl obchod vypořádán, ISO 8601, UTC, jinak null. Pole je v odpovědi vždy.
items[].settledAtMsinteger nebo nullStejný okamžik jako Unix timestamp v milisekundách. Případně null. Pole je v odpovědi vždy.
pageinteger (int32)Číslo stránky od 1, jak bylo požadováno.
limitinteger (int32)Nejvyšší počet obchodů na stránce, jak byl požadován.
hasMorebooleanTrue, když za touto stránkou následuje další.
totalinteger (int32)Počet obchodů odpovídajících filtrům na všech stránkách.

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
PublicOrderTypeVýznam
markettržní pokyn se provede za aktuální tržní cenu
limitlimitní pokyn se provede za zadanou limitní cenu nebo lepší

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_KEY, SIGNATURE_REQUIRED, INVALID_SIGNATURE, TIMESTAMP_OUT_OF_WINDOWDoplňte hlavičku X-COINERO-APIKEY. Ověřte hodnotu a stav klíče i aktivitu účtu. Doplňte hlavičky X-COINERO-TIMESTAMP a X-COINERO-SIGNATURE podle stránky Podpis požadavků. Zkontrolujte kanonický řetězec (časová značka, metoda velkými písmeny, cesta s dotazem, tělo bajt po bajtu) a že secret před HMAC dekódujete z Base64; stránka Podpis požadavků má referenční vektor. Použijte aktuální čas v milisekundách; pole serverTime a serverTimeMs v odpovědi nesou čas serveru, podle kterého opravte hodiny klienta.
403INSUFFICIENT_PERMISSION, IP_NOT_ALLOWEDPole requiredPermission uvádí, které oprávnění chybí. Oprávnění klíče nelze změnit; vytvořte nový klíč s potřebným oprávněním. 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.
404CLIENT_NOT_FOUND, UNKNOWN_SYMBOLOvěřte externalClientRef včetně velikosti písmen; neexistující, cizí i zamítnutý subúčet vracejí stejnou chybu. Subúčet založte přes POST /v1/subaccounts. 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ší.
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.