Jak exchangerate.dev tworzy i oznacza kursy walut

1. Klasy źródeł

Publiczne pole source opisuje klasę danych, a nie dostawcę. live to orientacyjne dane rynku kasowego, które mogą być aktualizowane w krótkich odstępach podczas międzybankowego tygodnia handlowego. ecb_daily to kurs referencyjny Europejskiego Banku Centralnego, zwykle publikowany raz w każdym dniu roboczym. market_daily przechowuje dzienny kurs zamknięcia ze strumienia danych rynkowych dla walut bez fixingu ECB.

Odpowiedź obejmująca wiele walut zawiera mapę sources dla każdej kwotowanej waluty. Pole source na najwyższym poziomie jest zachowawcze: wskazuje najmniej aktualną klasę obecną w tej odpowiedzi.

Źródło: referencyjne kursy wymiany euro ECB.

2. Czas i stan rynku

data_updated_at to czas ostatniego zapisu obserwacji źródłowej. timestamp to czas utworzenia odpowiedzi API. Pierwszego pola używaj do obliczania wieku danych, a drugiego do audytu czasu żądania.

market_session ma wartość open podczas międzybankowego tygodnia handlowego, weekend od zamknięcia w piątek o 17:00 czasu nowojorskiego do niedzieli o 17:00 czasu nowojorskiego lub interbank_closed podczas znanego zamknięcia poza weekendem. Odpowiedź weekendowa może zawierać ostatnią obserwację z tygodnia handlowego; oznaczenie nie sugeruje nowego kwotowania w weekend.

3. Zmiana waluty bazowej i pochodne kursy krzyżowe

Kursy są normalizowane, aby wywołujący mogli wybrać dowolną obsługiwaną walutę bazową. Gdy para nie jest bezpośrednio obserwowana, API wylicza jej kurs metodą triangulacji przez dostępne pary składowe. Wartości pochodne są wskazywane w derived_symbols; odpowiedzi dla pojedynczej pary udostępniają również derived i granicę derivation_bps_max, gdy ma to zastosowanie.

Kurs krzyżowy dziedziczy najmniej aktualne źródło spośród swoich par składowych. Aplikacje, które nie mogą przyjąć kursu pochodnego, powinny sprawdzać pola dotyczące wyliczenia pochodnego, zamiast wnioskować na podstawie pary walutowej.

4. Obserwacje historyczne

Historia dzienna łączy fixingi i kursy zamknięcia rynku. Dane głównych walut sięgają 1999; około 30 korzysta z fixingów ECB, pozostałe 113 z kursów zamknięcia rynku, a daty początkowe różnią się w zależności od pary. W weekend lub święto bez nowego fixingu wcześniejsza obserwacja może zostać przeniesiona i oznaczona jako is_forward_filled: true. API nie tworzy fikcyjnego, nieopublikowanego fixingu.

5. Weryfikacja i publikacja

• Przed wyznaczeniem kursów identyfikatory walut są normalizowane do kodów zapisanych wielkimi literami w stylu ISO.
• Pola źródła i czasu aktualizacji są przekazywane wraz z obserwacją, zamiast być wywnioskowywane przez klienta.
• Gdy obserwacje bieżące są niedostępne lub zbyt stare, następuje przejście na dostępną dzienną klasę referencyjną, zamiast oznaczania ich jako bieżące.
• Każdy plan korzysta z tego samego źródła; użytkownicy Free i wywołujący bez klucza otrzymują bieżące kursy z opóźnieniem 15 minut.
• Publikowane badania muszą zawierać okres pomiaru, liczbę próbek, metodę i ograniczenia.

6. Ograniczenia

Są to orientacyjne kursy referencyjne, a nie kwotowania kupna/sprzedaży, po których można zawrzeć transakcję. Nie obejmują spreadu ani opłat banku, wydawcy karty, brokera, dostawcy usług płatniczych ani podmiotu prowadzącego gotówkową wymianę walut. Nie wolno ich używać do rozliczeń, realizacji płatności, handlu regulowanego ani jako źródła oficjalnej ewidencji. Zakres danych i ich aktualność mogą różnić się w zależności od waluty, dostępności źródeł, zamknięcia rynku i harmonogramu publikacji instytucji referencyjnej.

7. Standard benchmarku aktualności danych

Publikujemy protokół przed opublikowaniem rankingu. Odtwarzalny benchmark aktualności danych API kursów walut określa okres obserwacji, wymagania dotyczące znaczników czasu, metryki, wyłączenia i minimalną wielkość próby. Jego protokół w formacie do odczytu maszynowego nie zawiera obecnie wyników dostawców; wyniki zostaną dodane dopiero po osiągnięciu określonego progu dowodowego.

Historia zmian

1.1 · 9 października 2026: Doprecyzowano opóźnienie w Free i dzienne kursy zamknięcia rynku.

1.0 · 16 lipca 2026: Pierwsza publiczna metodologia, znaczenie źródeł, zasady sesji rynkowych, polityka wyliczania kursów pochodnych, sposób obsługi danych historycznych, ograniczenia i standard publikacji benchmarków.

Korekty: hello@exchangerate.dev