Začínáme

Coinero API

Propojte svou aplikaci s Coinero API a získejte ceny, za které se na Coineru skutečně obchoduje, i další tržní data.

První požadavek

Založte si účet Coinero
Pro vytvoření API klíče potřebujete účet na coinero.cz.
Vytvořte API klíč
V aplikaci Coinero otevřete Profil a zabezpečení a v záložce API klíče vytvořte nový klíč.
Zavolejte API
Klíč posílejte v hlavičce X-COINERO-APIKEY u každého požadavku.
Klíč uchovávejte na serveru v proměnné prostředí a neposílejte jej do prohlížeče.

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");

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

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

Klíč načítejte na serveru z proměnné prostředí COINERO_API_KEY; neukládejte jej do zdrojového kódu ani neposílejte do prohlížeče.

Co sledovat v odpovědi

timestamp: Čas vytvoření tickeru určuje stáří ceny; stav dat ověříte přes GET /v1/status.
X-RateLimit-Remaining: Počet zbývajících požadavků v aktuálním okně; limit a čas obnovení udávají X-RateLimit-Limit a X-RateLimit-Reset. Zpomalte před vyčerpáním limitu.
X-Request-Id: Identifikátor požadavku pro komunikaci s podporou; u chyb je také v poli requestId.

Endpointy

Obecné

Endpoint	Výsledek
GET/v1/status	Stav API a dostupnost tržních dat.
GET/v1/time	Aktuální čas serveru Coinero.

Tržní data

Endpoint	Výsledek
GET/v1/tickers	Konečné nákupní a prodejní ceny všech obchodovaných párů, včetně poplatku.
GET/v1/ticker	Konečné nákupní a prodejní ceny jednoho obchodního páru, včetně poplatku.
GET/v1/markets	Obchodní páry, přesnost cen a minimální velikosti objednávek.

Účet

Připravujeme.

Obchodování

Připravujeme.

OpenAPI specifikace

Strojový popis všech endpointů, parametrů, odpovědí i chyb je na stabilní adrese https://publicapi.coinero.cz/openapi/v1.json. Dokument klíč nevyžaduje, takže si z něj klienta vygenerujete ještě před jeho vytvořením.

curl -sO https://publicapi.coinero.cz/openapi/v1.json

npx @hey-api/openapi-ts \
  -i https://publicapi.coinero.cz/openapi/v1.json \
  -o src/coinero

npx @openapitools/openapi-generator-cli generate \
  -i https://publicapi.coinero.cz/openapi/v1.json \
  -g python \
  -o coinero-client

Návody

AutentizaceVytvoření, odesílání a správa API klíčů.Limity požadavkůLimity volání, hlavičky a doporučené intervaly.ChybyChybové kódy, jejich příčiny a řešení.