Přehled API · Tržní data

GET /v1/ticker

Vrací aktuální klientské ceny nákupu a prodeje a statistiky jednoho obchodního páru.

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

Parametry dotazu

Parametr	Popis
symbolpovinnéstring	Základní a kotovací měna bez oddělovače, například BTCEUR; velikost písmen nerozhoduje. Použijte pár z GET /v1/markets se stavem jiným než delisted.

Odpověď

application/json · TickerResponse

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
symbolstring	Symbol páru: základní a kotovací měna bez oddělovače, například BTCEUR.
basestring	Kód základní měny, například BTC.
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.
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.
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.
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.
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.
volume24hstring	Zobchodovaný objem na burze za 24 hodin v základní měně, jako desetinný řetězec.
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.
priceChangePercent1hvolitelnéstring	Změna ceny za hodinu v procentech, jako desetinný řetězec; "0.21" znamená 0,21 %. Chybí, pokud ji zdroj neposkytuje.
priceChangePercent24hvolitelnéstring	Změna ceny za 24 hodin v procentech, jako desetinný řetězec; chybí, pokud ji zdroj neposkytuje.
priceChangePercent7dvolitelnéstring	Změna ceny za 7 dní v procentech, jako desetinný řetězec; chybí, pokud ji zdroj neposkytuje.
timestampstring	Čas pořízení tickeru v ISO 8601, UTC, s milisekundami.
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í
400	INVALID_PARAMETER	Opravte parametry uvedené v detail podle dokumentace.
401	MISSING_API_KEY, INVALID_API_KEY	Doplňte hlavičku X-COINERO-APIKEY. Ověřte hodnotu a stav klíče i aktivitu účtu.
404	UNKNOWN_SYMBOL, NOT_FOUND	Vyberte pár se stavem trading nebo paused z GET /v1/markets; neznámý i vyřazený pár vrací 404 a pole detail je od sebe odliší. Ověřte cestu a požadovaný zdroj; opakování stejného požadavku nepomůže.
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. Každý sledovaný pár spotřebuje 12 požadavků za minutu; pro více párů použijte /v1/tickers.

curl "https://publicapi.coinero.cz/v1/ticker?symbol=BTCEUR" \
  -H "X-COINERO-APIKEY: $COINERO_API_KEY"

const response = await fetch(
  "https://publicapi.coinero.cz/v1/ticker?symbol=BTCEUR",
  { 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/ticker",
    params={"symbol": "BTCEUR"},
    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/ticker?symbol=BTCEUR");

200application/json

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

404application/problem+json

{
  "type": "https://developers.coinero.cz/errors/unknown-symbol",
  "title": "Unknown symbol",
  "status": 404,
  "code": "UNKNOWN_SYMBOL",
  "detail": "The requested symbol is not listed on Coinero. Fetch the list of traded symbols from GET /v1/markets.",
  "requestId": "0HN7GK4L2M9PQ"
}