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

> 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.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.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.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.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.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.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.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.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.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 '{}'
```