algierex (Python)

Python SDK for the Algierex market data API: the Algerian exchange's daily prices back to 1999, sessions, the Dzair index, the OAT yield curve, exchange rates, company events and news.

No dependencies. Python 3.9 or newer.

Install

pip install algierex            # or "algierex[pandas]" for to_frame()

Get a key

Create a key and choose a plan at algierex.com/developers. Then:

export ALGIEREX_API_KEY=alx_...

Example

from algierex import Algierex, PaymentRequiredError, to_frame

client = Algierex()  # reads ALGIEREX_API_KEY

try:
    client.list_tickers()
except PaymentRequiredError as err:
    raise SystemExit(f"{err}")  # no active plan: choose one at algierex.com/developers

# Every daily close of Saidal since 2025, as a pandas DataFrame.
prices = to_frame(client.get_prices("SAI", from_="2025-01-01"))
print(prices["close"].tail())

# The OAT yield curve on a past date.
curve = client.get_yield_curve(date="2026-09-30")
print(curve["asOf"], curve["fit"]["rSquared"] if curve["fit"] else "not enough trades")

# Upcoming company events, in French.
for event in client.get_calendar(from_="2026-11-01", locale="fr"):
    print(event["date"], event["ticker"], event["label"])

Methods

from is a Python keyword, so the parameter is from_. Every response is plain JSON (dicts and lists), typed with TypedDicts.

Paging

Paging is automatic: list methods return every row. For long histories, the iter_* twin yields rows as pages arrive:

for day in client.iter_prices("SAI"):
    ...

page_size (1 to 1000, default 1000) sets rows per request; the default keeps calls against your plan's limits low.

Errors

Every error raises a subclass of AlgierexError, with .status and .code:

On a 429 the client waits Retry-After and retries, up to max_retries (default 3) and only for waits up to max_retry_wait seconds (default 60). Algierex(max_retries=0) raises at once. Server errors (5xx), timeouts (timeout=30 seconds) and network failures raise AlgierexError and are not retried.

Regenerating

This SDK is generated from the API's OpenAPI spec. From the repository root, after npm install: npm run sdk.