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

GET /v1/account/deposits

Vrací vklady účtu, bankovní převody i kryptoměnové vklady 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 vklady 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 vklady 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 vklady 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 vkladů na stránce od 1 do 200; výchozí je 50.

Odpověď

200 · application/json · DepositListResponse

Jsou to tytéž vklady, které aplikace Coinero ukazuje v přehledu vkladů a výběrů, včetně převodů od jiných klientů Coinera.

Stav je hrubá veřejná hodnota; onHold znamená, že vklad čeká na kontrolu nebo na informaci od vás; podrobnosti ukáže aplikace.

Vklady přes Lightning a pohyby před migrací z CoinBank se nevydávají.

Vklad připsaný z burzy (poslaný na adresu burzy nebo starší vkladovou adresu) se řadí a filtruje podle okamžiku zaúčtování, zatímco jeho createdAt je den transakce a může být dřívější.

Odesílající 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 DepositResponseVklady na této stránce od nejnovějšího podle createdAt; vklad připsaný z burzy podle okamžiku zaúčtování.
items[].depositIdstringIdentifikátor vkladu.
items[].kindstringDruh vkladu. Hodnoty: fiat, crypto.
items[].amountApiMoneyČástka vkladu.
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[].statusstringStav vkladu. Hodnoty: pending, onHold, completed, returned, rejected, failed.
items[].createdAtstringKdy byl vklad přijat (bankovní převod) nebo zaznamenán na blockchainu (kryptoměna), ISO 8601, UTC, s milisekundami. U vkladu připsaného z burzy je to den transakce, zatímco seznam ho řadí a filtruje podle okamžiku zaúčtování, takže createdAt může být dřívější než u okolních položek.
items[].createdAtMsinteger (int64)Stejný okamžik jako Unix timestamp v milisekundách.
items[].completedAtstring nebo nullKdy byl kryptoměnový vklad připsán na účet, ISO 8601, UTC, jinak null. U bankovního převodu je vždy null, jeho připsání říká stav. 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[].txIdstring nebo nullHash transakce na blockchainu u kryptoměnového vkladu; u vkladu připsaného z burzy reference, kterou burza uvádí (hash transakce, jinak její vlastní identifikátor pohybu). U bankovního převodu a převodu od jiného klienta Coinera, který blockchain nepoužívá, je null. Pole je v odpovědi vždy.
items[].senderBankAccountstring nebo nullMaskovaný účet, ze kterého bankovní převod přišel: poslední čtyři znaky čísla účtu a kód banky, například ***6789/0800, u IBAN jen poslední čtyři znaky; null, když není znám. Pole je v odpovědi vždy.
pageinteger (int32)Číslo stránky od 1, jak bylo požadováno.
limitinteger (int32)Nejvyšší počet vkladů na stránce, jak byl požadován.
hasMorebooleanTrue, když za touto stránkou následuje další.
totalinteger (int32)Počet vkladů 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
PublicDepositStatusVýznam
pendingvklad se zpracovává
onHoldvklad čeká na kontrolu nebo na informaci od vás, například o odesílateli; podrobnosti ukáže aplikace
completedvklad je připsaný na účet
returnedvklad byl vrácen odesílateli
rejectedvklad byl odmítnut
failedvklad se nepodařilo zpracovat

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.