Daleel — Auditable Halal Stock Screening (Developer Hub)
دليل · Daleel (Arabic for evidence) screens US-listed stocks and ETFs for Sharia compliance — and shows its receipts. Every verdict cites the SEC filing behind it: the XBRL tag, the form (10-K / 20-F / 40-F), the period, and a link to the filing on sec.gov. Five methodologies checked side by side: AAOIFI, DJIM, MSCI, S&P, and FTSE.
Live: https://daleel.o11r.com · Docs: https://daleel.o11r.com/developers · Methodology: https://daleel.o11r.com/methodology
This repo is the public developer hub (docs, examples, MCP metadata). The screening engine itself is closed source.
For AI agents (MCP)
Daleel runs a Model Context Protocol server — connect any MCP-capable agent:
{
"mcpServers": {
"daleel": {
"type": "http",
"url": "https://daleel.o11r.com/mcp"
}
}
}
Tools: screen_ticker(ticker) → full verdict with evidence citations ·
screening_methodology() → the methodology summary.
Anonymous use: 10 req/min per IP. With an X-API-Key header: 30+ req/min.
REST quickstart
# No key needed (demo tier, 10 req/min):
curl https://daleel.o11r.com/v1/screen/MSFT
# Free key (30 req/min, batch + history):
curl -X POST https://daleel.o11r.com/api/keys \
-H "Content-Type: application/json" -d '{"email": "[email protected]"}'
curl https://daleel.o11r.com/v1/screen/MSFT -H "X-API-Key: YOUR_KEY"
The response includes a per-methodology audit matrix (every ratio vs every
threshold), an evidence ledger with sec.gov links, purification percentages,
and — with ?overlays=all — values/ESG screens sourced from official
government lists (UFLPA, DoD 1260H, state divestment lists), each with its
citation. See examples/ for Python and JavaScript.
Principles
- Missing data is never treated as compliant. Unscreenable → says so.
- Every approximation is disclosed in the response itself.
- Verdicts are methodology calculations, not religious rulings; consult a qualified scholar for matters of fiqh. Nothing here is investment advice.
Links
- OpenAPI: https://daleel.o11r.com/openapi.json
- llms.txt: https://daleel.o11r.com/llms.txt
- Why we built this: https://daleel.o11r.com/blog/why-my-trading-bot-made-nothing
- Contact: [email protected]