Environments
| Sandbox | Production | |
|---|---|---|
| API base | https://sandbox.boursa.sh | broker-gateway host (pending EGX certification) |
| Console | https://console.boursa.sh | — |
| Money | simulated | real |
| Clock | a fast-forwardable sim clock | wall-clock EGX session |
| Market data | deterministic sim tape | live EGX feed |
The whole platform runs in sandbox until the broker gateway is EGX-certified; promotion to live is platform-side (BOURSA_ENV) and does not change the client contract — the same code points at the production host.
The sandbox clock
EGX trades Sun–Thu, 10:00–14:30 Africa/Cairo. To avoid waiting for market hours, advance the simulated clock:
bash
curl -X POST https://sandbox.boursa.sh/admin/sandbox/clock-advance \
-H "X-Admin-Key: $ADMIN_KEY" -d '{"hours":2}' # or {"days":1}Query it any time with GET /v1/clock.
Other sandbox controls
POST /admin/sandbox/ endpoints let you drive the sim: quote, nav, halt, auto-fill (route orders to the dealer desk instead of auto-filling), inject-break, declare-dividend. See the back-office reference.