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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/luse/`
**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 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/credits/luse/get-daily-market-data \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/luse/get-lasi-index \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/luse/get-latest-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/luse/get-listed-companies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/luse/get-listed-debt-instruments \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/luse/get-sens-document-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/luse/get-sens-documents \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/luse/get-stock-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

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