Boursa Docs

Appearance

BoursaInvesting infrastructure for the Egyptian Exchange

Open accounts, fund them, and trade EGX equities and funds through one REST API. Broker of record, FRA-aligned, settled T+2.

Get started
API reference
Conventions

A familiar REST model

A conventional brokerage order model — market and limit types, time-in-force (day/gtc/ioc/fok), a complete order object with a clear status vocabulary and lifecycle timestamps, plus /v1/clock and /v1/calendar. If you've integrated a modern trading API, you'll feel at home.

Broker of record

A licensed brokerage holds the account, executes orders, and custodies cash and securities (FRA Decision 332). Boursa is the infrastructure beneath many brokers — with tenant, broker, and investor dimensions.

Built for EGX

Price bands (±20%), tick sizes, whole-share quantities, T+2 settlement, the Sun–Thu 10:00–14:30 session, and the per-order fee ceiling are enforced on every order — so you don't have to.

Safe money path

Integer micros end to end (no float drift), HMAC-signed money endpoints, idempotency keys, a hash-chained audit log, and envelope-encrypted PII. The sandbox runs on simulated money with a fast-forwardable clock.

What Boursa is ​

Boursa is embedded-investing infrastructure for the Egyptian Exchange (EGX). A fintech (a tenant) integrates one REST API to give its users a full investing experience: open a brokerage account (KYC), fund it, buy and sell EGX equities and money-market funds, and see portfolio analytics — while a licensed brokerage acts as broker of record.

The API follows the conventions a brokerage integrator already expects — REST resources, an order object with a clear status vocabulary, a clock and calendar — so the learning curve is short. Where EGX market structure or our broker-of-record model shapes a decision, the reasoning is documented in Conventions.

Three realms ​

RealmWhoAuth
Tenant API /v1/*your backend (and your users' app)Authorization: Bearer <api_key>; money endpoints add an HMAC signature
Dealer console /broker/v1/*the brokerage's dealer deskX-Console-Key (or a console sign-in session)
Back office /admin/*platform operationsX-Admin-Key (or an ops session)

Most integrations live entirely in the Tenant API. Start with Getting started.

A 60-second taste ​

bash
# The sandbox runs on simulated money. Bearer auth on read endpoints:
curl https://sandbox.boursa.sh/v1/clock \
  -H "Authorization: Bearer $BOURSA_API_KEY"
# → {"timestamp":"…","is_open":true,"next_open":"…","next_close":"…"}

# Place a good-till-canceled limit order (money endpoints are HMAC-signed —
# see Authentication). Whole shares, integer micros, EGX bands enforced:
curl -X POST https://sandbox.boursa.sh/v1/orders \
  -H "Authorization: Bearer $BOURSA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "X-Boursa-Timestamp: $TS" -H "X-Boursa-Signature: $SIG" \
  -d '{"investor_id":"inv_…","symbol":"COMI","side":"buy",
       "type":"limit","qty":10,"limit_price_micros":80000000,
       "time_in_force":"gtc"}'

Embedded investing infrastructure for the Egyptian Exchange. Sandbox runs on simulated money.

© Boursa