The Daleel API

Quickstart · REST · JSON · Evidence included

One endpoint does most of the work: give it a ticker, get back a verdict, a 0–100 score, the four-methodology audit matrix, the purification percentage, and the SEC filing citations behind every number.

Get a key

curl -X POST http://daleel.o11r.com/api/keys \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

Returns a free-tier key (shown once; re-signup rotates it). Partner tier upgrades happen via the pricing page.

Screen a ticker

curl http://daleel.o11r.com/v1/screen/MSFT \
  -H "X-API-Key: YOUR_KEY"

Without a key you're on the demo tier (10 requests/minute per IP — enough to explore, not enough to build on). Response shape:

{
  "success": true,
  "error": null,
  "data": {
    "symbol": "MSFT",
    "compliance": "compliant",        // compliant | questionable |
                                      // non_compliant | not_screenable
    "score": 84.5,
    "components": { "interest_income": {"score": 25, "max": 25}, ... },
    "ratios": { "debt_to_market_cap": 0.021, ... },
    "methodologies": [
      { "name": "AAOIFI", "passed": true,
        "checks": [ {"ratio": "debt_to_market_cap",
                     "value": 0.021, "threshold": 0.30,
                     "passed": true}, ... ] }, ...
    ],
    "purification": { "pct_of_dividends_and_gains": 1.2, ... },
    "evidence": [
      { "concept": "Interest income",
        "xbrl_tag": "InvestmentIncomeInterest",
        "value": 2913000000, "form": "10-K",
        "period_end": "2025-06-30",
        "accession": "0000950170-25-...",
        "source_url": "https://www.sec.gov/Archives/edgar/data/..." }, ...
    ]
  }
}

Batch screening

Screen up to 25 symbols per call. Requires a key (any paid or free tier).

curl -X POST http://daleel.o11r.com/v1/batch \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbols": ["AAPL", "MSFT", "JPM", "KO"]}'

Screening history

Dated snapshots of past screenings (foundation for compliance-drift alerts). Any key tier:

curl http://daleel.o11r.com/v1/history/MSFT -H "X-API-Key: YOUR_KEY"

ETFs are screened by holdings look-through — the response includes an etf_look_through block with per-holding verdicts and the coverage percentage. See the methodology page.

Tiers & limits

• demo — no key, 10 req/min per IP, single-ticker only
• free — 30 req/min, batch enabled
• partner — 300 req/min, batch enabled, support

Free keys are self-serve above; partner keys are issued on subscription.

Honest limitations

We publish these because auditability cuts both ways:

• US-listed companies only (SEC EDGAR coverage) — international markets are on the roadmap.
• DJIM and S&P specify trailing-average market-cap denominators; we currently use point-in-time market cap and say so in every response's approximations field.
• Interest income is the haram-revenue proxy; segment-level revenue analysis (e.g. a hotel group's bar sales) is in development.
• Missing data is never treated as compliant — companies without sufficient filed financials return not_screenable.

Errors

• 400 — malformed ticker
• 401 — invalid API key
• 404 — ticker not found in SEC EDGAR
• 429 — rate limit exceeded for your tier

Full machine-readable schema: OpenAPI reference.