czpm.cz

Veřejné API

REST rozhraní s JSON výstupem. Index politického rizika ČR, zprávy s doloženým dopadem na tituly pražské burzy a externí ratingy. Součást tarifu Business.

Základ

Adresa	`https://www.czpm.cz/api/public`
Metoda	`GET`
Autentizace	`Authorization: Bearer <api_key>`
Rozsah	parametr `?scope=`
Limit	100 požadavků za hodinu na klíč
Mezipaměť	`Cache-Control: max-age=300` — data se mění nejvýš po pěti minutách

curl "https://www.czpm.cz/api/public?scope=summary" \
  -H "Authorization: Bearer VAS_API_KLIC"

Klíč vydáváme zákazníkům tarifu Business. Napište na richtis91@gmail.com.

Odpověď

Každá odpověď má stejný obal, užitečná data jsou v data.

{
  "ok": true,
  "scope": "summary",
  "generated_at": "2026-08-01T12:00:00.000Z",
  "data": { ... },
  "_meta": {
    "source": "czpm.cz",
    "docs": "https://www.czpm.cz/api-docs",
    "rate_limit": { "per_hour": 100, "remaining": 97 }
  }
}

Rozsahy

`?scope=summary`

Aktuální hodnota indexu a počty zpráv za posledních 24 hodin a 7 dní, členěné podle dopadu.

{
  "index_nalady": { "value": 58, "date": "2026-07-31", "articles_total": 109 },
  "last_24h": { "total": 109, "by_impact": { "minimal": 64, "helps": 27, "harms": 18 } },
  "last_7d":  { "total": 143, "by_impact": { "minimal": 84, "helps": 35, "harms": 24 } }
}

`?scope=index`

Denní hodnoty indexu za posledních 90 dní. Vhodné pro graf nebo vlastní výpočty.

{
  "range_days": 90,
  "values": [
    { "date": "2026-07-30", "px": 55, "articles": 34 },
    { "date": "2026-07-31", "px": 58, "articles": 109 }
  ]
}

`?scope=top-news&limit=20`

Zprávy s doloženým dopadem za posledních 7 dní. Vrací jen ty, kde je impact jiný než neutrální. limit je nepovinný, výchozí 20, nejvýš 100.

{
  "range_days": 7,
  "count": 42,
  "news": [
    {
      "id": "a1b2c3",
      "title": "Vláda schválila novelu energetického zákona",
      "link": "https://vlada.gov.cz/...",
      "source": "Vláda ČR",
      "published_at": "2026-07-31T09:15:00Z",
      "sentiment": "negative",
      "impact": "harms",
      "topic": "energetika",
      "politicians": ["Andrej Babiš"],
      "stock_impacts": [{ "stock": "ČEZ", "direction": "negative", "strength": "high" }],
      "event_key": "energeticky-zakon-novela"
    }
  ]
}

`?scope=ratings`

Externí ratingy České republiky. Obnovují se jednou měsíčně.

{
  "country": "CZ",
  "ratings": [
    { "agency": "Moody's", "rating_grade": "Aa3", "effective_date": "2026-05-14",
      "source_url": "https://...", "verified_at": "2026-08-01T04:00:00Z" }
  ]
}

Chybové stavy

Kód	Kdy nastane
`401`	Chybí hlavička `Authorization`, nebo je klíč neplatný či po expiraci
`400`	Neznámý `scope`. Odpověď obsahuje seznam platných hodnot.
`405`	Jiná metoda než `GET`
`429`	Vyčerpaný limit. V odpovědi je `resetAt` jako unixový čas.
`500`	Chyba na naší straně

Zbývající kvótu vracíme v hlavičkách X-RateLimit-Limit, X-RateLimit-Remaining a X-RateLimit-Reset u každé odpovědi.

Jak číst hodnoty

Pole	Význam
`px`	Index 0–100. Nad 50 převažují kroky, které politické riziko snižují. Nepočítá se ze sentimentu, ale z věcného dopadu; každá zpráva vstupuje vahou podle toho, nakolik mění rozhodování. Riziko je `100 − px`.
`impact`	`harms` · `helps` · `mixed` · `minimal` — dopad na Českou republiku, ne na konkrétní firmu.
`sentiment`	Vyznění textu. Záměrně oddělené od `impact`: zpráva může být psaná negativně a přitom riziko snižovat.
`stock_impacts`	Dopad na konkrétní titul. `direction` je `negative` · `positive` · `neutral`, `strength` je `low` · `medium` · `high`. Když směr nelze doložit, titul se neuvádí vůbec.
`event_key`	Zprávy o téže události mají stejný klíč. Slouží ke slučování.

Metodika je veřejná. Vzorec indexu, váhy i pravidla klasifikace najdete v sekci Metodika přímo v aplikaci. Když si výsledek přepočítáte z dat, která vám API vrátí, musíte dojít ke stejnému číslu — a pokud ne, chceme o tom vědět.