Wypróbuj 15-minutową obserwację USD/JPY
curl "https://api.exchangerate.dev/v1/timeseries?base=USD&symbols=JPY&interval=15m&from=2026-09-14T12:00:00Z&to=2026-09-14T12:00:00Z" -H "Authorization: Bearer YOUR_API_KEY"{ "result": "success", "base": "USD", "symbols": ["JPY"], "interval": "15m", "from": "2026-09-14T12:00:00Z", "to": "2026-09-14T12:00:00Z", "data": [{ "timestamp": "2026-09-14T12:00:00Z", "effective_at": { "JPY": "2026-09-14T12:14:58.972181Z" }, "rates": { "JPY": 154.582 }, "source": "live", "source_type": "market", "market_session": "open", "derived_symbols": [] }], "next_cursor": null, "has_more": false, "notice": "Indicative rates, not for settlement."}Stały przykład sprawdzony 2026-09-15 dla przedziału zaczynającego się 2026-09-14 o 12:00 UTC. Kurs jest orientacyjny. timestamp to początek przedziału; effective_at to czas obserwacji.
Interwały i dostępna historia
/v1/timeseries obsługuje 1m, 5m, 15m, 1h, 4h oraz dzienne dane referencyjne 1d. Nie ma interwału 2h. Krzyżowe pary SGD bez USD nie obsługują 4h; USD/SGD i odwrotny kierunek są dostępne. Zbieranie danych rynkowych rozpoczęło się 2026-09-14. Dane 1m są przechowywane przez 30 dni, a większe interwały nie mają zaplanowanego terminu usunięcia. Retencja nie oznacza już zgromadzonej długości historii. Intraday od 1m do 1h obejmuje 221 unikalnych par: 143 pary z USD i 78 par krzyżowych.
| interval | Unikalne pary | Maksymalny zakres żądania |
|---|---|---|
1m | 221 | 7 d |
5m | 221 | 31 d |
15m | 221 | 93 d |
1h | 221 | 366 d |
4h | 209 | 1830 d |
1d | 10296 | 1830 d |
Brakujące obserwacje i pary krzyżowe
Historyczne pary krzyżowe wymagają rzeczywistych obserwacji zamknięcia w tym samym przedziale UTC, oddalonych o najwyżej 5 sekund. effective_at wskazuje starszą obserwację. Luki nie są wypełniane; otwarty przedział może się zmieniać. 1d korzysta z dziennych danych referencyjnych całego katalogu. Tabela liczy unikalne pary; oba kierunki są obsługiwane.
Obsługiwane okno bez obserwacji zwraca HTTP 200 z data: [], has_more: false i next_cursor: null. Nieznany interwał zwraca unsupported_interval; para poza zakresem zwraca unsupported_pair_interval i rejected_pairs (HTTP 400). Żądania mieszane są odrzucane w całości.
Uwierzytelnianie i użycie komercyjne
Plus: 1h i 4h przez 30 dni. Pro: 1m za ostatnie 30 dni, a od 5m do 4h pełna historia intraday. Oba plany wymagają klucza.
Endpointy danych można testować anonimowo: 10 żądań na minutę i 100 na godzinę dla jednego IP. Klucz uruchamia miesięczny limit konta. Ceny Free są opóźnione o 15 minut (nagłówek X-Price-Delay-Seconds: 900).
| Plan | Żądania miesięcznie | Użycie komercyjne |
|---|---|---|
| Free | 5,000 | Wyświetlanie z linkiem do źródła |
| Basic | 100,000 | Tak |
| Plus | 300,000 | Tak |
| Pro | 1,000,000 | Tak |