Získat API klíč
Subúčty (partneři)

Subúčty pro partnery

Partner obchoduje za své klienty přes subúčty. Dokumentace je jedna pro všechny: tato sekce popisuje jen to, co je pro partnery navíc.

Co platí beze změny.

Podpis požadavků, Účet, Obchodování a Tržní data platí pro partnery stejně: stejné hlavičky, stejný podpis, stejné objekty zůstatků, obchodů a pokynů, stejný formát chyb. Pod prefixem subúčtu běží tytéž endpointy jako pro klientský účet, jen s identitou subúčtu z cesty. WebSocket partnerský klíč nepřijímá (handshake vrací HTTP 403 FORBIDDEN); stavy pokynů sledujete webhooky nebo dotazováním.

Co je pro partnery navíc

TémaCo platí pro partneraStránka
KlíčPartnerský klíč pk_live_, pk_prev_ nebo pk_dev_ s oprávněním market a subaccounts. Vydává ho Coinero na vaši žádost, seznam IP adres je povinný. Vzájemné TLS (klientský certifikát partnera) zapíná Coinero na partnerských cestách v produkci na vaši žádost; klíč, podpis požadavků a seznam povolených IP adres platí vždy, mTLS je doplněk po dohodě.Klíč partnera
AdresováníSubúčet klienta určuje externalClientRef v cestě: /v1/subaccounts/{externalClientRef}/…. Hlavička se k tomu nepoužívá, protože podpis kryje cestu a tělo, ne hlavičky.Aktivace subúčtu
Založení klientaPOST /v1/subaccounts, volitelně s převzatou identifikací klienta (bloky kyc, consents, profile) a automatickou aktivací.Aktivace subúčtu
PokynyJen tržní pokyny, clientOrderId povinné, nákup částkou, prodej množstvím nebo celou pozicí (sellAll), blok partner v pokynu a dvoufázový nákup se stavem pendingConfirmation a potvrzením blokace.Pokyny za subúčet
WebhookyPodepsané události o pokynech, subúčtech a službě na váš HTTPS cíl.Webhooky
Denní reportPokyny a platby za pražský den v JSON nebo CSV a povinný výsledek vaší kontroly.Denní report
SandboxTestovací partner na testovacím prostředí se scénáři v hlavičce a simulovanými platbami.Sandbox
Stav a limityKomponenta subaccounts ve stavu služby, vlastní limity 600 požadavků a 300 pokynů za minutu.Stav služby

Endpointy pod prefixem subúčtu

Zůstatky, obchody, pokyny a ověření pokynu mají pod prefixem stejné objekty a stejná pravidla jako klientský účet. Dokumentace jejich polí a chyb je v přehledu API ve skupinách Subúčty, Webhooky a Reporty.

  • GET …/account/balances a GET …/account/trades vracejí tytéž objekty jako GET /v1/account/balances a GET /v1/account/trades.
  • Vklady a výběry subúčet nemá: …/account/deposits a …/account/withdrawals pod prefixem neexistují (HTTP 404 NOT_FOUND).
  • Tržní pokyn se ručně neruší: DELETE …/orders/{orderId} vrací HTTP 405 METHOD_NOT_ALLOWED. Nepotvrzený nákup zruší po lhůtě systém.
  • Identifikátor orders nelze použít jako externalClientRef: cesta /v1/subaccounts/orders je seznam pokynů všech subúčtů.
  • Subúčet, který neexistuje, patří jinému partnerovi nebo byl zamítnut, vrací při čtení HTTP 404 CLIENT_NOT_FOUND, nikdy 403: existence cizích subúčtů se neprozrazuje.

Pořadí integrace

  1. Získejte partnerský klíč

    Klíč vydá Coinero na vaši žádost. Postup a pravidla jsou na stránce Klíč partnera.

  2. Vyzkoušejte sandbox

    Na testovacím prostředí funguje sandbox s testovacími scénáři. Pokyny se tam neposílají na burzu, ale procházejí stejným vypořádáním jako ostré.

  3. Zakládejte subúčty

    POST /v1/subaccounts je idempotentní podle externalClientRef. Se převzatou identifikací je subúčet aktivní hned, jinak ho aktivuje Coinero.

  4. Zadávejte a potvrzujte pokyny

    Zadáte nákup, ve svém systému klientovi zablokujete peníze a nákup do lhůty potvrdíte. Podrobnosti viz Pokyny za subúčet.

  5. Sledujte stavy

    Webhooky jsou doporučená cesta, GET /v1/subaccounts/orders je plnohodnotná záloha.

  6. Kontrolujte denní report

    Každý den porovnejte denní report se svou evidencí a odešlete výsledek.

Chyby

Chyby mají stejný formát jako zbytek API (Chyby). Kromě kódů v tabulce platí i obecné kódy, například INVALID_PARAMETER a SERVICE_MAINTENANCE.

KódStavKdy
CLIENT_NOT_FOUND404Subúčet s tímto identifikátorem klienta partner nemá.
CLIENT_REF_CONFLICT409Partner už má subúčet s identifikátorem lišícím se jen velikostí písmen.
CLIENT_RESTRICTED409Subúčet v tomto stavu nejde měnit ani s ním obchodovat.
CLIENT_BLOCKED409Subúčet je zablokovaný, nejde měnit ani s ním obchodovat.
CLIENT_STATE_INVALID409Subúčet tuto změnu nepovoluje.
PARTNER_SUSPENDED409Partnerský účet je pozastavený nebo ukončený.
PARTNER_BUSY503Coinero právě zpracovává jiné požadavky vašeho partnerského účtu.
CONCURRENT_UPDATE409Pokyn nebo zůstatek účtu ve stejnou chvíli změnil jiný požadavek.
WEBHOOK_NOT_CONFIGURED409Partnerský účet nemá cíl webhooků, zkušební událost nemá kam jít.
UNKNOWN_TEST_SCENARIO400Hlavička X-COINERO-TEST-SCENARIO sandboxu nese hodnotu, kterou sandbox nezná.

Chyby zadání a potvrzení pokynu jsou na stránce Pokyny za subúčet.