A financial data API that also answers the compliance question

Fundamentals, filings-derived figures and the ratios built from them, for 12,500+ listed companies and 3,585 funds — returned with a Shari'ah compliance verdict under five separate standards on the same call, and with the numbers each verdict came from.

If you only need prices and fundamentals, a general market-data feed is cheaper and we would point you at one. This exists for products where a user is going to ask whether something is permissible, and an unanswerable question is a lost customer.

What one call returns

Fundamentals from filings

Debt, cash and short-term investments, receivables, total revenue and prohibited revenue by segment, lifted from the filing rather than a summary.

The ratios, taken apart

Numerator and denominator alongside each ratio, so a compliance reviewer can reproduce the result instead of trusting a score.

Five verdicts, not one

AAOIFI plus the Dow Jones, FTSE, MSCI and S&P Islamic rulebooks. They disagree, and publishing all five is more useful than picking one.

Funds screened to their basket

An ETF's verdict is rolled up from its own holdings, with the share of the basket we can see published next to it.

Where the figures come from

Regulatory filings, extracted rather than summarised — SEC 10-K and 10-Q, UK Companies House annual accounts, Canadian 40-F and investor-relations reporting. The extraction is the part that is hard to do by hand and the reason the ratios can be shown with their parts. More on the filings extraction.

The cash to debt ratio, and the ratios a Shari'ah screen uses instead

The cash to debt ratio — cash and short-term investments over interest-bearing debt — is a solvency measure, and it is not what a Shari'ah screen tests. AAOIFI measures each side against what the market says the business is worth rather than against the other. Its debt screen is (short-term + long-term debt) ÷ 12-quarter average market cap — fails at ≥ 30%. Its liquidity screen is (cash + short-term investments) ÷ 12-quarter average market cap — fails at ≥ 30%.

The two readings can disagree in both directions. A company holding more cash than debt still fails if either line is large next to its valuation, and a company with almost no cash can clear both tests. That is the whole difference: one ratio asks whether a company can pay what it owes, the other asks how much of the business is built on interest.

We return the parts rather than a score, so either ratio is reproducible. The full report carries the debt and cash figures in dollars beside the ratios themselves, which makes a cash to debt ratio one division away if your product shows one. The fields on the full report.

Building a stock screener API on top of this one

There is no screen-the-whole-market call on the equity side, and saying so is more useful than implying one. You hold the universe you care about, ask the compliance endpoint for each ticker and filter on halal_status; the free tier covers 10 calls a day, which is enough to run a watchlist through it before committing to anything.

Funds work the other way round. The ETF screener is a real screener endpoint: a verdict, a rulebook, a venue, a domicile, a coverage floor, an expense-ratio cap, a minimum fund size and an issuer go in, and the matching funds come back in one call, ordered and paged. It is on Business Ultimate and Business Enterprise.

Either way the verdict arrives with the figures behind it, so a screener built on this can show a user why a ticker was excluded rather than only that it was.

Common questions

What makes this different from a general financial data API?

A general feed returns fundamentals and leaves interpretation to you. This one returns the same figures plus the compliance verdict derived from them, under five separate standards, with the ratio behind each verdict. If you do not need a Shari'ah screen, a general feed is the cheaper answer and we would say so.

What instruments are covered?

Listed equities across United States, United Kingdom, Canada and Uzbekistan, and exchange-traded funds screened through to their own holdings. A fund's verdict is built from its basket rather than its name, with the share of that basket we can see published beside it.

Where do the numbers come from?

Regulatory filings: SEC 10-K and 10-Q submissions, UK Companies House annual accounts, and Canadian 40-F and investor-relations reporting. Figures are extracted from those documents rather than taken from a summary feed, and every ratio arrives with its numerator and denominator.

Can I evaluate it before committing?

Yes. The free tier gives 10 calls a day against the compliance endpoint with no card, which is enough to screen a watchlist and check the results against your own research before deciding anything.

Do you return a cash to debt ratio?

Not as a field, because no rulebook we apply screens on it. A cash to debt ratio compares cash against debt; a Shari'ah screen compares each of them against the company's market capitalisation instead — AAOIFI's debt test is (short-term + long-term debt) ÷ 12-quarter average market cap — fails at ≥ 30%, and its liquidity test is (cash + short-term investments) ÷ 12-quarter average market cap — fails at ≥ 30%. Both underlying dollar figures are on the full report beside the ratios, so the cash to debt ratio is one division away if your product shows one.

Is there a stock screener API?

Not as a single screen-the-market call on the equity side, and we would rather say so than imply one: you hold the universe you care about, ask the compliance endpoint for each ticker and filter on halal_status. Funds are the other way round — the ETF screener takes a verdict, a rulebook, a venue, a domicile, a coverage floor, an expense-ratio cap, a minimum fund size and an issuer, and returns the matches in one call.

How do I know when a verdict changes?

There is an append-only feed of verdict and coverage changes, and webhooks that push them to your endpoint. Re-screening every holding on a schedule is the alternative, and it is both slower and easy to get wrong at the boundaries.

Send a request before you decide

The playground sends a real request from the browser and shows the exact response your integration will receive.

Keep reading