PoradnikiPoradniki

Jak zdobyć darmowy klucz API do kursów walut (i kiedy wcale go nie potrzebujesz)

Możesz wywoływać API exchangerate.dev bez żadnego klucza; 10 żądań na minutę, wprost z curl albo przeglądarki. Utworzenie darmowego klucza zajmuje około minuty i podnosi ten limit do 5 000 wywołań miesięcznie w ramach własnej puli. Ten przewodnik pokazuje obie ścieżki i granice każdej z nich.

9 sie 2026 · 4 min czytania

Dwie szczere odpowiedzi, najpierw krótsza. Do wypróbowania API nie potrzebujesz żadnego klucza: /v1/latest, /v1/convert i ostatnie 30 dni historii dziennej obsługują anonimowe żądania z limitem 10 żądań na minutę i 100 na godzinę na adres IP. Do wszystkiego, co działa według harmonogramu albo trafia do innych osób, zarejestruj się na exchangerate.dev/signup, potwierdź e-mail i skopiuj z panelu klucz zaczynający się od exr_live_. Darmowy plan: 5 000 wywołań miesięcznie, 10 żądań na minutę, dzienna historia z ostatnich 30 dni, bez karty kredytowej.

  • Bez klucza: kursy, przeliczenia i 30 dni historii dziennej; 10 żądań/min, 100/godz. na IP.
  • Darmowy klucz tworzysz na /signup, tylko potwierdzenie e-mail, bez karty kredytowej, i wygląda jak exr_live_....
  • Darmowy plan: 5 000 wywołań miesięcznie, 10 żądań na minutę, dzienna historia z ostatnich 30 dni, kursy live docierające 15 minut później.
  • Wysyłaj klucz jako Authorization: Bearer exr_live_... albo X-API-Key, gdy konektor nie potrafi ustawić nagłówka Authorization.
  • Nigdy nie umieszczaj klucza w adresie URL ani w publicznym pakiecie przeglądarki, tylko w nagłówkach, z proxy po stronie serwera dla frontendów.

Ścieżka bez klucza: najpierw wypróbuj API

Zanim cokolwiek utworzysz, wywołaj API i zobacz prawdziwą odpowiedź. Działa to z dowolnego terminala, bez rejestracji:

curl · anonymous
# No key, no signup, works at 10 req/min, 100 req/hour per IPcurl -s https://api.exchangerate.dev/v1/latest/USD# A single pair, convertedcurl -s https://api.exchangerate.dev/v1/convert/USD/JPY/250

Każda odpowiedź zawiera source i market_session, więc zanim cokolwiek zdecydujesz, widzisz, czy kurs to bieżący kurs rynkowy, czy dzienny fixing ECB. Możesz też uruchomić to samo wywołanie w przeglądarce i przejrzeć zwrócony JSON.

Kiedy anonimowy dostęp naprawdę wystarczy

Jednorazowy skrypt, ćwiczenie na zajęciach albo ręczne sprawdzenie kursu mieszczą się w 100 żądaniach na godzinę. Jeśli to cały twój przypadek użycia, jesteś gotowy, bez klucza, bez niczego do przechowywania czy rotowania.

Zdobądź darmowy klucz

  • Otwórz exchangerate.dev/signup i zarejestruj się przy użyciu e-maila. Nie ma kroku z kartą kredytową.
  • Potwierdź e-mail. Twój panel otwiera się z już przygotowanym kluczem API.
  • Skopiuj klucz, zaczyna się od exr_live_. Po tym prefiksie rozpoznasz go później w konfiguracjach.

Darmowy plan to 5 000 wywołań miesięcznie przy 10 żądaniach na minutę, z ostatnimi 30 dniami historii dziennej i kursami live docierającymi z opóźnieniem 15 minut. Płatne plany otrzymują ten sam feed na żywo; plan Darmowy i wywołania bez klucza otrzymują go 15 minut później.

Użyj klucza: nagłówki, nigdy adresy URL

Przekaż klucz w nagłówku. Authorization: Bearer to podstawowa forma; X-API-Key istnieje dla konektorów, które nie potrafią ustawić nagłówka Authorization (niektóre narzędzia BI i platformy no-code):

curl · authenticated
# Primary formcurl -s https://api.exchangerate.dev/v1/latest/USD \  -H "Authorization: Bearer exr_live_your_key_here"# Fallback for connectors without Authorization supportcurl -s https://api.exchangerate.dev/v1/latest/USD \  -H "X-API-Key: exr_live_your_key_here"

Trzymaj klucz z dala od parametrów zapytania, z dala od pakietów JavaScript po stronie klienta i z dala od systemu kontroli wersji. W kodzie aplikacji odczytuj go ze zmiennej środowiskowej; dla publicznego frontendu kieruj wywołania przez niewielkie proxy po stronie serwera, żeby klucz nigdy nie dotarł do przeglądarki.

Której ścieżki naprawdę potrzebujesz?

SytuacjaAnonimowoDarmowy klucz
Testowanie API, pojedyncze sprawdzeniaTak, 10 żądań/min na IPTeż działa, ale nie jest wymagany
Zadanie cron albo odświeżanie według harmonogramuKruche, dzieli limit na adres IPTak; własna pula 5 000/mies.
Arkusz albo skoroszyt odświeżany przez inne osobyNie, ich adresy IP, ich limityTak, pula podąża za kluczem
Produkt, który sprzedajesz lub dystrybuujeszTak, z widocznym linkiem do źródłaTak, z widocznym linkiem do źródła
Kursy orientacyjne, nie do rozliczeń

Anonimowo czy z kluczem, feed jest ten sam: orientacyjne dane rynkowe do modeli, analiz i prezentacji, nie oferta transakcyjna. Każda odpowiedź powtarza to w polu notice.

Pytania

Czy potrzebuję klucza API, żeby pobierać kursy walut?

Nie do wypróbowania. Kursy, przeliczenia i ostatnie 30 dni historii dziennej exchangerate.dev obsługują anonimowe żądania z limitem 10 żądań na minutę i 100 na godzinę na adres IP. Klucz jest potrzebny, gdy chcesz mieć własną pulę; darmowy plan to 5 000 wywołań miesięcznie; albo gdy Twoje wywołania działają według harmonogramu lub pochodzą z maszyn innych osób.

Czy darmowy klucz API do kursów walut jest naprawdę darmowy?

Tak. Rejestracja wymaga tylko e-maila; bez karty kredytowej. Darmowy plan to 5 000 wywołań miesięcznie przy 10 żądaniach na minutę z dzienną historią z ostatnich 30 dni. Ma sztywny limit zamiast rozliczania nadwyżki, więc nie może po cichu zacząć naliczać opłat.

Jak wygląda klucz API exchangerate.dev?

To ciąg znaków zaczynający się od exr_live_. Wysyłasz go jako nagłówek Authorization: Bearer albo jako X-API-Key, jeśli Twoje narzędzie nie potrafi ustawić nagłówków Authorization.

Czy mogę użyć darmowego klucza w produkcie komercyjnym?

Free pozwala wyświetlać kursy komercyjnie z widocznym linkiem do źródła; płatne plany nie wymagają linku. Redystrybucja jest zabroniona; odsprzedaż wymaga pisemnej umowy przez hello@exchangerate.dev.

Czy bezpiecznie jest umieścić klucz API w adresie URL?

Nie. Parametry zapytania trafiają do logów serwera, proxy i historii przeglądarki. Wysyłaj klucz w nagłówku, przechowuj go w zmiennej środowiskowej po stronie serwera i nigdy nie umieszczaj go wewnątrz pakietu JavaScript po stronie klienta.

Czytaj dalej

Zacznij od bezpłatnego klucza API

5 000 zapytań miesięcznie w bezpłatnym planie. Bez karty kredytowej.

Uzyskaj bezpłatny klucz