Začínáme

Autentizace

Každý požadavek na API vyžaduje API klíč v hlavičce X-COINERO-APIKEY.

Odeslání klíče

Klíč posílejte v hlavičce X-COINERO-APIKEY u všech požadavků na API. Kořenová cesta, /health, /alive a OpenAPI specifikace klíč nevyžadují. Pro kořenovou cestu a specifikaci platí limity podle IP adresy.

Klíč nevkládejte do URL: mohl by se uložit do logů, historie prohlížeče nebo hlavičky Referer.

API nepovoluje volání z cizích stránek v prohlížeči (CORS), takže požadavek z frontendu neprojde ani s platným klíčem. Je to záměr: klíč vložený do stránky si přečte kdokoli, kdo si zobrazí její zdrojový kód. Volejte API ze serveru a klientovi posílejte až výsledek.

Vytvoření a správa klíčů

Klíče vytvářejte a rušte v sekci Profil a zabezpečení v aplikaci Coinero. Fungují pouze u aktivního účtu; při úniku klíč ihned zrušte.

Při vytvoření získáte klíč a secret a oba se zobrazí jen jednou. Do hlavičky X-COINERO-APIKEY patří klíč, tedy hodnota začínající ck_. Secret současné veřejné API nepoužívá; uschovejte si jej pro budoucí endpointy, které budou vyžadovat podpis požadavku.

API klíč uchovávejte na serveru.

Načítejte jej z proměnné prostředí a neposílejte jej do JavaScriptu v prohlížeči.

Chyby autentizace

Při chybě autentizace API vrací HTTP 401 s jedním z následujících kódů. Konkrétní důvod neplatnosti klíče z bezpečnostních důvodů nerozlišuje.

Kód	Příčina
`MISSING_API_KEY`	V požadavku chybí hlavička X-COINERO-APIKEY.
`INVALID_API_KEY`	Klíč neexistuje, je zrušený či pozastavený nebo patří neaktivnímu účtu.

Obě situace podléhají limitu podle IP adresy, každá vlastnímu: požadavky bez hlavičky mají volnější limit než požadavky s klíčem, který nelze použít.

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 ticker = 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"]},
)
ticker = 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 ticker = 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
}

Stejný požadavek bez hlavičky:

curl "https://publicapi.coinero.cz/v1/ticker?symbol=BTCEUR"

# Bez hlavičky X-COINERO-APIKEY

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