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.
Požadavky bez klíče	30 požadavků za minutu	Na IP adresu pro kořenovou cestu a OpenAPI specifikaci.
Neúspěšná autentizace	10 požadavků za minutu	Na IP adresu, pouze pro požadavky s neúspěšnou autentizací.

Limity se obnovují na začátku každé minuty a počítají se nezávisle. Požadavky bez klíče nečerpají limit klíče; neúspěšná autentizace nečerpá limit požadavků bez klíče.

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.

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

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1788264060
Retry-After: 27
Content-Type: application/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>();
}