Přehled API · Obecné

GET /v1/status

Vrací stav API a dostupnost tržních dat.

Související endpointy: GET /v1/tickers, GET /v1/time.

Parametry dotazu

Endpoint nemá parametry dotazu.

Odpověď

application/json · ServiceStatusResponse

Endpoint odpovídá i při výpadku tržních dat nebo plánované údržbě; API klíč a limity platí i zde.

Stav degraded znamená plošný problém: náhradní zdroj pro celý trh, nebo zastaralá data u víc než čtvrtiny párů. Pár, u kterého burza chvíli neposlala aktualizaci, se doplní náhradní cestou dřív, než se za zastaralý považuje, takže stav nemění.

Odpověď se neukládá do cache.

Pole	Popis
statusstring	Během údržby maintenance, jinak nejhorší stav API a jeho komponent. Hodnoty: operational, degraded, outage, maintenance.
apistring	Stav samotného API: operational, během údržby maintenance. Hodnoty: operational, degraded, outage, maintenance.
componentsServiceComponentsResponse	Stavy jednotlivých komponent API.
components.tickerstring	Stav zdroje cen: degraded při náhradním zdroji pro celý trh nebo když je u víc než čtvrtiny párů cena starší než pět minut, outage při zpoždění celého zdroje přes pět minut. Nelikvidní pár, který burza chvíli neaktualizuje, se doplní náhradní cestou dřív a stav nemění. Hodnoty: operational, degraded, outage, maintenance.
maintenanceMaintenanceWindowResponse nebo null	Oznámená údržba, jinak null; pole je vždy přítomné.
maintenance.fromstring	Začátek údržby v ISO 8601, UTC.
maintenance.fromMsinteger (int64)	Stejný okamžik jako Unix timestamp v milisekundách.
maintenance.tostring	Předpokládaný konec údržby v ISO 8601, UTC.
maintenance.toMsinteger (int64)	Stejný okamžik jako Unix timestamp v milisekundách.
maintenance.descriptionstring	Popis údržby v angličtině, jak jej vrací API.
lastUpdatedAtnull nebo string	Poslední aktualizace tržních dat v ISO 8601, UTC; null, pokud stav zdroje není znám. Rozdíl oproti serverTime určuje stáří dat.
lastUpdatedAtMsnull nebo integer	Stejný okamžik jako Unix timestamp v milisekundách, případně null.
serverTimestring	Aktuální čas serveru v ISO 8601, UTC, s milisekundami.
serverTimeMsinteger (int64)	Stejný okamžik jako Unix timestamp v milisekundách.

Hodnoty stavů

Nové hodnoty mohou přibýt i v rámci v1; neznámou hodnotu zpracujte bez selhání.

PublicServiceStatus	Význam
`operational`	plně funkční; hrstka nelikvidních párů dočasně doplňovaná náhradní cestou se sem počítá taky
`degraded`	omezený provoz: náhradní zdroj pro celý trh, nebo pro víc než čtvrtinu párů
`outage`	výpadek nebo příliš stará data
`maintenance`	plánovaná údržba

Chyby

Chyby mají formát application/problem+json; zpracovávejte je podle pole code. Podrobnosti najdete v přehledu chyb.

Stav	Kódy	Řešení
401	MISSING_API_KEY, INVALID_API_KEY	Doplňte hlavičku X-COINERO-APIKEY. Ověřte hodnotu a stav klíče i aktivitu účtu.
405	METHOD_NOT_ALLOWED	Použijte metodu z hlavičky Allow; veřejné API je jen pro čtení, takže GET nebo HEAD.
429	RATE_LIMIT_EXCEEDED	Před dalším pokusem vyčkejte počet sekund z Retry-After.

Polling

Každých 60 s. Při chybách ostatních endpointů stav dočasně kontrolujte častěji s ohledem na limit požadavků.

curl "https://publicapi.coinero.cz/v1/status" \
  -H "X-COINERO-APIKEY: $COINERO_API_KEY"

const response = await fetch(
  "https://publicapi.coinero.cz/v1/status",
  { headers: { "X-COINERO-APIKEY": process.env.COINERO_API_KEY } },
);
const data = await response.json();

import os
import requests

response = requests.get(
    "https://publicapi.coinero.cz/v1/status",
    headers={"X-COINERO-APIKEY": os.environ["COINERO_API_KEY"]},
)
data = response.json()

using System.Net.Http.Json;
using System.Text.Json;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add(
    "X-COINERO-APIKEY",
    Environment.GetEnvironmentVariable("COINERO_API_KEY"));

var data = await client.GetFromJsonAsync<JsonElement>(
    "https://publicapi.coinero.cz/v1/status");

200application/json

{
  "status": "operational",
  "api": "operational",
  "components": {
    "ticker": "operational"
  },
  "maintenance": null,
  "lastUpdatedAt": "2026-09-01T11:59:50.000Z",
  "lastUpdatedAtMs": 1788263990000,
  "serverTime": "2026-09-01T12:00:00.000Z",
  "serverTimeMs": 1788264000000
}

401application/problem+json

{
  "type": "https://developers.coinero.cz/errors/missing-api-key",
  "title": "Missing API key",
  "status": 401,
  "code": "MISSING_API_KEY",
  "detail": "This endpoint requires an API key. Send it in the X-COINERO-APIKEY request header.",
  "requestId": "0HN7GK4L2M9PQ"
}