GET /v1/account/trades
Vrací obchody účtu od nejnovějšího, jeden obchod za každý naplněný pokyn.
Podepsaný požadavek s oprávněním account
account a podpis požadavku. Postup je na stránce Podpis požadavků, oprávnění vysvětluje Oprávnění a životnost klíče.Parametry dotazu
| Parametr | Popis |
|---|---|
| symbolvolitelnéstring | Jen 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éstring | Jen 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éstring | Jen 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éstring | Počet obchodů na stránce od 1 do 200; výchozí je 50. |
Odpověď
200 · application/json · TradeListResponseObchod 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.
| Pole | Popis |
|---|---|
| itemspole TradeResponse | Obchody na této stránce od nejnovějšího podle času obchodu. |
| items[].tradeIdstring | Identifikátor obchodu. Každá položka je jeden naplněný pokyn, takže se rovná orderId; jednotlivá naplnění se nevydávají. |
| items[].orderIdstring | Identifikátor pokynu, ze kterého obchod vznikl, jako v GET /v1/orders/{orderId}. |
| items[].symbolstring | Symbol trhu tak, jak byl zadán při zadání pokynu, například BTCCZK. |
| items[].basestring | Kód základní měny trhu. |
| items[].quotestring | Kód kotovací měny trhu. |
| items[].sidestring | Strana obchodu z pohledu základní měny. Hodnoty: buy, sell. |
| items[].typestring | Typ pokynu. Hodnoty: market, limit. |
| items[].quantitystring nebo null | Naplně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 null | Prů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 null | Poplatek 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.currencystring | Kó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.currencystring | Kó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.currencystring | Kód měny částky, například BTC nebo CZK. |
| items[].settledboolean | True, jakmile je obchod vypořádaný na účtu; do té doby se získaná částka ještě může změnit. |
| items[].timestring | Kdy 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 null | Kdy byl obchod vypořádán, ISO 8601, UTC, jinak null. Pole je v odpovědi vždy. |
| items[].settledAtMsinteger nebo null | Stejný 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. |
| hasMoreboolean | True, 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í.
| 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 |
| PublicOrderType | Význam |
|---|---|
market | tržní pokyn se provede za aktuální tržní cenu |
limit | limitní 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.
| 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, SIGNATURE_REQUIRED, INVALID_SIGNATURE, TIMESTAMP_OUT_OF_WINDOW | Doplň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. |
| 403 | INSUFFICIENT_PERMISSION, IP_NOT_ALLOWED | Pole 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. |
| 404 | UNKNOWN_SYMBOL | 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ší. |
| 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. |