Přehled API · Tržní data

GET /v1/tickers

Vrací aktuální klientské ceny nákupu a prodeje a statistiky všech párů s dostupnou cenou.

Související endpointy: GET /v1/ticker, GET /v1/markets.

Parametry dotazu

Endpoint nemá parametry dotazu.

Odpověď

application/json · TickersResponse

buyPrice a sellPrice jsou konečné klientské ceny včetně standardního poplatku Coinero (bez individuálních slev) a u CZK včetně měnové přirážky; shodují se s cenami v aplikaci Coinero v okamžiku dotazu, nejsou závaznou nabídkou a obchod se vypořádá za cenu při zadání pokynu. Ostatní cenová pole jsou burzovní statistiky bez poplatku; poplatky se řídí veřejným ceníkem.

Klientské ceny nesou nejméně šest platných číslic, takže u párů s hrubým krokem ceny mají víc desetinných míst než pricePrecision z GET /v1/markets. Všechna cenová pole jednoho páru mají stejný počet míst a ten se může změnit, když cena přejde přes řád; hodnotu proto parsujte jako desetinné číslo a nespoléhejte na délku řetězce. Nezaokrouhlujte ji na krok trhu, ten platí pro cenu pokynu, ne pro cenu z tickeru.

Statistiky za 24 hodin jsou burzovní ceny bez poplatku, takže buyPrice bývá nad high24h a sellPrice pod low24h; u párů v CZK je rozdíl větší o měnovou přirážku a změny v procentech se počítají z ceny v EUR, přes kterou se pár provádí.

U málo obchodovaných párů může být high24h shodná s low24h, protože se za celý den zobchodovala jediná cena, a rozdíl mezi buyPrice a sellPrice bývá řádově větší než u likvidních trhů. Je v něm rozpětí burzy, které u takového páru dosahuje i desítek procent. Není to chyba dat; ceny takového páru berte s rezervou a ověřujte objem ve volume24h.

API vrací poslední dostupný ticker i při zpoždění dat; před použitím ceny ověřte timestamp. Stav dat zjistíte přes GET /v1/status.

Ceník Coinero

Částky a ceny jsou desetinné řetězce, aby nedocházelo ke ztrátě přesnosti. Volitelná pole mohou v odpovědi zcela chybět; nenahrazují se hodnotou null.

Pole	Popis
tickerspole TickerResponse	Tickery obchodovaných párů; vyřazené páry a páry bez dostupné ceny (bez tickeru nebo bez kurzu) chybí, proto může být seznam kratší než GET /v1/markets.
tickers[].symbolstring	Symbol páru: základní a kotovací měna bez oddělovače, například BTCEUR.
tickers[].basestring	Kód základní měny, například BTC.
tickers[].quotestring	Kód kotovací měny. Kromě EUR a CZK Coinero kotuje páry i v BTC, ETH a USDC. Páry v CZK Coinero kotuje v CZK a na burze provádí přes EUR; převod je už součástí cen z GET /v1/ticker.
tickers[].buyPricestring	Konečná cena za jednotku základní měny při okamžitém nákupu na Coinero, včetně poplatku Coinero a u interně převáděných měn (CZK) včetně měnové přirážky; v kotovací měně, jako desetinný řetězec s nejméně šesti platnými číslicemi, takže u párů s hrubým krokem ceny nese víc desetinných míst než pricePrecision. Počet míst je společný pro všechna cenová pole páru. Stejná hodnota, jakou aplikace Coinero zobrazuje jako cenu nákupu.
tickers[].sellPricestring	Konečná cena za jednotku základní měny při okamžitém prodeji na Coinero, včetně poplatku Coinero a u interně převáděných měn (CZK) včetně měnové přirážky; v kotovací měně, jako desetinný řetězec se stejným počtem desetinných míst jako buyPrice.
tickers[].high24hstring	Nejvyšší burzovní cena za 24 hodin bez poplatku, v kotovací měně, jako desetinný řetězec; u interně převáděných měn přepočtená středovým kurzem.
tickers[].low24hstring	Nejnižší burzovní cena za 24 hodin bez poplatku, v kotovací měně, jako desetinný řetězec; u interně převáděných měn přepočtená středovým kurzem.
tickers[].volume24hstring	Zobchodovaný objem na burze za 24 hodin v základní měně, jako desetinný řetězec.
tickers[].vwap24hvolitelnéstring	Objemově vážená průměrná burzovní cena za 24 hodin (VWAP) bez poplatku, v kotovací měně, jako desetinný řetězec; chybí, pokud ji zdroj neposkytuje.
tickers[].priceChangePercent1hvolitelnéstring	Změna ceny za hodinu v procentech, jako desetinný řetězec; "0.21" znamená 0,21 %. Chybí, pokud ji zdroj neposkytuje.
tickers[].priceChangePercent24hvolitelnéstring	Změna ceny za 24 hodin v procentech, jako desetinný řetězec; chybí, pokud ji zdroj neposkytuje.
tickers[].priceChangePercent7dvolitelnéstring	Změna ceny za 7 dní v procentech, jako desetinný řetězec; chybí, pokud ji zdroj neposkytuje.
tickers[].timestampstring	Čas pořízení tickeru v ISO 8601, UTC, s milisekundami.
tickers[].timestampMsinteger (int64)	Stejný okamžik jako Unix timestamp v milisekundách.

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.
503	MARKET_DATA_UNAVAILABLE, SERVICE_MAINTENANCE	Data dočasně chybí; vyčkejte počet sekund z Retry-After a požadavek zopakujte. Probíhá údržba; ověřte GET /v1/status a vyčkejte podle Retry-After.

Polling

Každých 5 s. Jedním voláním získáte ceny všech párů; při sledování více párů použijte tento endpoint místo opakovaných volání /v1/ticker.

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

const response = await fetch(
  "https://publicapi.coinero.cz/v1/tickers",
  { 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/tickers",
    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/tickers");

{
  "tickers": [
    {
      "symbol": "BTCEUR",
      "base": "BTC",
      "quote": "EUR",
      "buyPrice": "99418.84",
      "sellPrice": "97445.70",
      "high24h": "99120.00",
      "low24h": "97010.00",
      "volume24h": "128.34567890",
      "vwap24h": "98301.44",
      "priceChangePercent1h": "0.21",
      "priceChangePercent24h": "1.84",
      "priceChangePercent7d": "-3.02",
      "timestamp": "2026-09-01T11:59:50.000Z",
      "timestampMs": 1788263990000
    },
    {
      "symbol": "BTCCZK",
      "base": "BTC",
      "quote": "CZK",
      "buyPrice": "2510123.45",
      "sellPrice": "2411870.90",
      "high24h": "2478000.00",
      "low24h": "2425250.00",
      "volume24h": "128.34567890",
      "timestamp": "2026-09-01T11:59:50.000Z",
      "timestampMs": 1788263990000
    },
    {
      "symbol": "VANRYEUR",
      "base": "VANRY",
      "quote": "EUR",
      "buyPrice": "0.000707000",
      "sellPrice": "0.000475200",
      "high24h": "0.000710000",
      "low24h": "0.000430000",
      "volume24h": "18422965.10000000",
      "timestamp": "2026-09-01T11:59:50.000Z",
      "timestampMs": 1788263990000
    }
  ]
}

{
  "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"
}