Narzędzie publiczne · get_public_price_history

Historia cen akcji GPW

Zapisane dzienne świece OHLCV dla akcji z GPW, do 500 świec w oknie od 1 do 3650 dni. Odpowiedź podaje źródło, czas aktualizacji serii, faktyczne daty pierwszej i ostatniej świecy oraz skalę cen.

Działa bez konta i klucza API przez serwer MCP pod adresem https://agentrynku.pl/api/mcp. Jak podłączyć klienta.

Kiedy użyć

Agent ma policzyć stopę zwrotu, zmienność albo narysować wykres.
Potrzebujesz kursu z konkretnego dnia razem z informacją, czy cena jest skorygowana.

Parametry

Parametr	Typ	Wymagany	Domyślnie	Zakres	Opis
`symbol`	string	tak		do 80 znaków	Ticker, nazwa, alias albo ISIN spółki z GPW, np. `KGHM` lub `PLKGHM000017`.
`days`	integer	nie	365	1-3650	Okno wstecz w dniach kalendarzowych.
`limit`	integer	nie	250	1-500	Maksymalna liczba pozycji w odpowiedzi.

Przykładowe wywołanie

Agent wywoła narzędzie sam, gdy zadasz pytanie. Te same dane pobierzesz bezpośrednio przez JSON-RPC:

curl -sS https://agentrynku.pl/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_public_price_history","arguments":{"symbol":"KGHM","days":7,"limit":3}}}'

Przykładowa odpowiedź

Prawdziwa odpowiedź serwera z 5 października 2026. Listy skróciliśmy do dwóch pozycji.

{
  "symbol": "KGHM",
  "universe": "polish-stocks",
  "assetId": "69ed03a9aed8a51a4f606dea",
  "interval": "1d",
  "requestedLookbackDays": 7,
  "limit": 3,
  "currency": null,
  "source": "eodhd:droplet",
  "seriesUpdatedAt": "2026-10-05T17:33:11.292Z",
  "firstCandleAt": "2026-09-30T00:00:00.000Z",
  "lastCandleAt": "2026-10-02T00:00:00.000Z",
  "availableInWindow": 4,
  "candleCount": 3,
  "truncated": true,
  "candles": [
    {
      "ts": "2026-09-30T00:00:00.000Z",
      "open": 326,
      "high": 336.8,
      "low": 324.9,
      "close": 329.55,
      "volume": 682593,
      "priceScale": "adjusted",
      "adjustmentFactor": 1,
      "adjustmentSource": "eodhd:adjusted_close/close"
    },
    {
      "ts": "2026-10-01T00:00:00.000Z",
      "open": 331,
      "high": 331.2,
      "low": 319.5,
      "close": 321.2,
      "volume": 835173,
      "priceScale": "adjusted",
      "adjustmentFactor": 1,
      "adjustmentSource": "eodhd:adjusted_close/close"
    }
  ],
  "emptyReason": null,
  "coverage": "Stored GPW daily OHLCV only. Coverage may be shorter than the requested window. Currency null and priceScale unknown mean unrecorded metadata. Adjusted history may be revised after corporate actions; this is not an intraday or live quote."
}

Na co uważać

Tylko akcje. Indeksy, ETF-y i obligacje nie są objęte.
To historia z bazy, a nie bieżący kurs. Notowania w trakcie sesji wymagają klucza (get_intraday_quote).
Historia skorygowana (priceScale: adjusted) może się zmienić po splicie albo dywidendzie.
Gdy dane zaczynają się później niż żądane okno, odpowiedź to mówi. Nie dostaniesz dopełnionych świec.

O co zapytać agenta

„Pokaż notowania KGHM z ostatniego tygodnia.”
„Ile zyskał CD Projekt przez ostatni rok?”

Opis narzędzia dla modelu

Tak serwer opisuje narzędzie w tools/list. Ten tekst czyta model, wybierając narzędzie:

Stored GPW daily OHLCV price history without an account. Returns the latest up to 500 candles within 1-3650 calendar days, in chronological order, with truncation, source, stored-series update timestamp and actual candle dates. Coverage may be shorter than requested. Per-candle priceScale and adjustment metadata are preserved; unknown means unrecorded, currency null means not recorded. Adjusted history can change after splits or dividends. No intraday, live quote or supplier fetch on demand. GPW equities only, excluding indices, ETFs and bonds; use ticker or ISIN.

Pozostałe publiczne narzędzia

Portfel, alerty, prognozy i notowania w trakcie sesji są w pełnym katalogu i wymagają klucza API.