# Kurzy — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Track Czech and international stock quotes, exchange rates, commodities, and cryptocurrencies with real-time financial data from Kurzy.cz. Search for stocks, view dividend information, and stay updated with the latest financial news all in one place.

**Category:** Finance & Markets | **Website:** [kurzy.cz/](https://kurzy.cz/) | **Docs:** [parse.bot/marketplace/c2e89e5e-d77a-487f-b137-6cf74302f0e4/kurzy-cz-api](https://parse.bot/marketplace/c2e89e5e-d77a-487f-b137-6cf74302f0e4/kurzy-cz-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-kurzy-cz-api-c2e89e5e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_cnb_exchange_rates

Retrieve the current Czech National Bank (ČNB) official exchange rates for major world currencies against CZK. Includes the currency name, ISO code, unit amount, and the CZK rate. Updated daily by ČNB. Single-page, returns all published rates.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kurzy-cz-api-c2e89e5e/get_cnb_exchange_rates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_commodity_prices

Get current prices for major traded commodities including precious metals (gold, silver, platinum, palladium), crude oil (Brent, WTI), heating oil, and natural gas. Prices are in their standard trading units. Returns the commodity name, current price, and daily percentage change.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kurzy-cz-api-c2e89e5e/get_commodity_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_crypto_prices

Get current cryptocurrency prices in both USD and CZK for major cryptocurrencies including Bitcoin, Ethereum, Litecoin, Monero, XRP, and others tracked by Kurzy.cz. Returns the crypto name and prices in both currencies.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kurzy-cz-api-c2e89e5e/get_crypto_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_czech_stock_list

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.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kurzy-cz-api-c2e89e5e/get_czech_stock_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_financial_news

Get the latest financial and economic news articles from the Kurzy.cz news portal (zpravy.kurzy.cz). Returns article titles and full URLs. Covers Czech economic policy, corporate news, market commentary, and international finance. Single-page, returns the current front page articles.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kurzy-cz-api-c2e89e5e/get_financial_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_stock_detail

Get detailed real-time and summary stock data for a specific Czech company listed on BCPP and/or RMS markets. Returns the stock name, slug, and a markets object containing key-value pairs of trading data (current price, volume, min/max, order book) for each market where the stock trades. Requires a slug obtained from get_czech_stock_list or search_stocks.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The stock slug identifier (e.g. 'cez-183', 'komercni-banka-590'). Obtain from get_czech_stock_list or search_stocks results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kurzy-cz-api-c2e89e5e/get_stock_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_stock_dividends

Retrieve the full dividend payment history for a specific Czech stock. Returns chronologically ordered records with ex-date, dividend amount, currency, record date, and the stock price at the time. Some stocks may have no dividend history (empty array is valid). Requires a slug obtained from get_czech_stock_list or search_stocks.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The stock slug identifier (e.g. 'cez-183'). Obtain from get_czech_stock_list or search_stocks results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kurzy-cz-api-c2e89e5e/get_stock_dividends \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### search_stocks

Search for Czech and international stocks by name or ticker symbol on the Kurzy.cz portal. Returns matching stock names and slug identifiers that can be passed to get_stock_detail and get_stock_dividends. Results are limited to stocks listed on Czech exchanges (BCPP/RMS).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword such as a company name or ticker (e.g. 'CEZ', 'KB', 'erste'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kurzy-cz-api-c2e89e5e/search_stocks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```