Získat API klíč
Přehled API · Subúčty

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

Endpoint patří do sekce Subúčty. Vyžaduje partnerský API klíč (prefix 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

ParametrPopis
statusvolitelnéstringJen subúčty v tomto stavu: review, active, blocked nebo rejected.
updatedAftervolitelnéstringJen 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éstringnextCursor předchozí stránky. Neprůhledná hodnota, pošlete ji beze změny.
limitvolitelnéstringPočet subúčtů na stránce, od 1 do 500. Výchozí 50.

Odpověď

200 · application/json · SubaccountListResponse

Polož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.

PolePopis
itemspole SubaccountResponseSubúč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[].externalClientRefstringIdentifikátor klienta ve vašem systému, jak byl uložen při založení.
items[].statusstringStav subúčtu. Hodnoty: review, active, blocked, rejected, closed.
items[].createdAtstringKdy subúčet vznikl, ISO 8601, UTC.
items[].createdAtMsinteger (int64)Stejný okamžik jako Unix timestamp v milisekundách.
items[].activatedAtstring nebo nullKdy byl subúčet naposledy aktivován, ISO 8601, UTC; null, pokud nikdy. Pole je v odpovědi vždy.
items[].activatedAtMsinteger nebo nullStejný okamžik jako Unix timestamp v milisekundách. Případně null.
items[].closedAtstring nebo nullKdy byl subúčet ukončen, ISO 8601, UTC; null, dokud ukončený není. Pole je v odpovědi vždy.
items[].closedAtMsinteger nebo nullStejný okamžik jako Unix timestamp v milisekundách. Případně null.
items[].updatedAtstringKdy 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[].limitsSubaccountLimitsResponseLimity pokynů vašeho partnerského účtu, které platí pro subúčet.
items[].limits.minOrderAmountApiMoneyNejmenší 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.currencystringKód měny částky, například BTC nebo CZK.
items[].limits.maxOrderAmountApiMoney nebo nullNejvě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.currencystringKód měny částky, například BTC nebo CZK.
items[].limits.dailyLimitApiMoneyDenní 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.currencystringKód měny částky, například BTC nebo CZK.
items[].limits.dailyLimitRemainingApiMoneyZbý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.currencystringKód měny částky, například BTC nebo CZK.
items[].allowedMarketspole stringTrhy, na kterých subúčet smí obchodovat: kryptoměny, které partner nabízí, proti jeho měně vypořádání, například BTCCZK.
items[].contactSubaccountContactResponseKontakt klienta, jak jste ho poslali.
items[].contact.emailstring nebo nullKontaktní e-mail klienta, nebo null. Pole je v odpovědi vždy.
items[].contact.phonestring nebo nullKontaktní telefon klienta v mezinárodním tvaru, nebo null. Pole je v odpovědi vždy.
nextCursorstring nebo nullNeprů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.
hasMorebooleanTrue, 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í.

PublicSubaccountStatusVýznam
reviewsubúčet čeká na posouzení Coinerem a zatím nemůže obchodovat
activesubúčet může obchodovat
blockedCoinero subúčet zablokovalo a ten nemůže obchodovat; důvod se nesděluje
rejectedaktivace 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í
closedsubúč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.

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