Dla stron firmowych, kantorów, blogów i portali
Widżet kursy360.pl – kurs waluty albo cena surowca na Twojej stronie
Widżet kursy360.pl to bezpłatny widżet naszego serwisu, który możesz pobrać i umieścić na własnej stronie – na przykład na stronie firmy rozliczającej się w walutach, w serwisie kantoru, na blogu albo w portalu. Pokazuje kurs waluty (kurs średni NBP, kupno i sprzedaż, kurs na żywo) albo cenę surowca (złoto, srebro, ropa, gaz, miedź, zboża i inne), wykres z ostatnich 12 miesięcy, krótkie podsumowanie i cztery ostatnie wiadomości. Wybierz walutę lub surowiec, motyw i sekcje, sprawdź podgląd na żywo, a po założeniu bezpłatnego konta skopiuj gotowy kod.
Konfigurator i podgląd działają dla każdego. Gotowy kod i pliki do pobrania są dostępne po założeniu bezpłatnego konta.
Konfigurator i pobieranie widżetu
Wybierz walutę albo surowiec, a potem ustaw wygląd widżetu – podgląd na żywo odświeża się na bieżąco. Po założeniu bezpłatnego konta (albo po zalogowaniu) skopiujesz gotowy kod jednym przyciskiem albo pobierzesz go jako plik HTML, a skrypt widżetu – jako plik JavaScript, jeśli wolisz hostować go u siebie.
Co pokazuje widżet
- Nagłówek – nazwa waluty lub surowca, kod, aktualny kurs albo cena, zmiana procentowa z oznaczeniem ▲ / ▼ (kierunek, nie ocena) oraz data i godzina notowania.
- Podsumowanie – dla walut: kurs średni NBP z datą tabeli, kupno i sprzedaż z tabeli C, zakres i zmiana z 12 miesięcy; dla surowców: cena w złotych, zakres dnia, zakres i zmiana z 12 miesięcy; do tego krótki, automatyczny opis (m.in. bank centralny i termin jego najbliższej decyzji oraz siła sygnałów w Skanerze AI).
- Wykres – dzienne kursy średnie NBP (waluty) albo ceny zamknięcia najbliższego kontraktu terminowego (surowce) z podpowiedzią po najechaniu lub dotknięciu i zakresami 1M, 3M, 6M oraz 1R. Rysuje go sam widżet z danych naszego API – bez zewnętrznych serwisów.
- Ostatnie wiadomości – cztery najnowsze wiadomości z serwisów finansowych, energetycznych i rolnych, w których mowa o tej walucie lub surowcu.
- Stopka – odnośnik do strony waluty lub surowca w Kursy360.pl i do jej forum, zastrzeżenie, że dane mają charakter informacyjny, oraz odnośnik „Widżet kursy360.pl do pobrania”.
Widżet pokazuje te same dane co strony walut i surowców w serwisie, z tych samych źródeł: NBP, Coinbase (kursy na żywo) i Yahoo Finance (ceny surowców z opóźnieniem) – opisujemy je na stronie O nas. Kurs w widżecie jest informacyjny: bank albo kantor wymienia walutę po własnym kursie.
Jak umieścić widżet na stronie
Sposób 1: wklej kod (zalecany)
- Załóż bezpłatne konto lub zaloguj się, a potem skopiuj kod z konfiguratora przyciskiem „Skopiuj kod widżetu” albo pobierz go jako plik przyciskiem „Pobierz plik z kodem”.
- Wklej go w kodzie HTML strony, w miejscu, w którym ma się pojawić widżet. W edytorze CMS (np. WordPress, Joomla, Wix, Webflow) użyj trybu „HTML”, bloku „Własny kod HTML” albo elementu „Embed”.
- Zapisz i odśwież stronę. Widżet pobierze dane i dopasuje się do szerokości miejsca, w którym go wstawiono.
Kod składa się z kontenera <div class="k360-rate-widget"> z ustawieniami (atrybuty data-*) i widocznym odnośnikiem do strony waluty lub surowca oraz ze skryptu k360-widget.js. Skrypt wystarczy dołączyć raz – obsłuży wszystkie widżety na stronie. Ogólny przykład (zamiast EUR wpisz kod waluty albo surowca):
<!-- Widżet kursu Kursy360.pl (v2) -->
<div class="k360-rate-widget"
data-ticker="EUR"
data-theme="light"
data-chart-height="300"
data-show-chart="true"
data-show-summary="true"
data-show-news="true">
<a href="https://kursy360.pl/waluta/EUR" target="_blank" rel="noopener">
Kurs euro (EUR) – NBP, kupno, sprzedaż i wykres w serwisie Kursy360.pl
</a>
</div>
<script async src="https://kursy360.pl/widget/k360-widget.js"></script>Sposób 2: własna kopia skryptu na Twoim serwerze (zaawansowany)
- Pobierz skrypt (po założeniu bezpłatnego konta): k360-widget.js.
- Wgraj plik na swój serwer, np. do katalogu głównego strony (adres
/k360-widget.js). - Skopiuj kod z konfiguratora po zaznaczeniu w ustawieniach zaawansowanych „Własna kopia skryptu na moim serwerze”. Kontener dostanie atrybut
data-base="https://kursy360.pl", dzięki któremu kopia skryptu nadal pobiera dane z naszego API.
Kopia skryptu nie aktualizuje się sama. Nie zmieniaj jej treści, w szczególności stopki z odnośnikami i zastrzeżeniem (zob. Regulamin, § 8b).
Parametry i interfejs JavaScript
| Atrybut | Wartości | Domyślnie | Opis |
|---|---|---|---|
data-ticker | kod waluty (np. EUR, USD, CHF) albo surowca (XAU złoto, XAG srebro, BRENT, WTI, NATGAS, COPPER, WHEAT …; złoto NBP – ZLNBP) | wymagany | Instrument, którego dane pokazuje widżet. Listę kodów zobaczysz w konfiguratorze. |
data-theme | light, dark, auto | light | Motyw. auto dopasowuje się do ustawienia systemu odwiedzającego. |
data-width | np. 100%, 640px, 40rem | 100% | Największa szerokość widżetu. |
data-chart-height | 200–700 | 300 | Wysokość wykresu w pikselach. |
data-show-chart | true, false | true | Wykres. |
data-show-summary | true, false | true | Podsumowanie: wskaźniki i opis tekstowy. Nagłówek z kursem jest zawsze widoczny. |
data-show-news | true, false | true | Cztery ostatnie wiadomości. |
data-base | adres serwisu | adres, z którego pobrano skrypt | Tylko przy własnej kopii skryptu – ustaw wtedy https://kursy360.pl. |
Widżetami można też sterować z JavaScriptu. Skrypt udostępnia obiekt K360Widget z metodami mount, update, reload, destroy i init, a na kontenerze wywołuje zdarzenia k360:ready i k360:error:
const w = K360Widget.mount(document.getElementById('moj-widzet'), { ticker: 'USD', theme: 'dark', showChart: false });
w.update({ theme: 'light', showNews: true });
w.reload();
w.destroy();
document.addEventListener('k360:ready', e => console.log(e.detail));Publiczne API (JSON)
Widżet korzysta z publicznego interfejsu GET https://kursy360.pl/api/v1/widget/KOD (np. /api/v1/widget/EUR albo /api/v1/widget/XAU; działa też adres strony surowca, np. /api/v1/widget/zloto). Odpowiedź ma nagłówki Content-Type: application/json; charset=utf-8, Access-Control-Allow-Origin: * i Cache-Control: public, max-age=300. Nieznany kod kończy się kodem 404, chwilowa niedostępność danych – kodem 503.
{
"version": 2, "ticker": "EUR", "name": "euro", "kind": "waluta", "group": "Waluta", "unit": "zł", "per": 1,
"profile_url": "https://kursy360.pl/waluta/EUR", "forum_url": "https://kursy360.pl/forum/EUR",
"quote": {
"price": 4.2456, "currency": "PLN", "change_pct": -0.22, "change_dir": "down", "session_date": "2026-10-21", "time": "14:32",
"stale": false, "source": "Coinbase", "nbp_mid": 4.2394, "nbp_date": "2026-10-20", "bid": 4.197, "ask": 4.2818,
"price_pln": null, "day_low": null, "day_high": null, "range_12m": { "low": 4.12, "high": 4.31 }, "change_12m": -1.4
},
"chart": { "currency": "PLN", "points": [ ["2025-10-21", 4.25], "…", ["2026-10-20", 4.2394] ] },
"summary": "Kurs średni euro (EUR) w tabeli NBP…",
"news": [ { "date": "2026-10-20", "type": "news", "label": "Bankier.pl", "title": "Tytuł wiadomości", "url": "https://…" } ],
"meta": { "generated_at": "2026-10-21T12:00:00Z", "data_date": "2026-10-21", "disclaimer": "…", "source_name": "Kursy360.pl", "source_url": "https://kursy360.pl/" }
}Dla walut price to kurs na żywo (gdy jest), a nbp_mid – kurs średni NBP; kwoty są w złotych za 1 jednostkę waluty (per podpowiada, że czytelniej pokazać kurs za 100 albo 10 000 jednostek, np. JPY, HUF). Dla surowców price to cena w dolarach w jednostce z pola unit (np. USD/uncja), a price_pln – ta sama cena w złotych. Pole chart.points to pary [data, kurs] od najstarszej (do około 13 miesięcy wstecz).
Wymagania techniczne, prywatność i bezpieczeństwo
- Lekki i niezależny. Jeden plik JavaScript bez bibliotek zewnętrznych; styl odizolowany (Shadow DOM) – style Twojej strony nie psują widżetu, a widżet nie zmienia wyglądu strony.
- Szybkie ładowanie. Skrypt ładuje się asynchronicznie, dane razem z wykresem i wiadomościami przychodzą jednym zapytaniem, a zarezerwowane miejsce (
min-height) ogranicza przesuwanie treści strony. - Responsywność i dostępność. Widżet dopasowuje się do szerokości miejsca (od około 280 px), ma motyw jasny i ciemny i można go obsłużyć klawiaturą.
- Prywatność. Zapytania do API Kursy360.pl nie używają plików cookie ani identyfikatorów odwiedzającego – serwer widzi tylko adres IP, jak przy każdym połączeniu. Widżet niczego nie zapisuje w urządzeniu odwiedzającego i nie ładuje skryptów, ramek ani czcionek od osób trzecich.
- Polityka CSP. Jeśli Twoja strona używa nagłówka Content-Security-Policy, dodaj:
script-src https://kursy360.pl; connect-src https://kursy360.pl. Przy własnej kopii skryptu wscript-srcwystarczy Twoja domena. - Gdy brakuje danych. Przy błędzie sieci albo nieznanym kodzie widżet pokazuje komunikat z odnośnikiem do strony waluty lub surowca – nie przerywa działania strony.
Pytania i odpowiedzi
Czy widżet jest bezpłatny?
Tak. Gotowy kod i pliki do pobrania udostępniamy po założeniu bezpłatnego konta (bez karty płatniczej), a działanie widżetu i publiczne API nie wymagają klucza. Prosimy tylko o pozostawienie w kodzie odnośnika do strony w Kursy360.pl. Korzystanie z widżetu i API podlega Regulaminowi serwisu.
Czy mogę używać kursu z widżetu do rozliczeń?
Do rozliczeń podatkowych i księgowych używa się kursu średniego NBP z właściwej tabeli – widżet pokazuje go z datą i numerem tabeli, ale za poprawność rozliczenia odpowiada rozliczający. Kursy na żywo i ceny surowców są informacyjne i mogą być opóźnione, a bank albo kantor wymienia walutę po własnym kursie.
Skąd pochodzą dane w widżecie?
Kursy średnie, kupno i sprzedaż – z tabel NBP, kursy walut na żywo – z Coinbase, ceny surowców – z Yahoo Finance (najbliższe kontrakty terminowe, z opóźnieniem), wiadomości – z serwisów prasowych i branżowych. Źródła opisujemy na stronie O nas. Dane mają charakter informacyjny i nie są rekomendacją inwestycyjną.
Czy widżet spowolni moją stronę?
Nie powinien. Skrypt ładuje się asynchronicznie, dane są pobierane jednym zapytaniem i przechowywane w pamięci podręcznej przez 5 minut, a wykres rysuje sam widżet – bez zewnętrznych skryptów.
Czy widżet działa na telefonie?
Tak. Układ dopasowuje się do szerokości miejsca, w którym wstawiono widżet (od około 280 px), a wykres po dotknięciu pokazuje kurs z wybranego dnia.
Widżet pokazuje komunikat o błędzie. Co robić?
Sprawdź, czy kod w data-ticker jest poprawny (np. EUR, XAU), i odśwież stronę. Jeśli problem się utrzymuje, napisz na admin@kursy360.pl.
Zobacz też: Kursy walut NBP · Ceny surowców · O nas i kontakt · Regulamin serwisu · Polityka prywatności