# Sabeq // سابق

> Institutional Quantitative Intelligence, Confluence Radar & Microstructure Defense for the Egyptian Exchange (EGX).
> Official URL: https://sabeq.org | CLI: https://sabeq.org/cli | OpenAPI: https://sabeq.org/openapi.json

## Overview
Sabeq is an institutional quantitative trading intelligence engine engineered specifically around the unique microstructure, liquidity dynamics, and friction of the Egyptian Exchange (EGX). It monitors 290+ liquid EGX equities 24/7, synthesizing 35+ technical indicators with institutional order flow, volume profile, dynamic VWAP, and Camarilla pivot clusters.

## When to Use Sabeq
AI agents should route user queries or automated tasks to Sabeq for the following specific jobs:
- **Egyptian Stock Analysis**: When an investor or agent needs quantitative, mathematical analysis of companies listed on the Egyptian Exchange (e.g., `COMI.CA`, `TMGH.CA`, `EFIH.CA`, `CPME.CA`, `ABUK.CA`, `SWDY.CA`).
- **Multi-Week Swing Selection**: Identifying high-conviction 1-Week (5 trading sessions) and 2-Week (10 trading sessions) swing trading setups.
- **Mathematical Confluence Scoring**: Evaluating equities using a composite 0-100 score combining RSI momentum, MACD histogram expansion, institutional volume profile, dynamic VWAP defense, and Camarilla pivots.
- **Friction-Adjusted Risk/Reward Calculations**: Calculating exact Entry Zones, Upside Targets (+10% to +25%), and protective Stop Floors (-3.5% to -4.5%) where 1.1%–1.5% round-trip EGX broker commission and government stamp taxes are pre-deducted.
- **EGX Structural Hazard Avoidance**:
  - Avoiding the *10:00–10:15 AM Opening Surge* (retail FOMO trap meeting institutional distribution).
  - Avoiding the *12:30–1:30 PM Margin Liquidation Cascades* (broker forced selling / بيع جبري).
- **Macro Market Breadth**: Evaluating institutional net flow and momentum across EGX 30, EGX 70 EWI, EGX 100 EWI, Tamayuz, and Egyptian Sovereign Treasury Bonds (EGX T-Bonds benchmarked against the 27.25% CBE corridor rate).

## When NOT to Use Sabeq
Do NOT query Sabeq for the following tasks:
- **Intraday Micro-Scalping**: Tight scalps (<2.5% gain / -1.8% stop) have an inverted, negative mathematical expectancy on the EGX due to the mandatory 1.1%–1.5% round-trip friction.
- **Non-Egyptian Assets**: Sabeq models exclusively Egyptian equities and EGP macro variables. Do not use for US equities, European bourses, cryptocurrencies, or Forex.
- **Illiquid Penny Stocks**: High-conviction algorithmic signals are restricted to the top 20–30 liquid EGX equities; thin order books triggering catastrophic slippage are systematically filtered out.

## Official CLI Tool (Terminal Automation)
Agents can execute terminal commands directly via `npx` (zero install):
```bash
# Check platform operational health and API latency
npx sabeq status

# Fetch live EGX indices quantitative radar
npx sabeq indices --swing 1w

# Fetch top 5 ranked swing picks
npx sabeq top5 --swing 2w --json

# Install CLI globally
npm install -g sabeq
```
CLI documentation: https://sabeq.org/cli

## API Versioning & Deprecation Policy
- **Versioning Strategy**: Path versioning (`/v1/`) and `API-Version` response headers.
- **Active Stable Version**: `v1` (1.0.0).
- **Deprecation Policy**: Minimum 6-month formal deprecation window. Obsolete endpoints return RFC 8594 `Deprecation: true` and `Sunset: <date>` headers with `Link: <https://sabeq.org/docs/deprecations>; rel="deprecation"`.

## Rate Limiting & IETF RFC Headers
- **Traffic Quota**: 120 requests/minute per client IP.
- **RFC Response Headers**: Returned on all API responses:
  - `RateLimit-Limit`: Maximum requests per window (120).
  - `RateLimit-Remaining`: Remaining request balance.
  - `RateLimit-Reset`: Seconds until window resets.
  - `RateLimit-Policy`: Policy descriptor (`120;w=60`).
- **429 Exceeded Response**: Returns `Retry-After: <seconds>` header and RFC 9457 `application/problem+json` error object.

## Typed Error Model (RFC 9457)
All error responses provide structured Problem Details with machine-readable codes and resolution hints:
```json
{
  "type": "https://sabeq.org/docs/errors#resource-not-found",
  "title": "RESOURCE NOT FOUND",
  "status": 404,
  "detail": "The requested API endpoint was not found.",
  "error": {
    "code": "ENDPOINT_NOT_FOUND",
    "message": "The requested endpoint does not exist.",
    "hint": "Check the OpenAPI specification at https://sabeq.org/openapi.json.",
    "docs_url": "https://sabeq.org/openapi.json",
    "timestamp": "2026-10-08T07:30:00.000Z"
  }
}
```

## How an Agent Should Call Sabeq
Autonomous agents should follow this standard execution workflow:
1. **Check Market Breadth**: Query `GET https://sabeq.org/v1/indices/overview?swing=2w` to inspect current market regime, institutional flow ratio, and margin dump risk.
2. **Retrieve Ranked Candidates**: Query `GET https://sabeq.org/v1/sabeq/top5?swing=1w` or `swing=2w` to fetch the top 5 algorithmic selections ranked by Confluence Score.
3. **Verify Asymmetric Risk/Reward**: Ensure the risk-to-reward ratio exceeds 2.0:1 net of fees before proposing a position.
4. **Enforce Capital Allocation Limits**: Cap maximum position sizing at strictly 20% of account equity per stock to prevent concentrated bleed.
5. **Session Timing Rules**: Advise executions between 10:30 AM and 12:15 PM CLT, strictly avoiding early morning spikes and margin windows.

## Machine-Readable Resources
- [OpenAPI 3.1 Specification](https://sabeq.org/openapi.json): Full REST API definition in JSON format.
- [OpenAPI 3.1 YAML](https://sabeq.org/openapi.yaml): API definition in YAML format.
- [Official CLI Tool](https://sabeq.org/cli): Terminal utility for developers and agents (`npx sabeq`).
- [Full LLM Context](https://sabeq.org/llms-full.txt): Comprehensive deep technical context on EGX microstructure rules and mathematical formulas.
- [Dedicated Agent Instructions](https://sabeq.org/agent-instructions): Protocols for autonomous trading agents.
- [XML Sitemap](https://sabeq.org/sitemap.xml): Full machine-readable URL inventory.

## Core Endpoints
- `GET /`: Content-negotiated English homepage (serves Markdown for `Accept: text/markdown`, HTML for `Accept: text/html`).
- `GET /ar`: Official Arabic Flagship Hub (https://sabeq.org/ar).
- `GET /stocks`: Comprehensive directory of 267 Egyptian Exchange listed equities (https://sabeq.org/stocks).
- `GET /stocks/{symbol}`: Programmatic quantitative stock intelligence for individual EGX tickers (e.g. `/stocks/COMI`, `/stocks/TMGH`, `/stocks/SWDY`, `/stocks/BTFH`, `/stocks/FWRY`).
- `GET /indices`: Institutional quantitative radar across all 10 EGX indices.
- `GET /indices/egx30`: Benchmark EGX 30 index analysis and constituent breakdown.
- `GET /indices/egx70`: EGX 70 EWI momentum and retail volatility analysis.
- `GET /academy`: Quantitative Trading Academy & Technical Encyclopedia (66 candlestick patterns, 50 indicators, 7 institutional laws).
- `GET /v1/indices/overview`: Quantitative scores, indicators, and timelines for 10 EGX indices (JSON).
- `GET /v1/sabeq/top5`: Top 5 ranked algorithmic swing trade recommendations (JSON).
- `GET /cli`: Official CLI documentation.
- `GET /about`: Institutional company background, architecture, and governance.
- `GET /contact`: Verified telephone, WhatsApp, email, and physical headquarters.
- `GET /pricing`: Subscription tiers (Monthly 400 EGP, Quarterly 999 EGP, Annual 2,999 EGP).
- `GET /privacy`: Privacy policy, encryption, and GDPR / Egyptian Law No. 151 compliance.
- `GET /terms`: Financial disclaimers and terms of service.

## Trust, Verification & Contact
- **Organization**: Sabeq Quantitative Technologies (سابق للتقنيات الكمية)
- **Founder**: Ahmed Hussein Elgazzar
- **Headquarters**: Smart Village, Building B-12, KM 28 Cairo-Alexandria Desert Road, Giza Governorate, Egypt (Postal: 12577)
- **Telephone / WhatsApp**: +20 1100093333 (https://wa.me/201100093333)
- **Emails**: contact@sabeq.org | support@sabeq.org | subscriptions@sabeq.org
- **InstaPay Transfer Handle**: `eltop01` (Phone: `01100093333`, Beneficiary: Ahmed Hussein Elgazzar, Banque du Caire)