Začínáme

Limity požadavků

API omezuje počet požadavků za minutu podle klíče nebo IP adresy.

Limity

Kategorie	Limit	Způsob počítání
API klíč	60 požadavků za minutu	Na platný API klíč, společně pro všechny endpointy.
Veřejné cesty	30 požadavků za minutu	Na IP adresu pro kořenovou cestu a OpenAPI specifikaci, které klíč nevyžadují.
Chybějící klíč	30 požadavků za minutu	Na IP adresu pro požadavky bez hlavičky X-COINERO-APIKEY, které končí chybou MISSING_API_KEY.
Neplatný klíč	10 požadavků za minutu	Na IP adresu pro požadavky s poslaným klíčem, který nelze použít.

Limity se obnovují na začátku každé minuty a každý se počítá zvlášť: vyčerpání jednoho se nedotkne ostatních. Požadavek s platným klíčem čerpá jen limit klíče, žádný z limitů podle IP adresy se ho netýká. Zdravotní endpointy limit nemají.

Hlavičky odpovědi

Hlavička	Význam
`X-RateLimit-Limit`	Limit požadavků v aktuálním okně.
`X-RateLimit-Remaining`	Zbývající počet požadavků v aktuálním okně, nejméně 0.
`X-RateLimit-Reset`	Konec okna a obnovení limitu jako Unix timestamp v sekundách.
`Retry-After`	Čekání před dalším pokusem v sekundách; pouze u odpovědí 429 a 503.

Překročení limitu

API vrátí HTTP 429 s kódem RATE_LIMIT_EXCEEDED. Před dalším pokusem vyčkejte alespoň počet sekund z hlavičky Retry-After. Viz popis chyby.

Při opakovaném překračování limitu Coinero upozorní držitele klíče e-mailem.

Doporučené intervaly volání

Endpoint	Interval	Důvod
`GET /v1/tickers`	Každých 5 s	Častější volání zpravidla nepřinese novější data.
`GET /v1/ticker`	Každých 5 s	Pro více párů použijte /v1/tickers a šetřete limit.
`GET /v1/markets`	Každou hodinu	Seznam párů a jejich parametry se mění zřídka.
`GET /v1/status`	Každých 60 s	Při výpadku lze stav dočasně kontrolovat častěji.
`GET /v1/time`	Jednou při spuštění	Pro zjištění rozdílu mezi místním časem a časem serveru.

Hlavičky odpovědi 200

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 1788264060

Hlavičky odpovědi 429

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1788264060
Retry-After: 27
Content-Type: application/problem+json

429application/problem+json

{
  "type": "https://developers.coinero.cz/errors/rate-limit-exceeded",
  "title": "Rate limit exceeded",
  "status": 429,
  "code": "RATE_LIMIT_EXCEEDED",
  "detail": "Too many requests for this API key. Slow down and retry after the number of seconds given in the Retry-After response header.",
  "requestId": "0HN7GK4L2M9PQ"
}

Opakování požadavku podle Retry-After:

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

# 429 Too Many Requests
# Retry-After: 27

async function getTicker(symbol) {
  const response = await fetch(
    `https://publicapi.coinero.cz/v1/ticker?symbol=${symbol}`,
    { headers: { "X-COINERO-APIKEY": process.env.COINERO_API_KEY } },
  );

  if (response.status === 429) {
    const retryAfter = Number(response.headers.get("Retry-After"));
    await new Promise((resolve) => setTimeout(resolve, retryAfter * 1000));
    return getTicker(symbol);
  }

  return response.json();
}

import os
import time
import requests

def get_ticker(symbol):
    response = requests.get(
        "https://publicapi.coinero.cz/v1/ticker",
        params={"symbol": symbol},
        headers={"X-COINERO-APIKEY": os.environ["COINERO_API_KEY"]},
    )

    if response.status_code == 429:
        retry_after = int(response.headers["Retry-After"])
        time.sleep(retry_after)
        return get_ticker(symbol)

    response.raise_for_status()
    return response.json()

using System.Net;
using System.Net.Http.Json;
using System.Text.Json;

async Task<JsonElement> GetTickerAsync(HttpClient client, string symbol)
{
    var response = await client.GetAsync(
        $"https://publicapi.coinero.cz/v1/ticker?symbol={symbol}");

    if (response.StatusCode == HttpStatusCode.TooManyRequests)
    {
        var retryAfter = response.Headers.RetryAfter?.Delta ?? TimeSpan.FromSeconds(30);
        await Task.Delay(retryAfter);
        return await GetTickerAsync(client, symbol);
    }

    response.EnsureSuccessStatusCode();
    return await response.Content.ReadFromJsonAsync<JsonElement>();
}