Widżet kursy360.pl – kurs waluty albo cena surowca na Twojej stronie

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)

1. 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”.
2. 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”.
3. 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)

1. Pobierz skrypt (po założeniu bezpłatnego konta): k360-widget.js.
2. Wgraj plik na swój serwer, np. do katalogu głównego strony (adres /k360-widget.js).
3. 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

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 w script-src wystarczy 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