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

Klíč partnera

Partnerský klíč patří partnerovi, ne klientovi. Vydává ho Coinero a slouží k práci se subúčty vašich klientů.

Dva druhy klíčů

VlastnostKlientský klíčPartnerský klíč
Prefixck_live_, ck_prev_, ck_dev_pk_live_, pk_prev_, pk_dev_
Kdo ho vydáváKlient v aplikaci CoineroCoinero na žádost partnera
Oprávněnímarket, account, trademarket, subaccounts
Seznam IP adresVolitelnýPovinný (alespoň jedna adresa nebo rozsah)
S čím pracujeS účtem klientaSe subúčty klientů partnera pod /v1/subaccounts, s reporty a webhooky
WebSocketAnoNe, handshake vrací HTTP 403 FORBIDDEN

Do hlavičky X-COINERO-APIKEY patří celý klíč. Podpis požadavků je stejný jako u klientského klíče, viz Podpis požadavků: HMAC-SHA256 se secretem klíče nad timestamp + METHOD + path + body, okno ±30 sekund a stejné chyby SIGNATURE_REQUIRED, INVALID_SIGNATURE a TIMESTAMP_OUT_OF_WINDOW.

Oprávnění

OprávněníCo dovolujePodpis
marketTržní data a stav API bez prefixu: GET /v1/ticker, GET /v1/markets a další, viz Tržní data.Ne
subaccountsVšechno pod /v1/subaccounts, /v1/reports a /v1/webhooks.Ano, vždy

Partnerský klíč nikdy nemá oprávnění account ani trade: endpointy klientského účtu a pokynů (/v1/account/…, /v1/orders…) vrací HTTP 403 INSUFFICIENT_PERMISSION. Opačně klientský klíč nemá subaccounts a partnerské endpointy odmítne stejným kódem. Zůstatky a pokyny klienta čtete a zadáváte vždy pod prefixem subúčtu.

Vydání

  • Klíč vydává Coinero na vaši žádost. API klíče nevydává ani nemění.
  • Klíč a secret se zobrazí jen jednou, hned po vydání. Secret slouží k podpisu požadavků, uložte ho na serveru.
  • Klíč nejde vydat bez seznamu IP adres. Zadává se nejvýš 10 adres nebo rozsahů v zápisu CIDR (IPv4 i IPv6) stejně jako u klientského klíče, viz Oprávnění a životnost klíče. Požadavek z adresy mimo seznam dostane HTTP 403 IP_NOT_ALLOWED.
  • Platnost může být omezená datem expirace. Po okamžiku expirace klíč přestane platit a API vrací HTTP 401 INVALID_API_KEY. E-mailovou připomínku expirace Coinero partnerovi neposílá. Datum expirace si poznamenejte při vydání klíče.

Klíč ověřený, zápisy zastavené.

Klíč pozastaveného partnera se ověří, ale zápisy (založení a změna subúčtu, zadání a potvrzení pokynu) vrací HTTP 409 PARTNER_SUSPENDED; čtení a odeslání výsledku denní kontroly zůstávají. Klíč partnera s ukončenou spoluprací se neověří (401).

Vzájemné TLS

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

Rotace

Rotaci provádí Coinero na vaši žádost. Vydá nový klíč se stejným názvem, seznamem adres a expirací a starý klíč buď zruší hned, nebo ho nechá platit dalších 24 hodin, abyste stihli přepnout své systémy. Odklad platnost nikdy neprodlouží, jen ji zkrátí, takže starému klíči s dřívější expirací platí ta dřívější. Klíč, který už byl rotovaný, se znovu rotovat nedá; další rotace vychází z nového klíče.

Zrušení

Klíč ruší Coinero, například na vaši žádost. Zrušení je nevratné a klíč přestane platit okamžitě, výjimečně nejpozději do minuty. Zrušený klíč vrací HTTP 401 INVALID_API_KEY.

Limity

Partnerský klíč má vlastní počítadla: 600 požadavků a 300 pokynů za minutu. Podrobnosti jsou na stránce Limity požadavků.

Chyby

KódStavKdy
INVALID_API_KEY401Zadaný API klíč nelze použít.
SIGNATURE_REQUIRED401Požadavek na endpoint s podpisem nemá hlavičky podpisu.
INVALID_SIGNATURE401Podpis požadavku nesouhlasí s tím, co server vypočítal.
TIMESTAMP_OUT_OF_WINDOW401Časová značka v hlavičce X-COINERO-TIMESTAMP je příliš daleko od času serveru.
IP_NOT_ALLOWED403Požadavek přišel z adresy, která není na seznamu povolených adres klíče.
INSUFFICIENT_PERMISSION403Klíč nemá oprávnění, které endpoint vyžaduje.
PARTNER_SUSPENDED409Partnerský účet je pozastavený nebo ukončený.