Co APIluse.co.zm ↗
Access LuSE daily stock prices, LASI index, listed companies, debt instruments, and SENS announcements via a structured JSON API.
What is the Co API?
This API exposes 7 endpoints covering the Lusaka Securities Exchange (LuSE), returning structured JSON for daily trading data, the LASI All Share Index, listed equities and debt instruments, SENS announcements, and market news. The get_daily_market_data endpoint delivers a full snapshot of every listed security including ISIN, closing price, bid/ask, volume, and value traded — all scoped to the current trading day.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/633a3018-dd43-43a3-a730-22b193daeb22/get_daily_market_data' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace luse-co-zm-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.luse_api_lusaka_securities_exchange import LuSE, SensCategory, SecurityData, Company, StockPrice, DebtInstrument, Announcement, NewsItem
client = LuSE()
# Get all stock prices for the current trading day
for stock in client.markets.get_stock_prices():
print(stock.ticker, stock.company_name, stock.closing_price)
# Get full daily market data with bid/ask spreads
for security in client.markets.get_daily_data():
print(security.security, security.isin_code, security.closing_price, security.best_bid_price, security.best_ask_price)
# Get the LASI index summary
index = client.markets.get_index()
print(index.lasi_summary.current_value, index.lasi_summary.change, index.lasi_summary.percent_change)
print(index.market_capitalization.including_shoprite, index.market_capitalization.excluding_shoprite)
print(index.equity_market_summary)
# List all companies on the exchange
for company in client.markets.get_companies():
print(company.ticker, company.name, company.description)
# List debt instruments (corporate bonds)
for bond in client.markets.get_debt_instruments():
print(bond.name, bond.isin, bond.interest, bond.maturity_date, bond.status)
# Get SENS announcements filtered by category
for announcement in client.markets.get_sens(category=SensCategory.DIVIDENDS):
print(announcement.title, announcement.date, announcement.url)
# Get latest news from the homepage
for item in client.markets.get_news():
print(item.date, item.title)
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.
No input parameters required.
{
"type": "object",
"fields": {
"as_of_date": "string - date of the market data in DD/MM/YYYY format",
"stock_data": "array of SecurityData objects"
},
"sample": {
"data": {
"as_of_date": "09/06/2026",
"stock_data": [
{
"Trades": "4",
"Security": "AECI",
"ISIN code": "ZM0000000284",
"Price Change": "-",
"Volume Traded": "15",
"Best Ask Price": "121.00",
"Best Bid Price": "-",
"Best Ask Quantity": "475",
"Best Bid Quantity": "-",
"Value Traded (ZMW)": "1,815.00",
"Closing Price (ZMW)": "123.00"
}
]
},
"status": "success"
}
}About the Co API
Daily Market Data and Index
get_daily_market_data returns the complete daily stock table for all securities listed on the LuSE. Each row includes the security name, ISIN code, closing price in ZMW, price change, number of trades, volume traded, value traded, and best bid data. The as_of_date field is formatted as DD/MM/YYYY. For a lighter payload when you only need prices, get_stock_prices returns ticker, company name, and closing price with the same as_of_date field.
get_lasi_index returns the LuSE All Share Index summary: current index value, absolute and percentage change, trade count, volume, and value traded. It also returns market capitalization in two forms — including_shoprite and excluding_shoprite — reflecting the common practice of reporting Zambian market cap both ways due to Shoprite's outsized weight. An equity_market_summary narrative string provides a human-readable trading day summary.
Listed Companies and Debt Instruments
get_listed_companies returns every equity issuer on the exchange with its ticker symbol, full company name, and a plain-text description. get_listed_debt_instruments covers the LuSE corporate bond market, with fields including instrument name, face value, interest rate, ISIN, tenor in years, issue date, maturity date, and current status. These two endpoints provide the reference data layer for mapping ISINs and tickers returned by the market data endpoints.
SENS Announcements and News
get_sens_documents accepts an optional category parameter with four accepted slug values: general-announcements, financial-statements, dividends, and annual-reports. Each announcement object includes a title, date, and a direct download URL to the document. Omitting the category parameter defaults to all available announcements. get_latest_news returns headline news items from the LuSE homepage, each with a date and title string.
The Co API is a managed, monitored endpoint for luse.co.zm — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when luse.co.zm changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official luse.co.zm API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track daily closing prices and volume for all LuSE-listed equities using
get_daily_market_data. - Monitor LASI index movements and market-cap figures (with and without Shoprite) to gauge overall market direction.
- Build a corporate bond screener using maturity date, interest rate, and status fields from
get_listed_debt_instruments. - Subscribe to dividend announcements by polling
get_sens_documentswith thedividendscategory. - Maintain an up-to-date reference table of LuSE tickers and ISIN codes by joining
get_listed_companiesandget_daily_market_data. - Aggregate annual reports and financial statements for LuSE-listed issuers using the
annual-reportsandfinancial-statementsSENS categories. - Surface LuSE market news in a financial dashboard using the date and title fields from
get_latest_news.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does the Lusaka Securities Exchange provide an official developer API?+
What does `get_lasi_index` return, and why are there two market-cap figures?+
get_lasi_index returns the LASI summary object with current index value, change, percentage change, trades, volume, and value traded, plus an equity_market_summary narrative string. The market_capitalization object provides two figures — including_shoprite and excluding_shoprite — because Shoprite Holdings has a dominant weight on the LuSE and market participants commonly track both numbers to understand the underlying local market.Can I retrieve historical daily market data or LASI index history?+
get_daily_market_data and get_stock_prices; no historical time-series endpoint is included. You can fork this API on Parse and revise it to add a historical data endpoint if the source exposes prior trading sessions.Does `get_sens_documents` return the full text of announcements, or just metadata?+
category parameter with slugs: general-announcements, financial-statements, dividends, or annual-reports.Is government bond or Treasury bill data available through this API?+
get_listed_debt_instruments covers corporate bonds listed on the LuSE; government securities such as Treasury bills or government bonds are not included. You can fork this API on Parse and revise it to add an endpoint targeting government debt data if a suitable source is available.