Kurzy APIkurzy.cz ↗
Access Czech stock quotes, CNB exchange rates, commodity prices, crypto data, and financial news from Kurzy.cz via 8 structured JSON endpoints.
What is the Kurzy API?
The Kurzy.cz API exposes 8 endpoints covering Czech and international financial data from the Kurzy.cz portal, including Prague Stock Exchange (BCPP) listings, CNB official exchange rates, commodity prices, and cryptocurrency quotes. The get_stock_detail endpoint returns per-market order book data for both BCPP and RMS markets, while get_stock_dividends gives a full dividend history with ex-dates, amounts, and contemporaneous share prices.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/ef0457d9-f2f0-42d3-aceb-d10588733298/get_czech_stock_list' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace kurzy-cz-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.kurzy_cz_financial_data_api import Kurzy, StockSummary, Stock, StockNotFound
kurzy = Kurzy()
# List Czech stocks from Prague Stock Exchange
for summary in kurzy.stocksummaries.list():
print(summary.name, summary.price, summary.change)
# Search for a specific stock
results = kurzy.stocksummaries.search(query="CEZ")
for match in results:
print(match.name, match.slug)
# Get detailed stock data and navigate to dividends
stock = kurzy.stocks.get(slug="cez-183")
print(stock.name, stock.slug)
for dividend in stock.dividends.list():
print(dividend.ex_date, dividend.amount, dividend.currency)
# Use constructible shorthand to access dividends directly
cez = kurzy.stock(slug="cez-183")
for div in cez.dividends.list():
print(div.ex_date, div.amount, div.price)
# Navigate from a search result to the detail
for match in kurzy.stocksummaries.search(query="KB"):
detail = match.details()
print(detail.name, detail.markets)
# Exchange rates
for rate in kurzy.exchangerates.list():
print(rate.currency, rate.code, rate.amount, rate.rate)
# Commodities
for commodity in kurzy.commodities.list():
print(commodity.name, commodity.price, commodity.change)
# Cryptocurrencies
for crypto in kurzy.cryptos.list():
print(crypto.name, crypto.price_usd, crypto.price_czk)
# Financial news
for article in kurzy.articles.list():
print(article.title, article.url)
Retrieve the list of Czech stocks from the Prague Stock Exchange (BCPP). Returns all actively traded Czech equities with their current price, daily percentage change, trading volume, and a slug identifier usable for detail/dividend lookups. Single-page, no pagination.
No input parameters required.
{
"type": "object",
"fields": {
"stocks": "array of stock summary objects with name, slug, price, change, and volume"
},
"sample": {
"data": {
"stocks": [
{
"name": "ČEZ",
"slug": "cez-183",
"price": "1254.00",
"change": "-1.42%",
"volume": "147.04 mil."
}
]
},
"status": "success"
}
}About the Kurzy API
Czech Stock Data
get_czech_stock_list returns an array of Prague Stock Exchange equities, each with name, slug, price, change, and volume. Slugs from this response (e.g. cez-183, komercni-banka-590) feed directly into get_stock_detail and get_stock_dividends. get_stock_detail goes deeper: the markets object contains separate keys for BCPP and RMS, each holding key-value pairs of market data including prices and volume figures. search_stocks lets you locate a slug by company name or ticker (e.g. CEZ, erste) when you don't already have it.
Dividend History and Corporate Events
get_stock_dividends returns a dividends array for any supported Czech stock. Each record includes ex_date, amount, currency, record_date, and the share price at the time of the dividend. This makes it straightforward to reconstruct yield history or screen for dividend-paying Czech equities without additional cross-referencing.
Exchange Rates, Commodities, and Crypto
get_cnb_exchange_rates returns the Czech National Bank's official daily rates for major currencies against CZK, with fields for currency, code, amount, and rate. get_commodity_prices covers gold, silver, platinum, palladium, oil, and natural gas with name, price, and change. get_crypto_prices returns major cryptocurrencies with prices denominated in both USD and CZK (price_usd, price_czk), which is useful when building tools for Czech-market users.
Financial News
get_financial_news returns the latest articles from the Kurzy.cz news portal as an array of objects containing title and url. News items are not filtered by category or topic at the endpoint level; the response reflects the current top items from the portal's news feed.
The Kurzy API is a managed, monitored endpoint for kurzy.cz — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when kurzy.cz changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official kurzy.cz API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a Prague Stock Exchange dashboard using
get_czech_stock_listprice and volume fields - Track Czech equity dividend yield over time using
get_stock_dividendsex-dates and amounts - Display CNB official CZK exchange rates in a currency converter app via
get_cnb_exchange_rates - Show commodity spot prices (gold, oil, natural gas) alongside Czech equity data using
get_commodity_prices - Present Bitcoin and Ethereum prices in CZK for Czech-market crypto apps via
get_crypto_prices - Alert users to relevant Czech financial news by polling
get_financial_newsfor new article titles - Resolve company names or tickers to slugs for downstream detail lookups using
search_stocks
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Kurzy.cz offer an official developer API?+
What does `get_stock_detail` return that `get_czech_stock_list` doesn't?+
get_czech_stock_list gives a top-level view: name, slug, price, change, and volume across all listed stocks. get_stock_detail focuses on a single stock and returns a markets object with separate BCPP and RMS sections, each containing granular key-value market data including order book information not present in the list endpoint.Does the API cover international (non-Czech) stocks in detail?+
search_stocks can return slugs for international equities listed on Kurzy.cz, but the detailed endpoints (get_stock_detail, get_stock_dividends) are oriented toward Czech stocks traded on BCPP and RMS. Full detail coverage for foreign exchanges is not guaranteed. You can fork this API on Parse and revise it to add endpoints targeting specific international market pages on the portal.