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

PUT /v1/subaccounts/{externalClientRef}

Změní kontakt, adresu trvalého pobytu a daňové rezidence subúčtu.

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 cesty

ParametrPopis
externalClientRefpovinnéstringIdentifikátor klienta ve vašem systému přesně tak, jak jste ho poslali při založení subúčtu, včetně velikosti písmen: 1 až 64 písmen bez diakritiky, číslic, pomlček a podtržítek.

Tělo požadavku

application/json · UpdateSubaccountBody

Podepište a odešlete bajt po bajtu totéž tělo, bez přeformátování. Neznámá pole API ignoruje a pole s hodnotou null je totéž jako pole vynechané.

PolePopis
contactEmailvolitelnéstringNepovinné. Nový kontaktní e-mail klienta.
contactPhonevolitelnéstringNepovinné. Nový kontaktní telefon v mezinárodním tvaru, například +420601234567.
addressvolitelnéSubaccountAddressBodyNepovinné. Nová úplná adresa trvalého pobytu. Jen u subúčtu založeného s balíčkem identifikace.
address.streetpovinnéstringPovinné. Ulice, nejvýše 128 znaků.
address.houseNumberpovinnéstringPovinné. Číslo domu, nejvýše 32 znaků.
address.citypovinnéstringPovinné. Obec, nejvýše 128 znaků.
address.postalCodepovinnéstringPovinné. PSČ, nejvýše 16 znaků.
address.countrypovinnéstringPovinné. Stát, kód ISO 3166-1 alpha-2, například CZ.
taxResidenciesvolitelnépole SubaccountTaxResidencyBodyNepovinné. Úplný nový seznam daňových rezidencí, aspoň jedna, každý stát nejvýše jednou; nahradí dosavadní. Jen u subúčtu založeného s balíčkem identifikace.
taxResidencies[].countrypovinnéstringPovinné. Stát daňové rezidence, kód ISO 3166-1 alpha-2.
taxResidencies[].tinvolitelnéstringNepovinné. Daňové identifikační číslo v daném státě, nejvýše 64 znaků.

Odpověď

200 · application/json · SubaccountResponse

Chybějící pole zůstávají beze změny; taxResidencies nahrazuje celý seznam.

Adresu a daňové rezidence jde měnit jen u subúčtu založeného s balíčkem identifikace, jinak 409 CLIENT_STATE_INVALID.

Zablokovaný subúčet vrací 409 CLIENT_BLOCKED, ukončený 409 CLIENT_CLOSED, zamítnutý 409 CLIENT_RESTRICTED.

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
externalClientRefstringIdentifikátor klienta ve vašem systému, jak byl uložen při založení.
statusstringStav subúčtu. Hodnoty: review, active, blocked, rejected, closed.
createdAtstringKdy subúčet vznikl, ISO 8601, UTC.
createdAtMsinteger (int64)Stejný okamžik jako Unix timestamp v milisekundách.
activatedAtstring nebo nullKdy byl subúčet naposledy aktivován, ISO 8601, UTC; null, pokud nikdy. Pole je v odpovědi vždy.
activatedAtMsinteger nebo nullStejný okamžik jako Unix timestamp v milisekundách. Případně null.
closedAtstring nebo nullKdy byl subúčet ukončen, ISO 8601, UTC; null, dokud ukončený není. Pole je v odpovědi vždy.
closedAtMsinteger nebo nullStejný okamžik jako Unix timestamp v milisekundách. Případně null.
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.
updatedAtMsinteger (int64)Stejný okamžik jako Unix timestamp v milisekundách.
limitsSubaccountLimitsResponseLimity pokynů vašeho partnerského účtu, které platí pro subúčet.
limits.minOrderAmountApiMoneyNejmenší pokyn v korunách.
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.
limits.minOrderAmount.currencystringKód měny částky, například BTC nebo CZK.
limits.maxOrderAmountApiMoney nebo nullNejvětší pokyn v korunách; null bez horní meze. Pole je v odpovědi vždy.
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.
limits.maxOrderAmount.currencystringKód měny částky, například BTC nebo CZK.
limits.dailyLimitApiMoneyDenní limit pokynů jednoho klienta v korunách.
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.
limits.dailyLimit.currencystringKód měny částky, například BTC nebo CZK.
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í.
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.
limits.dailyLimitRemaining.currencystringKód měny částky, například BTC nebo CZK.
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.
contactSubaccountContactResponseKontakt klienta, jak jste ho poslali.
contact.emailstring nebo nullKontaktní e-mail klienta, nebo null. Pole je v odpovědi vždy.
contact.phonestring nebo nullKontaktní telefon klienta v mezinárodním tvaru, nebo null. Pole je v odpovědi vždy.

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.
404CLIENT_NOT_FOUNDOvěřte externalClientRef včetně velikosti písmen; neexistující, cizí i zamítnutý subúčet vracejí stejnou chybu. Subúčet založte přes POST /v1/subaccounts.
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.
409PARTNER_SUSPENDED, CLIENT_BLOCKED, CLIENT_CLOSED, CLIENT_RESTRICTED, CLIENT_STATE_INVALIDSpolupráce je pozastavená nebo ukončená; kontaktujte Coinero. Čtení dat funguje dál. Subúčet je zablokovaný a měnit ho nejde; čtení funguje dál, důvod Coinero nesděluje. Subúčet je ukončený; čtení funguje dál, zápisy ani nové založení se stejným externalClientRef nejdou. Pro vracejícího se klienta založte subúčet s novým identifikátorem. Subúčet je k posouzení nebo zamítnutý, případně mu obchodování teď nedovoluje Coinero; stav zjistíte přes GET /v1/subaccounts/{externalClientRef}, důvod Coinero nesděluje. Adresu a daňové rezidence jde měnit jen u subúčtu založeného s balíčkem identifikace; nic se nezměnilo.
429RATE_LIMIT_EXCEEDEDPřed dalším pokusem vyčkejte počet sekund z Retry-After.
503PARTNER_BUSY, SERVICE_MAINTENANCEStejný požadavek zopakujte za několik sekund; opakování je bezpečné. Subúčet už mohl vzniknout: opakované založení ho vrátí a dokončí jeho kontroly. Probíhá údržba nebo je dočasně vypnuté obchodování či WebSocket; ověřte GET /v1/status a vyčkejte podle Retry-After.