Boursa
Read the docs Talk to us
Embedded investing infrastructure

Investing infrastructure for the Egyptian Exchange.

Open brokerage accounts, fund them, and trade EGX equities and funds — all through one REST API. A licensed broker holds the account and executes; you ship the experience. Built for enterprises and the developers who integrate them.

Developer quickstart Explore the docs →
The sandbox runs on simulated money — no approvals to start building.
Broker of record FRA-aligned EGX equities & funds T+2 settlement Whole-share, integer-precise HMAC-signed money path

One platform, two audiences

For the enterprises that launch investing, and the developers who build it.

Boursa is the infrastructure beneath the product — a regulated broker of record sits behind every account, so you never have to become one.

Enterprises

Banks · fintechs · super-apps · wealth platforms
  • Launch investing without a license. A licensed brokerage is broker of record — it executes, clears, and custodies under FRA Decision 332.
  • White-label by default. Themed statements, your branding, a dealer console for operations, and per-tenant reporting.
  • Compliance built in. KYC with human broker review, suitability gates, a shariah screen, and a hash-chained audit trail.

Developers

One REST API · a sandbox that just works
  • Predictable conventions. Bearer auth, idempotency keys, integer micros, stable string error codes, and webhooks.
  • A real sandbox. Simulated money against a production-grade backend, with a fast-forwardable market clock so you never wait for the open.
  • Documented end to end. Guides, a full API reference, and an OpenAPI spec at docs.boursa.sh.

The building blocks

Everything a full investing experience needs.

Accounts & KYC

Capture identity, route documents to the broker for review, and open accounts. List your whole book through one accounts endpoint.

Funding

Move cash in and out with signed, idempotent transfers. Settled, reserved, and unsettled buckets are tracked on a double-entry ledger.

Orders

Market and limit orders with time-in-force — day, gtc, ioc, fok. GTC orders rest across sessions and never self-expire.

Portfolio & analytics

Positions with cost basis and unrealized P/L, exposures, time-weighted return, and descriptive risk — never advice.

Market data & clock

Quotes, OHLCV candles, the tradable universe with issuer fundamentals, plus an EGX clock and trading calendar.

Safe money path

Integer micros end to end, HMAC-signed money endpoints, envelope-encrypted PII, and an immutable, hash-chained audit log.

Developer quickstart

From zero to a live order in the sandbox.

Every request hits https://sandbox.boursa.sh. Reads need only a Bearer key; money endpoints add an HMAC signature.

  1. Get sandbox credentialsAn api_key for Bearer auth and a signing_secret for the money-path signature.
  2. Read market stateCheck the EGX clock — no signature required.
  3. Place a signed orderSubmit a good-till-canceled limit order; track it via webhooks.

Full signing recipe and language samples in Authentication →

bash — sandbox.boursa.sh
# 1 · Read the market clock (Bearer only)
curl https://sandbox.boursa.sh/v1/clock \
  -H "Authorization: Bearer $BOURSA_API_KEY"
# → {"timestamp":"…","is_open":true,
#    "next_open":"…","next_close":"…"}
# 2 · Place a GTC limit order (HMAC-signed)
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"}'

Build the future of investing in Egypt.

Start in the sandbox today, then talk to us about taking your integration live with a licensed broker of record.

Get started Talk to us