Získat API klíč
Přehled API · Účet

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

Endpoint vyžaduje API klíč s oprávněním 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

ParametrPopis
currencyvolitelnéstringJen 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éstringJen 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éstringJen 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éstringPočet výběrů na stránce od 1 do 200; výchozí je 50.

Odpověď

200 · application/json · WithdrawalListResponse

Jsou 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.

PolePopis
itemspole WithdrawalResponseVýběry na této stránce od nejnovějšího podle createdAt.
items[].withdrawalIdstringIdentifikátor výběru.
items[].kindstringDruh 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.currencystringKód měny částky, například BTC nebo CZK.
items[].feeApiMoney nebo nullSíť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.currencystringKó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.currencystringKód měny částky, například BTC nebo CZK.
items[].statusstringStav výběru. Hodnoty: pending, onHold, completed, cancelled, rejected.
items[].createdAtstringKdy 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 nullKdy 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 nullStejný okamžik jako Unix timestamp v milisekundách. Případně null. Pole je v odpovědi vždy.
items[].addressstring nebo nullCí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 nullHash transakce na blockchainu, jakmile je kryptoměnový výběr odeslán, jinak null. Pole je v odpovědi vždy.
items[].bankAccountstring nebo nullMaskovaný 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.
hasMorebooleanTrue, 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í.

PublicTransactionKindVýznam
fiatbankovní převod
cryptopřevod kryptoměny na blockchainu nebo mezi dvěma klienty Coinera
PublicWithdrawalStatusVýznam
pendingvýběr se zpracovává (zadaný, čeká na schválení, schválený, odesílá se)
onHoldvýběr je pozastavený, například kvůli pravidlu Travel Rule
completedvýběr byl odeslán na adresu, potvrzen bankou nebo vypořádán uvnitř Coinera
cancelledvýběr byl zrušen a prostředky se vrátily na účet
rejectedvý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.

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.
404UNKNOWN_CURRENCYPouž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.
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.