# Luse — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.

> Access real-time market data, index performance, and company information from the Lusaka Securities Exchange, including daily trading data, listed companies and debt instruments, SENS announcements, and the latest financial news. Monitor market trends and stay informed on securities exchange activity across Zambia's capital markets.

**Category:** Finance & Markets | **Website:** [luse.co.zm/](https://luse.co.zm/) | **Docs:** [parse.bot/marketplace/d279fa0e-4a5a-45b0-a628-548d6b40f829/luse-co-zm-api](https://parse.bot/marketplace/d279fa0e-4a5a-45b0-a628-548d6b40f829/luse-co-zm-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/parse-luse-co-zm-api-d279fa0e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### Get daily market data

Returns the full Daily Stock Data table for the current trading day. Includes ISIN, closing price, trades, volume, bid/ask data for all listed securities on the LuSE. No pagination — all securities returned in a single response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-luse-co-zm-api-d279fa0e/get_daily_market_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get lasi index

Returns the current LASI (LuSE All Share Index) summary including current value, change, trades, volume, and market capitalization, plus the equity market trade summary narrative. Single-page response for the current trading day.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-luse-co-zm-api-d279fa0e/get_lasi_index \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get latest news

Returns the latest news items from the LuSE homepage, including date and title. Single-page response with the most recent news items displayed on the homepage.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-luse-co-zm-api-d279fa0e/get_latest_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get listed companies

Returns a list of all companies listed on the LuSE with their ticker symbol, full name, and a description of the company. Single-page response covering all listed equities.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-luse-co-zm-api-d279fa0e/get_listed_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get listed debt instruments

Returns a list of all listed debt instruments (corporate bonds) on the LuSE, including name, value, interest rate, ISIN, tenor, issue date, maturity, and status. Single-page response covering all listed bonds.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-luse-co-zm-api-d279fa0e/get_listed_debt_instruments \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get sens document detail

Returns metadata and PDF download link for a single SENS (Stock Exchange News Service) notice page. Accepts the full URL of the notice detail page on luse.co.zm. Returns the announcement title, publication date, category, and the direct PDF download URL. One network round trip per call.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of a SENS notice detail page on luse.co.zm (e.g. from get_sens_documents announcements[*].url). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-luse-co-zm-api-d279fa0e/get_sens_document_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Get sens documents

Returns SENS (Stock Exchange News Service) announcements for a given category, including title, date, and URL. Supports pagination via the page parameter; each page returns up to 10 announcements. Returns the current page number and total available pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | SENS category slug. Accepted values: general-announcements, financial-statements, dividends, annual-reports. |
| `page` | integer | No | Page number for pagination (1-based). Omitting returns the first page. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-luse-co-zm-api-d279fa0e/get_sens_documents \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>"}'
```

### Get stock prices

Returns ticker symbol, company name, and closing price (in ZMW) for all listed securities on the current trading day. A simplified view of market data focused on prices only.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-luse-co-zm-api-d279fa0e/get_stock_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```