The Mizan API
A free, public, read only API that screens a US-listed company against four Sharia equity standards, and shows the numbers behind every verdict. No account, no key, GET requests only.
Endpoints
GET /api/v1/screen/{ticker}
Screens one company. Returns the live price and its timestamp, the share count and where it came from, market capitalisation, the filing figures used and the quarter they belong to, then one block per standard with the ratio, the threshold, the verdict and a borderline flag.
GET /api/v1/standards
The four standards, their denominators and their thresholds.
GET /api/v1/health
Service status and the provenance of the research panel being served.
How a verdict is reached
Every standard divides interest-bearing debt by a measure of size and compares the result with a threshold. A company is non-compliant when the ratio exceeds the threshold. The averaging window is what separates the standards, and it is the reason a stock can move in or out of compliance on price alone.
- AAOIFI: debt over market capitalisation on the day, threshold 0.30
- Dow Jones Islamic Market: debt over trailing 24-month average market capitalisation, threshold one third
- S&P Shariah: debt over trailing 36-month average market capitalisation, threshold one third
- MSCI Islamic: debt over total assets, threshold one third
Any ratio within one percent of its threshold is returned with borderline set to true, which is where a small price move flips the verdict and where published work that rounds one third to 0.33 disagrees.
Where the numbers come from
Debt and total assets come from company filings through the SEC's XBRL company facts. Price and shares outstanding are live market data, consolidated across share classes, which matters because the SEC cover-page field names one class and for several companies has not been refreshed in years. When the two share counts disagree materially, the response says so in its notes.
When it refuses
A malformed ticker returns 400. A company outside the 424-company panel returns 404 and says so. If a live price or share count cannot be read, the service returns 503 with the reason rather than screening on stale data. A standard whose averaging window cannot be filled returns no verdict for that standard, with a reason, rather than an average of whatever is available.
Machine readable
Coverage and limits
424 large-cap US companies, quarterly from 2010. Responses are cached for 15 minutes. No rate limits are imposed. Contact hello@askmizan.com.
Research
The screening rules and the panel come from Price-Driven Churn in Islamic Equity Screening. Mizan is research output, not investment advice and not a fatwa.