# Uzse — 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.

> Monitor live stock quotes and detailed intraday trading data from the Tashkent Stock Exchange, including historical prices, listed companies, and complete securities information. Access real-time trade results and comprehensive market data to track investment opportunities across all exchange-listed securities.

**Category:** Finance & Markets | **Website:** [uzse.uz/](https://uzse.uz/) | **Docs:** [parse.bot/marketplace/ac87093a-90fe-4435-863d-106b37dba3d9/uzse-uz-api](https://parse.bot/marketplace/ac87093a-90fe-4435-863d-106b37dba3d9/uzse-uz-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-uzse-uz-api-ac87093a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_listings

List all companies admitted to the exchange listing. Each entry includes the listing category (Premium, Standard, or Bond), ticker, ISIN code, issuer name, listing date, currency, nominal value, and outstanding share count. Optionally filter by company name substring.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `search` | string | No | Substring filter applied to the company/issuer name. Empty string returns all listings. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-uzse-uz-api-ac87093a/get_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"search":"<string>"}'
```

### get_securities

List all securities registered on the exchange. Each security includes its ISIN code, ticker symbol, and company name. Filter by market type to separate stocks from bonds. Returns the full catalog in a single page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `market_type` | string | No | Market segment to query. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-uzse-uz-api-ac87093a/get_securities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"market_type":"<string>"}'
```

### get_stock_detail

Fetch detailed stock data for a single security. Returns today's price summary (opening, high, low), all intraday trades with timestamps and prices, and historical daily closing prices with volumes. Provide either the ISIN security_code or the ticker symbol; if only ticker is given, the ISIN is resolved via the securities catalog.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `security_code` | string | No | ISIN security code (e.g. 'UZ7011340005'). Either security_code or ticker is required. |
| `ticker` | string | No | Stock ticker symbol (e.g. 'HMKB'). Either security_code or ticker is required. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-uzse-uz-api-ac87093a/get_stock_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"security_code":"<string>","ticker":"<string>"}'
```

### get_stock_quotes

Retrieve live stock price quotes from the exchange homepage ticker banner. Each quote carries the closing price, last trade price, change direction/value, and last trade date. Also returns the most recent trade transactions visible on the homepage.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-uzse-uz-api-ac87093a/get_stock_quotes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_trade_results

Retrieve executed trade transactions from the exchange. Each trade shows the timestamp, security code, issuer, security type, market, platform, price, quantity, and volume. Filter by market type, date range (DD.MM.YYYY format), and issuer name.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date_from` | string | No | Start date filter in DD.MM.YYYY format. Empty string means no lower bound. |
| `date_to` | string | No | End date filter in DD.MM.YYYY format. Empty string means no upper bound. |
| `market_type` | string | No | Market segment filter. Empty string returns all markets. |
| `search` | string | No | Substring filter applied to the issuer name. Empty string returns all issuers. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-uzse-uz-api-ac87093a/get_trade_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_from":"<string>","date_to":"<string>","market_type":"<string>","search":"<string>"}'
```