Widżet gielda360.pl – pobierz i umieść na swojej stronie

Konfigurator i pobieranie widżetu

Wybierz spółkę, a potem ustaw wygląd widżetu – podgląd na żywo działa dla każdego i 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 spółki – nazwa, symbol (ticker), aktualny kurs, zmiana procentowa z oznaczeniem ▲ / ▼ oraz data sesji.
• Podsumowanie notowań – obrót, zakres cen z 12 miesięcy i średni obrót z 3 miesięcy oraz krótki, automatyczny opis sytuacji kursowej spółki (zmiany kursu, zakres cen, najbliższe zdarzenie w kalendarzu).
• Wykres kursu – ten sam wykres kursów zamknięcia, który pokazujemy w serwisie na stronie spółki: linia z podpowiedzią po najechaniu lub dotknięciu (data, kurs, zmiana wobec poprzedniej sesji) i zakresami 1M, 3M, 6M oraz 1R. Rysuje go sam widżet z danych naszego API – bez zewnętrznych serwisów – w motywie jasnym albo ciemnym.
• Ostatnie wiadomości – cztery najnowsze informacje o spółce: komunikaty ESPI/EBI i wiadomości z serwisu, z datą, oznaczeniem źródła i odnośnikiem do treści. Wszystkie pozostałe komunikaty i wiadomości są w serwisie – prowadzi do nich odnośnik pod listą.
• Stopka – odnośnik do profilu spółki w Giełda360.pl, odnośnik do forum spółki, zastrzeżenie, że dane mają charakter informacyjny, oraz odnośnik „Widżet gielda360.pl do pobrania” do tej strony.

Widżet pokazuje te same dane, co strony spółek w serwisie, z tych samych źródeł (opisujemy je na stronie O nas, w części „Skąd są dane”). Kursy mogą być opóźnione, przy danych podajemy datę, a opis podsumowania jest generowany automatycznie według stałych reguł. Widżet celowo nie pokazuje wskaźników wyceny (C/Z, C/WK) – znajdziesz je na stronie spółki w serwisie, w ramce „Wskaźniki”.

Jak umieścić widżet na stronie

Widżet możesz umieścić na stronie na dwa sposoby. Zalecany jest pierwszy: kod odwołuje się do skryptu na naszym serwerze, więc widżet zawsze działa w aktualnej wersji.

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” – w pliku jest ten sam kod z krótką instrukcją, a po otwarciu go w przeglądarce zobaczysz widżet.
2. Wklej go w kodzie HTML strony, w miejscu, w którym ma się pojawić widżet. W edytorze CMS (np. WordPress, Joomla, Drupal, Wix, Webflow) użyj trybu „HTML”, bloku „Własny kod HTML” albo elementu „Embed”. W stronie statycznej wklej kod między znaczniki <body>.
3. Zapisz i odśwież stronę. Widżet pobierze dane spółki i dopasuje się do szerokości miejsca, w którym go wstawiono.

Kod składa się z kontenera <div class="g360-profile-widget"> z ustawieniami (atrybuty data-*) i widocznym odnośnikiem do profilu spółki oraz ze skryptu g360-widget.js. Odnośnik w kontenerze widzą wyszukiwarki, zanim skrypt się wykona, i odwiedzający, gdy skrypt jest zablokowany. Skrypt wystarczy dołączyć raz – jeśli na stronie jest kilka widżetów (np. kilku spółek), obsłuży je wszystkie. Poniżej ogólny przykład budowy kodu z symbolem SYMBOL; gotowy kod z wybraną spółką i Twoimi ustawieniami daje konfigurator po założeniu bezpłatnego konta.

<!-- Widżet Profilu Spółki Giełda360.pl (v2) -->
<div class="g360-profile-widget"
     data-ticker="SYMBOL"
     data-theme="light"
     data-chart-height="300"
     data-show-chart="true"
     data-show-summary="true"
     data-show-news="true">
  <a href="https://gielda360.pl/spolka/SYMBOL" target="_blank" rel="noopener">
    Notowania, wykres i profil spółki NAZWA SPÓŁKI (SYMBOL) w serwisie Giełda360.pl
  </a>
</div>
<script async src="https://gielda360.pl/widget/g360-widget.js"></script>

Zamiast SYMBOL wpisz symbol spółki (np. z listy w konfiguratorze). Odnośnik do profilu jest zwykłym odnośnikiem (rel="noopener", bez nofollow) – prosimy o pozostawienie go w kodzie.

Sposób 2: własna kopia skryptu na Twoim serwerze (zaawansowany)

Ten sposób przydaje się, gdy polityka bezpieczeństwa strony nie pozwala ładować skryptów z obcych domen (np. na korporacyjnej stronie spółki z restrykcyjnym nagłówkiem CSP).

1. Pobierz skrypt (po założeniu bezpłatnego konta): g360-widget.js (około 53 KB, po kompresji około 17 KB). Ten sam plik pobierzesz też w konfiguratorze.
2. Wgraj plik na swój serwer, np. do katalogu głównego strony (adres /g360-widget.js). Jeśli leży gdzie indziej, popraw ścieżkę w atrybucie src.
3. Skopiuj kod z konfiguratora po zaznaczeniu w ustawieniach zaawansowanych opcji „Własna kopia skryptu na moim serwerze”. Kontener dostanie atrybut data-base="https://gielda360.pl", dzięki któremu kopia skryptu nadal pobiera dane z naszego API.

Kopia skryptu nie aktualizuje się sama – gdy zmieni się interfejs (zapowiadamy to na tej stronie), pobierz skrypt ponownie. Nie zmieniaj jego treści, w szczególności stopki z odnośnikami i zastrzeżeniem (zob. Regulamin, § 8b).

Parametry i interfejs JavaScript

Wygląd i zawartość widżetu ustawiasz atrybutami data-* kontenera. Zmiana atrybutu w kodzie strony wystarcza – nie trzeba niczego pobierać ponownie.

Widżetami można też sterować z JavaScriptu (np. w aplikacji jednostronicowej). Skrypt udostępnia obiekt G360Widget z metodami mount, update, reload, destroy i init, a na kontenerze wywołuje zdarzenia g360:ready (dane wczytane) i g360:error (błąd):

const w = G360Widget.mount(document.getElementById('moj-widzet'), { ticker: 'SYMBOL', theme: 'dark', showChart: false });
w.update({ theme: 'light', showNews: true });   // zmiana ustawień bez ponownego pobierania danych
w.reload();                                      // wymuszone odświeżenie danych
w.destroy();                                     // usunięcie widżetu
document.addEventListener('g360:ready', e => console.log(e.detail));

Nazwy opcji w JavaScript odpowiadają atrybutom: ticker, theme, width, chartHeight, showChart, showSummary, showNews (dawniej showEspi – nadal działa).

Publiczne API (JSON)

Widżet korzysta z publicznego interfejsu GET https://gielda360.pl/api/v1/widget/SYMBOL. Możesz go używać także bez widżetu, np. do własnej wizualizacji. Odpowiedź ma nagłówki Content-Type: application/json; charset=utf-8, Access-Control-Allow-Origin: * i Cache-Control: public, max-age=300 (pamięć podręczna 5 minut; gdy w odpowiedzi chwilowo nie ma wykresu – 1 minuta). Nieznany symbol kończy się kodem 404 z komunikatem w JSON, chwilowa niedostępność danych – kodem 503.

{
  "version": 2,
  "ticker": "SYMBOL", "name": "Nazwa Spółki S.A.", "isin": "PL0000000000",
  "segment": null, "sector": null,
  "website": "https://spolka.example/",
  "profile_url": "https://gielda360.pl/spolka/SYMBOL",
  "forum_url": "https://gielda360.pl/forum/SYMBOL",
  "quote": {
    "price": 1.25, "currency": "PLN", "change_pct": 2.4, "change_dir": "up",
    "turnover": 15200, "market_cap": 25000000, "market_cap_date": "2026-10-15", "session_date": "2026-10-16", "stale": false,
    "range_12m": { "low": 0.9, "high": 1.6 }, "avg_turnover_3m": 12100
  },
  "chart": { "currency": "PLN", "points": [ ["2025-10-17", 1.1], ["2025-10-20", 1.12], "…", ["2026-10-16", 1.25] ] },
  "summary": "Automatyczne podsumowanie notowań spółki…",
  "news": [
    { "date": "2026-10-14", "type": "espi", "label": "ESPI 12/2026", "title": "Tytuł komunikatu", "url": "https://…" },
    { "date": "2026-10-13", "type": "news", "label": "Nazwa serwisu", "title": "Tytuł wiadomości", "url": "https://…" }
  ],
  "meta": { "generated_at": "2026-10-17T10:00:00Z", "data_date": "2026-10-16", "disclaimer": "…", "source_name": "Giełda360.pl", "source_url": "https://gielda360.pl/" }
}

Kwoty w sekcji quote i kursy w chart są w złotych. Kapitalizację (market_cap) bierzemy z ostatniego rankingu ze skanera akcji – market_cap_date to dzień tych danych; gdy spółki nie ma w rankingu, oba pola mają wartość null. Pole chart.points to pary [data, kurs zamknięcia] od najstarszej sesji (do około 12 miesięcy wstecz; ostatni punkt to bieżący kurs), a news – najwyżej cztery najnowsze wiadomości o spółce, najnowsza pierwsza (type: espi, ebi albo news; label: numer komunikatu albo nazwa serwisu). Pola bez danych mają wartość null (chart – gdy historia kursów jest niedostępna). Interfejs nie wymaga klucza; prosimy o odpytywanie danego symbolu nie częściej niż co 5 minut.

Wymagania techniczne, prywatność i bezpieczeństwo

• Lekki i niezależny. Jeden plik JavaScript (około 17 KB po kompresji), bez bibliotek zewnętrznych. Styl widżetu jest odizolowany (Shadow DOM): style Twojej strony nie psują widżetu, a widżet nie zmienia wyglądu strony.
• Szybkie ładowanie. Skrypt ładuje się asynchronicznie (async), dane spółki wraz z notowaniami do wykresu i wiadomościami pobierane są jednym zapytaniem (około 2 KB po kompresji), bez dodatkowych skryptów i ramek. Zarezerwowane miejsce (min-height w kodzie) ogranicza przesuwanie treści strony w trakcie ładowania.
• Responsywność i dostępność. Widżet dopasowuje się do szerokości miejsca (od około 280 px), nie powoduje poziomego przewijania, ma motyw jasny i ciemny z kontrastem zgodnym z WCAG AA i można go obsłużyć klawiaturą.
• Prywatność. Zapytania do API Giełda360.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, a wykres rysuje sam z danych pobranych z Giełda360.pl – nie ładuje skryptów, ramek ani czcionek od osób trzecich. Odnośniki w widżecie (do serwisu i do źródeł wiadomości) otwierają się dopiero po kliknięciu.
• Polityka CSP. Jeśli Twoja strona używa nagłówka Content-Security-Policy, dodaj: script-src https://gielda360.pl; connect-src https://gielda360.pl – to wszystko, bo widżet nie używa ramek ani zasobów z innych domen. Przy własnej kopii skryptu w script-src wystarczy Twoja domena, a connect-src https://gielda360.pl zostaje. Widżet nie używa eval ani stylów w atrybutach, a atrybut style="min-height…" w kodzie jest opcjonalny (przy ścisłej polityce style-src zostanie zignorowany). Jeśli Twoja strona wymusza Trusted Types (require-trusted-types-for 'script'), dodaj do dyrektywy trusted-types nazwę polityki g360-widget; bez tego widżet się nie narysuje, a odwiedzający zobaczy statyczny odnośnik do profilu spółki z kodu osadzenia.
• Bezpieczeństwo. Wszystkie dane z API są zabezpieczane przed wstawieniem na stronę, a odnośniki do komunikatów ESPI/EBI otwierają się w nowej karcie z rel="noopener nofollow".
• Gdy brakuje danych. Przy błędzie sieci albo nieznanym symbolu widżet pokazuje komunikat „Dane spółki chwilowo niedostępne.” z odnośnikiem do profilu spółki – nie przerywa działania strony.

Pytania i odpowiedzi