Získat API klíč
Další informace

Changelog

Změny kontraktu veřejného API od verze 1.1, od nejnovější. Každá změna kontraktu přibude sem.

Jak číst verze.

Číslo verze označuje vydání rozšíření kontraktu a dokumentace v rámci řady /v1; adresa API se s ním nemění. Změny v řadě /v1 jsou kompatibilní: nové pole, nová hodnota uzavřené množiny, nový endpoint nebo nepovinný parametr. Klient proto musí ignorovat neznámá pole a zpracovat neznámé hodnoty bez selhání.

Verze 1.2

27. 10. 2026 až 21. 11. 2026
  • 21. 11. 2026Změněno

    Specifikace OpenAPI je nově ve verzi 3.1.2 (dříve 3.1.1) a skupiny endpointů jsou v ní seřazené abecedně. Endpointy, pole, chybové kódy ani chování API se nemění, generované klienty není potřeba upravovat.

  • 11. 11. 2026Změněno

    Zadání pokynu (POST /v1/orders) nově vrací 409 CONCURRENT_UPDATE, když zůstatek účtu ve stejném okamžiku změní jiná operace, například jiný pokyn nebo vklad. Dřív v takovém případě vracelo obecnou chybu 500. Pokyn nevznikl a požadavek je bezpečné zopakovat, se stejným clientOrderId, pokud jste ho poslali. Text detail u CONCURRENT_UPDATE je nově obecný (pokyn nebo účet).

    Obchodování
  • 28. 10. 2026Změněno

    Po změně nebo obnovení hesla a po resetu dvoufázového ověření (i když ho na vaši žádost vypne podpora Coinera) Coinero všechny klíče účtu automaticky zruší, když si dvoufázové ověření vypnete sami, zruší klíče s oprávněním account nebo trade. Zrušený klíč vrací 401 INVALID_API_KEY a otevřená spojení WebSocketu se zavřou kódem 1008. O zrušení přijde e-mail; vydejte si nové klíče. Endpointy ani pole se nemění.

    API klíče
  • 28. 10. 2026Přidáno

    Nová událost webhooku report.daily.ready oznámí, že je denní report za předchozí den po uzávěrce hotový. Přijde za každý den, i bez pokynů a plateb, a pole data nese date, closesAt, closesAtMs, ordersCount, paymentsCount a hasStatement. Po události stáhněte GET /v1/reports/daily a výsledek kontroly pošlete do 8:00. U cíle webhooků ji zapne Coinero na vaši žádost.

    Denní report
  • 28. 10. 2026Změněno

    Uzávěrka denního reportu se posouvá z 8:00 na 3:00 pražského času následujícího dne, aby byl report hotový dlouho před ranní kontrolou. Od uzávěrky je report konečný (final) a jde k němu poslat výsledek kontroly; přesný okamžik je vždy v poli closesAt, takže na pevný čas nespoléhejte. Pole ani chování endpointů se jinak nemění.

    Denní report
  • 28. 10. 2026Přidáno

    Zůstatky účtu (GET /v1/account/balances, GET /v1/subaccounts/{externalClientRef}/account/balances a kanál balances WebSocketu) mají nová pole staked s částkou ve stakingu a totalOwned (total plus staked). Seznam nově obsahuje i měnu, kterou máte jen ve stakingu, s nulovým available, held i total. Hodnoty dosavadních polí se nemění, total dál nezahrnuje staking. Staking se přes API jen čte, zahájit ani ukončit ho nelze.

    Účet
  • 28. 10. 2026Přidáno

    Nový endpoint DELETE /v1/subaccounts/{externalClientRef} ukončí subúčet, když klient službu ukončil. Jde to jen bez otevřených a nevypořádaných pokynů a bez pozic a zůstatku (jinak 409 CLIENT_HAS_OPEN_ORDERS nebo CLIENT_HAS_POSITIONS); opakování je bezpečné. Ukončený subúčet má nový stav closed, je konečný a dál čitelný, zápisy i založení se stejným externalClientRef vracejí 409 CLIENT_CLOSED. Objekt subúčtu má nové pole closedAt a closedAtMs, filtr status seznamu subúčtů přijímá closed a přibyla událost webhooku subaccount.closed (u cíle webhooků ji zapne Coinero na vaši žádost).

    Aktivace subúčtu
  • 28. 10. 2026Změněno

    Popisy partnerské části ve specifikaci jsou sjednocené a ukázky používají neutrální hodnoty: kód partnera ABCD, číslo pokynu ABCD-0000001234, externalClientRef client-0001234 a clientOrderId order-2026-10-24-0001. Chování API, pole ani chybové kódy se nemění.

    Subúčty pro partnery
  • 28. 10. 2026Přidáno

    Nový endpoint GET /v1/subaccounts vrací subúčty vašeho partnerského účtu podle času poslední změny od nejnovější, kurzorově (items, nextCursor, hasMore, limit), s filtry status a updatedAfter. Položka je týž objekt jako detail subúčtu a seznam obsahuje i zamítnuté subúčty, takže po výpadku webhooků sladíte stavy se svou evidencí. Objekt subúčtu (detail, seznam, založení, změna i události webhooků subaccount.*) má nové pole updatedAt a updatedAtMs s časem poslední změny; nejnovější přečtená hodnota je updatedAfter dalšího čtení.

    GET /v1/subaccounts
  • 28. 10. 2026Změněno

    Specifikace nově uvádí povinná pole těl subúčtů v seznamu required (POST /v1/subaccounts a vnořené bloky kyc, consents a profile). Chování API se nemění: chybějící povinné pole dál vrací 400 INVALID_PARAMETER s názvem pole. Popis každého pole začíná údajem, zda je povinné, nepovinné, nebo podmíněně povinné.

    POST /v1/subaccounts
  • 28. 10. 2026Přidáno

    Sandbox pro partnery: testovací partner na testovacím prostředí, hlavička X-COINERO-TEST-SCENARIO na zadání a potvrzení pokynu se scénáři reject-market, partial-fill, delayed-fill, timeout a missing-payment (neznámá hodnota je 400 UNKNOWN_TEST_SCENARIO), simulované platby a reset subúčtu.

    Sandbox
  • 28. 10. 2026Přidáno

    Stav služby a údržba pro partnery: komponenta subaccounts v GET /v1/status. Při vypnuté partnerské části vrací zápisové endpointy partnerů HTTP 503 SERVICE_MAINTENANCE s Retry-After, čtení, report a webhooky běží dál. Nové události webhooků service.maintenance a service.resumed ohlašují údržbu předem. Zápisy pozastaveného partnera vrací 409 PARTNER_SUSPENDED.

    Stav služby
  • 28. 10. 2026Přidáno

    Denní report partnera GET /v1/reports/daily v JSON nebo CSV (pražský den, uzávěrka v 8:00 následujícího dne) a povinný výsledek kontroly POST /v1/reports/daily/{date}/result.

    Denní report
  • 28. 10. 2026Přidáno

    Webhooky partnera: podepsané události o pokynech, subúčtech a službě (HMAC-SHA256 nad timestamp a tělem), opakování po 1, 5, 15 a 60 minutách a pak po 2 hodinách do 24 hodin, GET /v1/webhooks/deliveries a POST /v1/webhooks/test.

    Webhooky
  • 28. 10. 2026Přidáno

    Pokyny za subúčet: POST /v1/subaccounts/{externalClientRef}/orders a …/orders/{orderId}/confirm, ověření pokynu, dvoufázový nákup s potvrzením blokace a ochrannou mezí ceny, prodej celé pozice (sellAll), blok partner v objektu pokynu a seznam pokynů všech subúčtů GET /v1/subaccounts/orders.

    Pokyny za subúčet
  • 28. 10. 2026Změněno

    Stav pokynu pendingConfirmation a důvody zamítnutí a zrušení priceMoved a blockTimeout rozšiřují uzavřené množiny PublicOrderStatus a PublicOrderRejectionReason. Hodnoty se objevují jen u pokynů subúčtů; klientský účet je nevidí, neznámé hodnoty ale zpracovávejte bez selhání.

    Obchodování
  • 27. 10. 2026Přidáno

    Převzatá identifikace a automatická aktivace subúčtu: bloky kyc, consents a profile v POST /v1/subaccounts (všechny tři, nebo žádný) a PUT /v1/subaccounts/{externalClientRef} pro změnu kontaktu, adresy a daňových rezidencí.

    Aktivace subúčtu
  • 27. 10. 2026Přidáno

    Subúčty partnera pod prefixem /v1/subaccounts/{externalClientRef}: založení, detail, pozice, zůstatky, obchody a pokyny. Zůstatky, obchody a pokyny jsou tytéž objekty jako u klientského účtu.

    Subúčty pro partnery
  • 27. 10. 2026Přidáno

    Partnerský API klíč (pk_live_, pk_prev_, pk_dev_) s oprávněním market a subaccounts, povinným seznamem IP adres, rotací s odkladem 24 hodin a vlastními limity 600 požadavků a 300 pokynů za minutu. Nové oprávnění subaccounts nemá klientský klíč.

    Klíč partnera

Verze 1.1

27. 10. 2026 až 27. 10. 2026
  • 27. 10. 2026Změněno

    Limit zadání pokynů se zvyšuje z 20 na 60 za minutu na klíč. Pevné minutové okno a hlavičky X-RateLimit-Order-* zůstávají.

    Limity požadavků
  • 27. 10. 2026Přidáno

    Referenční tržní data GET /v1/depth, GET /v1/trades a GET /v1/ohlc se zapínají na testovacím i ostrém prostředí. Vypnutá odpovídají 404 NOT_FOUND, zapnutá 200; stav ukazují komponenty depth, trades a ohlc ve stavu služby.

    Tržní data
  • 27. 10. 2026Odstraněno

    Zrušen GET /v1/orders/quote. Jediný nezávazný náhled pokynu je POST /v1/orders/validate; jeho odpověď nese odhad pokynu v objektu estimate.

    POST /v1/orders/validate
  • 27. 10. 2026Přidáno

    Obchodní API: oprávnění account a trade, podpis požadavků (HMAC-SHA256), zůstatky, obchody, vklady a výběry účtu, ověření, zadání, čtení a zrušení pokynů s idempotencí podle clientOrderId, omezení klíče na IP adresy, expirace klíče, referenční tržní data a WebSocket brána /v1/ws.

    Obchodování

Změna, která kompatibilní není, se nedělá v /v1, ale jako nová verze v cestě.