GET /v1/subaccounts
Vrací subúčty vašeho partnerského účtu podle času poslední změny od nejnovější, kurzorově, abyste mohli sladit jejich stavy se svou evidencí.
Partnerský klíč s oprávněním subaccounts
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 dotazu
| Parametr | Popis |
|---|---|
| statusvolitelnéstring | Jen subúčty v tomto stavu: review, active, blocked nebo rejected. |
| updatedAftervolitelnéstring | Jen subúčty změněné po tomto okamžiku (bez něj). ISO 8601 (chybějící posun znamená UTC) nebo milisekundy od počátku Unixové epochy. |
| cursorvolitelnéstring | nextCursor předchozí stránky. Neprůhledná hodnota, pošlete ji beze změny. |
| limitvolitelnéstring | Počet subúčtů na stránce, od 1 do 500. Výchozí 50. |
Odpověď
200 · application/json · SubaccountListResponsePoložka je týž objekt subúčtu jako v GET /v1/subaccounts/{externalClientRef}. Seznam obsahuje i zamítnuté subúčty, které detail a endpointy pod prefixem subúčtu vracejí jako 404.
Čas poslední změny (updatedAt) se posune při změně stavu subúčtu (aktivace, vrácení k posouzení, zamítnutí, zablokování, odblokování) a při změně kontaktu. Změna limitů nebo trhů vašeho partnerského účtu a čerpání denního limitu ho neposouvají.
Změny mladší než 5 sekund seznam ještě nevrací.
Další stránku načtete s nextCursor předchozí stránky v parametru cursor; na poslední stránce je null. Subúčet, který se během čtení změní, se přesune na začátek seznamu. Další čtení proto začněte s updatedAfter nastaveným na nejnovější updatedAt z přečtených položek (stejně jako u GET /v1/subaccounts/orders), ne podle hodin svého systému; vrátí všechny pozdější změny a subúčet načtený dvakrát je stejný objekt.
Vyžaduje partnerský API klíč s oprávněním subaccounts a podepsaný požadavek. Odpověď se neukládá do cache.
Částky a ceny jsou desetinné řetězce, aby nedocházelo ke ztrátě přesnosti.
| Pole | Popis |
|---|---|
| itemspole SubaccountResponse | Subúčty na této stránce od nejnovější změny. Každá položka je týž objekt jako v GET /v1/subaccounts/{externalClientRef}. |
| items[].externalClientRefstring | Identifikátor klienta ve vašem systému, jak byl uložen při založení. |
| items[].statusstring | Stav subúčtu. Hodnoty: review, active, blocked, rejected, closed. |
| items[].createdAtstring | Kdy subúčet vznikl, ISO 8601, UTC. |
| items[].createdAtMsinteger (int64) | Stejný okamžik jako Unix timestamp v milisekundách. |
| items[].activatedAtstring nebo null | Kdy byl subúčet naposledy aktivován, ISO 8601, UTC; null, pokud nikdy. Pole je v odpovědi vždy. |
| items[].activatedAtMsinteger nebo null | Stejný okamžik jako Unix timestamp v milisekundách. Případně null. |
| items[].closedAtstring nebo null | Kdy byl subúčet ukončen, ISO 8601, UTC; null, dokud ukončený není. Pole je v odpovědi vždy. |
| items[].closedAtMsinteger nebo null | Stejný okamžik jako Unix timestamp v milisekundách. Případně null. |
| items[].updatedAtstring | Kdy se subúčet naposledy změnil (stav nebo kontakt), ISO 8601, UTC. Podle něj GET /v1/subaccounts řadí a filtruje: nejnovější přečtená hodnota je updatedAfter vašeho dalšího čtení. V události webhooku je to okamžik události, nikdy pozdější než hodnota v seznamu. |
| items[].updatedAtMsinteger (int64) | Stejný okamžik jako Unix timestamp v milisekundách. |
| items[].limitsSubaccountLimitsResponse | Limity pokynů vašeho partnerského účtu, které platí pro subúčet. |
| items[].limits.minOrderAmountApiMoney | Nejmenší pokyn v korunách. |
| items[].limits.minOrderAmount.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[].limits.minOrderAmount.currencystring | Kód měny částky, například BTC nebo CZK. |
| items[].limits.maxOrderAmountApiMoney nebo null | Největší pokyn v korunách; null bez horní meze. Pole je v odpovědi vždy. |
| items[].limits.maxOrderAmount.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[].limits.maxOrderAmount.currencystring | Kód měny částky, například BTC nebo CZK. |
| items[].limits.dailyLimitApiMoney | Denní limit pokynů jednoho klienta v korunách. |
| items[].limits.dailyLimit.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[].limits.dailyLimit.currencystring | Kód měny částky, například BTC nebo CZK. |
| items[].limits.dailyLimitRemainingApiMoney | Zbývající část denního limitu pro dnešní den podle pražského času, v korunách. Zrušené a odmítnuté pokyny se nepočítají. |
| items[].limits.dailyLimitRemaining.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[].limits.dailyLimitRemaining.currencystring | Kód měny částky, například BTC nebo CZK. |
| items[].allowedMarketspole string | Trhy, na kterých subúčet smí obchodovat: kryptoměny, které partner nabízí, proti jeho měně vypořádání, například BTCCZK. |
| items[].contactSubaccountContactResponse | Kontakt klienta, jak jste ho poslali. |
| items[].contact.emailstring nebo null | Kontaktní e-mail klienta, nebo null. Pole je v odpovědi vždy. |
| items[].contact.phonestring nebo null | Kontaktní telefon klienta v mezinárodním tvaru, nebo null. Pole je v odpovědi vždy. |
| nextCursorstring nebo null | Neprůhledný kurzor další stránky, pošlete ho v parametru cursor. Null, když starší subúčty nenásledují. Pole je v odpovědi vždy. |
| hasMoreboolean | True, když dotazu odpovídají další, starší subúčty za touto stránkou. |
| limitinteger (int32) | Nejvyšší počet subúčtů na stránce, jak byl požadován. |
Hodnoty stavů
Nové hodnoty mohou přibýt i v rámci v1; neznámou hodnotu zpracujte bez selhání.
| PublicSubaccountStatus | Význam |
|---|---|
review | subúčet čeká na posouzení Coinerem a zatím nemůže obchodovat |
active | subúčet může obchodovat |
blocked | Coinero subúčet zablokovalo a ten nemůže obchodovat; důvod se nesděluje |
rejected | aktivace subúčtu byla trvale zamítnuta; detail a endpointy pod prefixem subúčtu ho vracejí jako 404, objeví se v seznamu GET /v1/subaccounts a v odpovědi opakovaného založení |
closed | subúčet je ukončený a nemůže obchodovat ani se měnit; data jdou dál číst a znovu otevřít ho nejde |
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. |
| 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. |