# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/uzse/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/uzse/get-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/uzse/get-securities \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/uzse/get-stock-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/uzse/get-stock-quotes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/uzse/get-trade-results \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"date_from":"<string>","date_to":"<string>","market_type":"<string>","search":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.