Skip to content

Portfolio & positions

GET /v1/investors/{id}/portfolio

The overview: total value, cash, and positions with cost basis and unrealized P/L.

Position fieldNotes
asset / symbol
kindequity | fund | cash
qtywhole shares (equities)
price_microscurrent price
value_microsmarket value
cost_microscost basis
unrealized_micros / unrealized_pctP/L
weight_pctallocation

vs. Alpaca: maps to GET /v2/positions. Alpaca's market_valuevalue_micros, cost_basiscost_micros, unrealized_plunrealized_micros. All EGX positions are long (no shorting).

GET /v1/investors/{id}/portfolio/exposures

Sector exposures, HHI concentration, top-holding percentage.

GET /v1/investors/{id}/portfolio/performance?days=90

A daily time series plus time-weighted return (twr_pct). Maps to Alpaca's GET /v2/account/portfolio/history.

GET /v1/investors/{id}/portfolio/risk?days=60

Descriptive risk statistics: annualized volatility, max drawdown, 1-day VaR(95), and beta vs the EGX30 index. Descriptive only — not advice.

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