GET /v1/account/withdrawals
Vrací výběry účtu, bankovní převody i kryptoměnové výběry dohromady, od nejnovějšího.
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 |
|---|---|
| currencyvolitelnéstring | Jen výběry v této měně, například CZK nebo BTC; velikost písmen nerozhoduje. Měnu, kterou Coinero nezná, API odmítne chybou 404 UNKNOWN_CURRENCY. |
| fromvolitelnéstring | Jen výběry vytvoř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 výběry vytvoř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 výběrů na stránce od 1 do 200; výchozí je 50. |
Odpověď
200 · application/json · WithdrawalListResponseJsou to tytéž výběry, které aplikace Coinero ukazuje v přehledu vkladů a výběrů.
U kryptoměnového výběru je amount částka, kterou jste zadali, fee síťový poplatek (do odeslání odhad) a netAmount částka, která dorazí na cílovou adresu. U bankovního převodu poplatek není a netAmount se rovná amount.
Stav je hrubá veřejná hodnota. Výběr nelze přes API zadat ani zrušit.
Platby přes Lightning a pohyby před migrací z CoinBank se nevydávají. Cílový bankovní účet je maskovaný na poslední čtyři znaky a kód banky.
Odpověď se neukládá do cache.
Částky a ceny jsou desetinné řetězce, aby nedocházelo ke ztrátě přesnosti.
| Pole | Popis |
|---|---|
| itemspole WithdrawalResponse | Výběry na této stránce od nejnovějšího podle createdAt. |
| items[].withdrawalIdstring | Identifikátor výběru. |
| items[].kindstring | Druh výběru. Hodnoty: fiat, crypto. |
| items[].amountApiMoney | Částka výběru tak, jak jste ji zadali. |
| items[].amount.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[].amount.currencystring | Kód měny částky, například BTC nebo CZK. |
| items[].feeApiMoney nebo null | Síťový poplatek kryptoměnového výběru, do odeslání odhad a po odeslání skutečný poplatek; u bankovního převodu, který poplatek nemá, null. 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[].netAmountApiMoney | Částka, která jde na cíl: u kryptoměnového výběru amount minus fee, když je poplatek zahrnutý v částce, jinak amount; u bankovního převodu amount. |
| items[].netAmount.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[].netAmount.currencystring | Kód měny částky, například BTC nebo CZK. |
| items[].statusstring | Stav výběru. Hodnoty: pending, onHold, completed, cancelled, rejected. |
| items[].createdAtstring | Kdy byl výběr zadán, ISO 8601, UTC, s milisekundami. |
| items[].createdAtMsinteger (int64) | Stejný okamžik jako Unix timestamp v milisekundách. |
| items[].completedAtstring nebo null | Kdy byl výběr dokončen (odeslán na adresu nebo potvrzen bankou), ISO 8601, UTC, jinak null. Pole je v odpovědi vždy. |
| items[].completedAtMsinteger nebo null | Stejný okamžik jako Unix timestamp v milisekundách. Případně null. Pole je v odpovědi vždy. |
| items[].addressstring nebo null | Cílová adresa kryptoměnového výběru; null u bankovního převodu a u převodu vypořádaného uvnitř Coinera bez adresy. Pole je v odpovědi vždy. |
| items[].txIdstring nebo null | Hash transakce na blockchainu, jakmile je kryptoměnový výběr odeslán, jinak null. Pole je v odpovědi vždy. |
| items[].bankAccountstring nebo null | Maskovaný cílový bankovní účet převodu: poslední čtyři znaky čísla účtu a kód banky, například ***4567/2010, u IBAN jen poslední čtyři znaky; null u kryptoměnového výběru. Pole je v odpovědi vždy. |
| pageinteger (int32) | Číslo stránky od 1, jak bylo požadováno. |
| limitinteger (int32) | Nejvyšší počet výběrů na stránce, jak byl požadován. |
| hasMoreboolean | True, když za touto stránkou následuje další. |
| totalinteger (int32) | Počet výběrů 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í.
| PublicTransactionKind | Význam |
|---|---|
fiat | bankovní převod |
crypto | převod kryptoměny na blockchainu nebo mezi dvěma klienty Coinera |
| PublicWithdrawalStatus | Význam |
|---|---|
pending | výběr se zpracovává (zadaný, čeká na schválení, schválený, odesílá se) |
onHold | výběr je pozastavený, například kvůli pravidlu Travel Rule |
completed | výběr byl odeslán na adresu, potvrzen bankou nebo vypořádán uvnitř Coinera |
cancelled | výběr byl zrušen a prostředky se vrátily na účet |
rejected | výběr byl odmítnut |
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_CURRENCY | Použijte kód měny z GET /v1/account/balances nebo z polí base a quote v GET /v1/markets; 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. |