Přehled API · Tržní data

GET /v1/markets

Vrací obchodní páry dostupné v aplikaci Coinero a jejich parametry.

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

Parametry dotazu

Endpoint nemá parametry dotazu.

Odpověď

application/json · MarketsResponse

Kromě EUR a CZK Coinero kotuje páry i v BTC, ETH a USDC. Seznam zahrnuje i páry kotované v CZK, které Coinero provádí přes EUR; převod je už součástí cen z GET /v1/ticker.

Vyřazený pár zůstává v seznamu 30 dní se stavem delisted.

Čá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
marketspole MarketResponse	Seznam obchodních párů seřazený podle symbolu.
markets[].symbolstring	Symbol páru: základní a kotovací měna bez oddělovače, například BTCEUR.
markets[].basestring	Kód základní měny, například BTC.
markets[].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.
markets[].statusstring	Stav obchodování páru. Hodnoty: trading, paused, delisted.
markets[].pricePrecisioninteger (int32)	Počet desetinných míst kroku ceny, shodně s tickSize. Na tolik míst zaokrouhlete cenu pokynu; u buyPrice a sellPrice je to spodní mez, ne přesný počet míst (viz GET /v1/ticker).
markets[].amountPrecisioninteger (int32)	Počet desetinných míst množství základní měny.
markets[].tickSizestring	Nejmenší krok ceny v kotovací měně, jako desetinný řetězec; u interně převáděných měn odvozený z pricePrecision a u párů, které Coinero kotuje opačně než burza, z minim zdrojového páru.
markets[].minOrderSizestring	Minimální množství základní měny, které přijme burza, jako desetinný řetězec. Je to minimum trhu, ne minimum, které vynutí Coinero: u pokynu zadaného v kotovací měně se kontroluje proti vyšší hodnotě, protože burza si při přepočtu drží rezervu na pohyb ceny. Berte ho jako spodní mez.
markets[].minOrderValuevolitelnéstring	Minimální hodnota pokynu v kotovací měně, jako desetinný řetězec; nikdy se nezaokrouhluje pod svou vlastní přesnost. Bez stanoveného minima a u interně převáděných měn (závisela by na kurzu) pole chybí.

Hodnoty stavů

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

PublicMarketStatus	Význam
`trading`	obchodování povoleno
`paused`	obchodování pozastaveno, může se obnovit bez oznámení
`delisted`	obchodování trvale ukončeno, pár zmizí ze seznamu po 30 dnech

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ždou hodinu. Seznam a parametry párů se mění zřídka; podle potřeb integrace lze interval zkrátit.

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

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

200application/json

{
  "markets": [
    {
      "symbol": "BTCEUR",
      "base": "BTC",
      "quote": "EUR",
      "status": "trading",
      "pricePrecision": 1,
      "amountPrecision": 8,
      "tickSize": "0.1",
      "minOrderSize": "0.00005000",
      "minOrderValue": "0.45"
    },
    {
      "symbol": "ETHEUR",
      "base": "ETH",
      "quote": "EUR",
      "status": "trading",
      "pricePrecision": 2,
      "amountPrecision": 8,
      "tickSize": "0.01",
      "minOrderSize": "0.00100000",
      "minOrderValue": "0.45"
    },
    {
      "symbol": "BTCCZK",
      "base": "BTC",
      "quote": "CZK",
      "status": "trading",
      "pricePrecision": 1,
      "amountPrecision": 8,
      "tickSize": "0.1",
      "minOrderSize": "0.00005000"
    },
    {
      "symbol": "USDCBTC",
      "base": "USDC",
      "quote": "BTC",
      "status": "trading",
      "pricePrecision": 10,
      "amountPrecision": 8,
      "tickSize": "0.0000000001",
      "minOrderSize": "0.50000000",
      "minOrderValue": "0.0000500000"
    }
  ]
}

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