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.
FORBIDDEN); stavy pokynů sledujete webhooky nebo dotazováním.Co je pro partnery navíc
| Téma | Co platí pro partnera | Strá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í klienta | POST /v1/subaccounts, volitelně s převzatou identifikací klienta (bloky kyc, consents, profile) a automatickou aktivací. | Aktivace subúčtu |
| Pokyny | Jen 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 |
| Webhooky | Podepsané události o pokynech, subúčtech a službě na váš HTTPS cíl. | Webhooky |
| Denní report | Pokyny a platby za pražský den v JSON nebo CSV a povinný výsledek vaší kontroly. | Denní report |
| Sandbox | Testovací partner na testovacím prostředí se scénáři v hlavičce a simulovanými platbami. | Sandbox |
| Stav a limity | Komponenta 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/depositsa…/account/withdrawalspod prefixem neexistují (HTTP 404NOT_FOUND). - Tržní pokyn se ručně neruší:
DELETE …/orders/{orderId}vrací HTTP 405METHOD_NOT_ALLOWED. Nepotvrzený nákup zruší po lhůtě systém. - Identifikátor
ordersnelze použít jakoexternalClientRef: cesta/v1/subaccounts/ordersje 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
Získejte partnerský klíč
Klíč vydá Coinero na vaši žádost. Postup a pravidla jsou na stránce Klíč partnera.
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é.
Zakládejte subúčty
POST /v1/subaccounts je idempotentní podle
externalClientRef. Se převzatou identifikací je subúčet aktivní hned, jinak ho aktivuje Coinero.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.
Sledujte stavy
Webhooky jsou doporučená cesta, GET /v1/subaccounts/orders je plnohodnotná záloha.
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ód | Stav | Kdy |
|---|---|---|
CLIENT_NOT_FOUND | 404 | Subúčet s tímto identifikátorem klienta partner nemá. |
CLIENT_REF_CONFLICT | 409 | Partner už má subúčet s identifikátorem lišícím se jen velikostí písmen. |
CLIENT_RESTRICTED | 409 | Subúčet v tomto stavu nejde měnit ani s ním obchodovat. |
CLIENT_BLOCKED | 409 | Subúčet je zablokovaný, nejde měnit ani s ním obchodovat. |
CLIENT_STATE_INVALID | 409 | Subúčet tuto změnu nepovoluje. |
PARTNER_SUSPENDED | 409 | Partnerský účet je pozastavený nebo ukončený. |
PARTNER_BUSY | 503 | Coinero právě zpracovává jiné požadavky vašeho partnerského účtu. |
CONCURRENT_UPDATE | 409 | Pokyn nebo zůstatek účtu ve stejnou chvíli změnil jiný požadavek. |
WEBHOOK_NOT_CONFIGURED | 409 | Partnerský účet nemá cíl webhooků, zkušební událost nemá kam jít. |
UNKNOWN_TEST_SCENARIO | 400 | Hlavič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.