In this Article
Przeliczanie walut wygląda jak rozwiązany problem z API na pierwszym planie. Komplikacje pojawiają się, gdy po raz pierwszy dział finansów i zespół produktowy nie zgadzają się co do liczby, a przyczyna niemal zawsze jest taka, że używają różnych kursów i obie strony sądzą, że ich kurs jest tym właściwym.
Ten przewodnik rozdziela cztery typy kursów, wyjaśnia, skąd każdy z nich się bierze, i podaje zasadę wyboru kursu, którego możesz później bronić.
Najważniejsze fakty
- Nie istnieje jeden kurs wymiany. Walutami handluje się poza giełdą, więc każdy publikowany kurs przedstawia spojrzenie jednego źródła w danym momencie.
- Cztery typy kursów są regularnie mylone, a użycie niewłaściwego z nich jest najczęstszą przyczyną różnic uzgodnieniowych w systemie finansowym.
- Referencyjne kursy banku centralnego są publikowane raz dziennie i są stabilne oraz możliwe do przytoczenia, dlatego nadają się do księgowości, ale nie do ustalania cen.
- Kurs płacony przez klienta zawiera spread, więc kurs międzybankowy nigdy nie odpowiada wyciągowi z karty, a przedstawianie go jako ceny tworzy zgłoszenia do wsparcia.
- Zawsze zapisuj kurs, źródło i znacznik czasu przy każdej przeliczonej kwocie, w przeciwnym razie nie da się później odtworzyć przeliczenia.
Dlaczego nie istnieje jeden kurs wymiany?
Ponieważ głównymi walutami handluje się poza giełdą między instytucjami, a nie na jednej centralnej giełdzie. Nie ma dzwonka zamknięcia ani oficjalnego kursu, dlatego każda publikowana wartość jest agregacją konkretnego źródła w konkretnej chwili.
Ma to bezpośrednią konsekwencję dla oprogramowania: dwa API odpytywane w odstępie sekundy mogą zgodnie z prawem zwrócić różne liczby i żadne z nich nie jest wadliwe. Problemu uzgodnienia, który to powoduje, nie rozwiązuje znalezienie lepszego źródła. Rozwiązuje go decyzja, które źródło jest autorytatywne dla danego celu, oraz zapisanie tej decyzji przy każdej przechowywanej kwocie.
Jakie typy kursów istnieją?
Cztery, o różnych celach, a każde currency exchange rate api zwraca jeden z nich. Nazywamy to 4-częściowym modelem kursu.
| Typ | Co to jest | Zastosowanie |
|---|---|---|
| 1. Kurs międzybankowy | Środek między ceną kupna i sprzedaży na głównych rynkach | Wyświetlanie, analityka, porównania wewnętrzne |
| 2. Referencja banku centralnego | Publikowany codziennie kurs referencyjny, ustalany o określonej godzinie | Księgowość, podatki, umowy, wszystko, co wymaga audytu |
| 3. Kurs transakcyjny | Kurs faktycznie stosowany przez dostawcę płatności lub sieć kartową, wraz ze spreadem | Uzgadnianie z rzeczywistymi rozliczeniami |
| 4. Kurs gwarantowany | Kurs zablokowany przez dostawcę na określony okres, z marżą za tę gwarancję | Wycena przy finalizacji zakupu, gdy suma nie może się zmienić |
Klasyczny błąd polega na wyświetlaniu kursu międzybankowego przy finalizacji zakupu i rozliczaniu według kursu transakcyjnego. Klient widzi jedną liczbę, a obciążany jest inną, a różnica jest całkowicie przewidywalna i możliwa do uniknięcia.
Jak wybrać i przechowywać kurs?
| Cel | Użyj tego kursu, gdy | Unikaj, gdy |
|---|---|---|
| Sprawozdawczość finansowa | Referencja banku centralnego, z datą | Potrzebujesz dokładności śróddziennej, której referencje nie zapewniają |
| Ceny produktów pokazywane użytkownikom | Kurs gwarantowany lub transakcyjny, z ujawnionym spreadem | Używania kursu międzybankowego, który nie będzie odpowiadać obciążeniu |
| Analityka i dashboard | Kurs międzybankowy, konsekwentnie, z jednego źródła | Mieszania źródeł między wykresami, co tworzy pozorną zmienność |
| Porównanie historyczne | Kurs zapisany w danym czasie | Ponownego przeliczania historii po dzisiejszym kursie, co przepisuje przeszłość |
Jedna zasada przechowywania obejmuje większość problemów: przy każdej przeliczonej kwocie zachowuj pierwotną kwotę, walutę, kurs, źródło i znacznik czasu. Systemy przechowujące tylko przeliczoną wartość nie potrafią odpowiedzieć, dlaczego liczba się zmieniła, a to pytanie zawsze w końcu pada.
Gdzie mieści się pozyskiwanie danych i jakie są jego ograniczenia?
W przypadku kursów referencyjnych korzystaj z oficjalnych źródeł. Banki centralne publikują je otwarcie i w formacie odczytywalnym maszynowo. Pobieranie danych ze strony finansowej dla liczby, którą bank centralny publikuje jako API, ma same wady: niższą niezawodność, gorsze pochodzenie danych oraz niepotrzebny problem z warunkami korzystania.
Dane rynkowe podlegają licencjonowaniu. Kursy instytucjonalne na żywo są produktem licencjonowanym z warunkami redystrybucji, tak jak dane z rynku akcji. Bezpłatny kanał wyświetlania rzadko jest licencjonowany do odsprzedaży lub zastosowania dla klientów.
Pary kryptowalutowe to inny problem. Są notowane na wielu rynkach po rzeczywiście różnych cenach, więc jeden kurs jest redakcyjnym wyborem, które rynki uwzględnić i jak je ważyć. Powiedz, którego wyboru dokonałeś.
Wąskie zastosowanie żądania przypiętego do kraju dotyczy sytuacji, gdy niektóre oficjalne portale i regionalne serwisy finansowe ograniczają lub lokalizują dostęp według pochodzenia. DataImpulse residential obejmuje to za $1 za GB w 195 krajach. Sam kurs powinien pochodzić od oficjalnego wydawcy.
Powiązane: licencjonowanie danych rynkowych, czy web scraping jest legalny.
Często zadawane pytania
Dlaczego dwa API zwracają różne kursy walut?
Ponieważ głównymi walutami handluje się poza giełdą, bez centralnej giełdy, więc każdy publikowany kurs jest agregacją jednego źródła w jednej chwili. Dwa API odpytywane w odstępie sekundy mogą zgodnie z prawem się różnić, dlatego dla każdego celu należy wybrać i zapisać autorytatywne źródło.
Jakiego kursu wymiany użyć do księgowości?
Referencyjnego kursu banku centralnego, zapisanego wraz z datą. Jest publikowany raz dziennie o stałej porze, stabilny i możliwy do przytoczenia, a tego oczekują audytorzy. To niewłaściwy wybór do wyceny przy finalizacji zakupu, ponieważ nie będzie odpowiadał temu, czym klient zostanie faktycznie obciążony.
Dlaczego bank mojego klienta pobiera inną kwotę?
Ponieważ kurs międzybankowy nie ma spreadu, a rzeczywista transakcja go ma. Sieci kartowe i dostawcy płatności stosują własny kurs powiększony o marżę, więc pokazywanie kursu międzybankowego przy finalizacji zakupu gwarantuje rozbieżność między wyświetlaną a pobraną kwotą.
Czy powinienem pobierać kursy wymiany ze stron finansowych?
Nie. Banki centralne publikują kursy referencyjne otwarcie w formacie odczytywalnym maszynowo, a instytucjonalne kursy rynkowe są produktami licencjonowanymi z warunkami redystrybucji. Pobieranie danych daje gorsze pochodzenie i niezawodność w przypadku danych, które są już właściwie dostępne.
Co powinienem przechowywać przy przeliczonej kwocie?
Pierwotną kwotę i walutę, zastosowany kurs, źródło tego kursu oraz znacznik czasu. Bez wszystkich pięciu elementów nie można odtworzyć ani wyjaśnić wartości historycznej, a ponowne przeliczanie zapisanej historii według bieżącego kursu po cichu przepisuje wcześniejsze raporty.
Docieraj do oficjalnych wydawców z właściwego regionu
Niektóre oficjalne i regionalne portale finansowe lokalizują lub ograniczają dostęp według pochodzenia. DataImpulse residential proxies zapewniają wyjścia przypięte do kraju za $1 za GB w 195 krajach. Utwórz konto i zweryfikuj jedno źródło z jego własnego regionu.
Powiązane: API danych giełdowych · publiczne portale danych · czy web scraping jest legalny.
Ostatnia aktualizacja: 17 września 2026 r.