Open accounts, fund them, and trade EGX equities, ETFs, and funds — with bonds, sukuk, indices, market data, corporate actions, a calendar, and news — through one REST API. Broker of record, FRA-aligned, settled T+2.
Caravan 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, ETFs, and money-market funds, follow bonds, sukuk, indices, market data, corporate actions, the calendar, and news, and see portfolio analytics — while a licensed brokerage acts as broker of record.
The universe is multi-asset: one alphabetical /v1/instruments list spans equities, ETFs, bonds, and sukuk (tagged by security_type), with funds on a separate NAV rail and indices as reference-only benchmarks. Market data adds an L2 order book, corporate actions, a trading & corporate calendar, and a bilingual news feed. New to a class? Start with the Asset classes guide or the Learn section.
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.
Every list is neutrally ordered — alphabetical, chronological, or time-recency. There are no rankings, scores, or "top picks"; yield, NAV, coupon, and index weight are disclosure, never a sort key. See Neutrality by construction for why (FRA Decision 332 / R1).
| Realm | Who | Auth |
|---|---|---|
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 desk | X-Console-Key (or a console sign-in session) |
Back office /admin/* | platform operations | X-Admin-Key (or an ops session) |
Most integrations live entirely in the Tenant API. Start with Getting started.
# The sandbox runs on simulated money. Bearer auth on read endpoints:
curl https://sandbox.boursa.sh/v1/clock \
-H "Authorization: Bearer $CARAVAN_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 $CARAVAN_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "X-Caravan-Timestamp: $TS" -H "X-Caravan-Signature: $SIG" \
-d '{"investor_id":"inv_…","symbol":"COMI","side":"buy",
"type":"limit","qty":10,"limit_price_micros":80000000,
"time_in_force":"gtc"}'