Získat API klíč
Obchodní API

Stav služby

Jak číst GET /v1/status: komponenty, jejich hodnoty a pravidlo, podle kterého se skládá souhrn.

Dvě místa se stavem.

GET /v1/status ukazuje stav tržních dat a brány z pohledu API a vyžaduje klíč. Provoz Coinera jako celku, včetně aplikace, sleduje veřejná stránka stavu, která běží mimo naši infrastrukturu.

Odpověď

Pole status je souhrn, api stav samotné aplikace (operational nebo maintenance) a components obsahuje stav šesti komponent. Pole maintenance popisuje ohlášenou odstávku, jinak je null, a lastUpdatedAt je čas poslední aktualizace tržních dat, nebo null, když stav dat neznáme.

Hodnoty

HodnotaVýznam
operationalplně funkční; hrstka nelikvidních párů dočasně doplňovaná náhradní cestou se sem počítá taky
degradedomezený provoz: náhradní zdroj pro celý trh, nebo pro víc než čtvrtinu párů
outagevýpadek nebo příliš stará data
maintenanceplánovaná údržba
disabledkomponenta je vypnutá konfigurací, ne porouchaná; celkový stav nikdy nesnižuje

Komponenty

KomponentaCo popisujedegradedoutage
tickerCenová data, ze kterých čtou GET /v1/ticker, GET /v1/tickers a odhad pokynu.Data chodí náhradní cestou s delší latencí, nebo jsou zastaralá víc než u čtvrtiny párů.Stav dat neznáme, nebo je poslední aktualizace starší než 5 minut.
depthKniha pokynů, GET /v1/depth.Jako u tickeru.Jako u tickeru, a navíc výpadek odběru knih: snímky platí 30 s, takže endpoint vrací 503.
tradesVeřejné obchody, GET /v1/trades.Jako u tickeru, a navíc výpadek odběru obchodů: poslední obchody zůstávají k dispozici, ale nové nepřibývají.Jako u tickeru.
ohlcSvíčky, GET /v1/ohlc.Jako u tickeru.Jako u tickeru.
streamWebSocket brána /v1/ws.Neběží odběr některého ze zdrojů dat streamu. Spojení zůstávají a dostávají snapshot, ale updaty nemusí chodit.Komponenta tuto hodnotu nenabývá.
subaccountsPartnerská část API: subúčty, pokyny za subúčet, report a webhooky (jen pro partnery).Obchodování přes API je vypnuté nebo nemá spojení na zpracování pokynů: pokyny nejdou, čtení a aktivace subúčtů ano.Komponenta tuto hodnotu nenabývá.
  • Komponenty depth, trades a ohlc mají hodnotu disabled, když Coinero referenční tržní data provozně vypne. Komponenta stream je disabled, když je brána vypnutá, a maintenance v ohlášené údržbě. Kanály book a trades streamu se zapínají spolu s endpointy. Jejich vypnutí hlásí komponenty depth a trades, ne stream.
  • Komponenta subaccounts je maintenance při odstávce API nebo při vypnuté partnerské části (zápisové endpointy partnerů pak vracejí 503 SERVICE_MAINTENANCE) a jinak operational nebo degraded. Hodnotu disabled nenabývá.
  • Počet otevřených spojení WebSocketu se nevydává.

Souhrn

Souhrn status je nejhorší stav z pole api a z komponent, s těmito pravidly:

  • Ohlášená odstávka (api: maintenance) přebíjí všechno: souhrn je maintenance. Klient má čekat do konce okna, ne hlásit incident.
  • Komponenty disabled a maintenance se do souhrnu nepočítají. Vypnutá komponenta není porucha.
  • ticker se do souhrnu počítá plně, i ve stavu outage. Bez cen se obchodovat nedá.
  • Komponenty depth, trades, ohlc a stream zhorší souhrn nejvýš na degraded. Jejich outage se v souhrnu zobrazí jako degraded, aby váš robot nepřestal obchodovat kvůli referenčním datům nebo streamu, které k obchodování nepotřebuje.
  • Komponenta subaccounts souhrn nejvýš zhorší na degraded. Její maintenance souhrn nemění, protože klientská část API běží: souhrn maintenance určuje jen pole api.

Partneři: kdo komponentu sleduje.

Komponentu subaccounts doporučujeme číst v aplikaci partnera a podle ní vypínat zadávání pokynů. Při degraded pokyny neposílejte, čtení a aktivace subúčtů běží. Při maintenance nevolejte zápisy; při odstávce celého API (pole api) vrací 503 i čtení. Plánované okno odstávky nese pole maintenance (from, to, description); partneři s webhooky ho dostanou navíc událostmi service.maintenance a service.resumed. Postup viz Pokyny za subúčet.

Co číst, když něco hlídáte.

Obchodující robot sleduje status a komponentu ticker. Graf nebo analýza čte komponenty depth, trades a ohlc. Klient, který odebírá WebSocket, sleduje stream. Doporučený interval dotazování je 60 s, viz Limity požadavků.