Hajras Data API

Saudi fair-value intelligence as a service — the same TASI & Nomu screener, valuation engines and data-confidence layer that power this app, over a clean REST API.

FreeAll endpoints are public and unmetered during the beta.

Base URL: https://bj91.odoo.com

Read endpoints need no auth. Only /api/v1/contribute requires a signed-in session. Keyed endpoints accept an X-Api-Key header; keyless endpoints stay open.

Endpoints

Markets & screening

public

GET/api/companies— Screener — filter by sector / market / discount.

GET/api/company/<ticker>— Full company detail + valuation breakdown.

GET/api/company/<ticker>/prices— Price history (daily / weekly).

GET/api/meta— Filter metadata (sectors, markets, ratings).

GET/api/leaders— Best performers by total return.

Stateless valuation engines

public

POST/api/realestate/calc— Real-estate valuation (stateless).

POST/api/privateequity/calc— Private-equity valuation (stateless).

POST/api/vcstartup/calc— VC / startup valuation (stateless).

Valuation API (v1)

public

GET/api/v1/companies— Versioned screener.

GET/api/v1/company/<ticker>— Versioned company detail.

GET/api/v1/reviews/<ticker>— Analyst reviews for a company.

Provenance & consensus (v1)

public

GET/api/v1/consensus/<ticker>— Per-figure consensus + confidence + sources.

GET/api/v1/filings/<ticker>— Regulatory filings (CMA / Tadawul).

POST/api/v1/contribute— Submit a sourced figure (session required).

Keyed data API (Phase 5)

X-Api-Key

GET/api/v1/screener— Keyed catalog — returns plan + quota.

Calculation endpoints are rate-limited to 60 requests/min per IP (HTTP 429 when exceeded).

Example request

curl https://bj91.odoo.com/api/v1/screener \
  -H "X-Api-Key: fc_your_key_here"

Example response

{ "results": [ { "ticker": "2222", "name": "Saudi Aramco",
                 "sector": "energy", "datapoint_count": 5 } ],
  "total_count": 1, "plan": "free", "quota_remaining": 999 }

Plans

	Free	Pro	Enterprise
Read endpoints	✓	✓	✓
Rate limit	60/min	—	—
Commercial use	—	✓	✓
Bulk / historical export	—	✓	✓
Price	Free	Planned	Contact us

Indicative pricing for general availability. During the beta every plan's limits are unenforced — the API is open.

Request an API key

Keys aren't issued automatically yet. Email us your use case and expected volume and we'll set you up.

Email us

Figures are estimates for screening, not investment advice. Verify before investing.