# Jett — 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 and analyze Uzbekistan's stock market by accessing real-time stock listings, detailed company profiles, live order books, and historical price data to make informed trading decisions. Monitor price movements with OHLC candle charts and compare market opportunities across listed companies on the Jett.uz exchange.

**Category:** Finance & Markets | **Website:** [app.jett.uz/stock/642](https://app.jett.uz/stock/642) | **Docs:** [parse.bot/marketplace/44138430-c0b2-4ffb-8de2-7e548ca32751/app-jett-uz-api](https://parse.bot/marketplace/44138430-c0b2-4ffb-8de2-7e548ca32751/app-jett-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-app-jett-uz-api-44138430/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_orderbook

Get the current order book (bid/ask depth) for a specific stock. Returns up to 10 price levels on each side with volume, order count, and percentage data, plus session trading summary (open, high, low, last, volume, price limits).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `stock_id` | string | Yes | Numeric stock ID (e.g. 642 for UZTL). Obtain from list_stocks results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-app-jett-uz-api-44138430/get_orderbook \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"stock_id":"<string>"}'
```

### get_stock_candles

Get historical OHLCV (open, high, low, close, volume) candlestick data for a specific stock. Used for charting and technical analysis. Returns candles in chronological order.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `interval` | string | No | Candle interval. |
| `limit` | integer | No | Maximum number of candles to return (max 300). |
| `stock_id` | string | Yes | Numeric stock ID (e.g. 642 for UZTL). Obtain from list_stocks results. |
| `to` | string | No | Unix timestamp (seconds) for the end of the data range. Defaults to current time if omitted. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-app-jett-uz-api-44138430/get_stock_candles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"interval":"<string>","limit":"<integer>","stock_id":"<string>","to":"<string>"}'
```

### get_stock_details

Get comprehensive details for a specific stock including company information, financial indicators (revenue, profit, equity, assets, liabilities by quarter/year), valuation multiples (PE, PB, PS, DE, ROA, ROE), dividend history, free float data, stock splits, and connected securities.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `stock_id` | string | Yes | Numeric stock ID (e.g. 642 for UZTL). Obtain from list_stocks results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-app-jett-uz-api-44138430/get_stock_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"stock_id":"<string>"}'
```

### list_stocks

Search and list stocks and bonds on the Uzbekistan stock exchange. Returns paginated results with current price, volume, growth percentages, and market cap.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cat_id` | string | No | Category/sector ID to filter by. Values: 1 (Finance), 2 (Insurance), 3 (Energy), 4 (Industry), 5 (Others), 6 (Construction), 7 (Agriculture), 8 (Lease), 9 (Communications and IT), 10 (Transportation), 11 (Funds). |
| `limit` | integer | No | Number of results per page (max 50). |
| `market_code` | string | No | Market/paper type code to filter by. |
| `offset` | integer | No | Pagination offset (number of records to skip). |
| `order_by` | string | No | Sort order. |
| `period` | string | No | Time period for volume/growth metrics. |
| `query` | string | No | Search query to filter by ticker or company name. |
| `sort_by` | string | No | Field to sort results by. Accepted values: gross_trade_amount, value, volume_today, growth_prcnt_today, market_cap, trades_today. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-app-jett-uz-api-44138430/list_stocks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cat_id":"<string>","limit":"<integer>","market_code":"<string>","offset":"<integer>","order_by":"<string>","period":"<string>","query":"<string>","sort_by":"<string>"}'
```