Muslim Xchange API
Shariah compliance data for every listing, one request away.
Verdicts under eight screening standards, impermissible-income figures, purification and zakat per share — for more than 32,500 stocks and ETFs — as clean JSON from any language, spreadsheet or product.
Included with Max, Business Advisor, Corporate and Enterprise plans — no per-account limits. Read the documentation · Already a member? Get your API key.
$ curl -u "you:API-KEY" \
"https://muslimxchange.com/wp-json/api/v1/ticker/AAPL?fields=Result,Purification,Zakatpershare"
{
"ticker": "AAPL",
"Market": "US",
"Name": "Apple Inc",
"Result": "Compliant",
"Purification": 0.0123,
"Zakatpershare": 0.41
}
Built for
The same data, four ways to put it to work
Investors & active traders
Your spreadsheet, always current
Screen a portfolio, a watchlist or a whole market without leaving Excel — the add-in turns the API into formulas.
=MX.TICKER("AAPL","Result","Purification")- Thousands of tickers in a handful of requests
- Purification and zakat figures per share, ready for your own calculations
Advisors & wealth managers
Compliance for every client, on schedule
Run client holdings through the API in batch, produce purification and zakat statements, and catch a verdict change before your client does.
- Batch lookups by ticker or ISIN
- Each standard’s verdict, so you can report under the one your client follows
- Usage dashboard and self-service keys per team member
Institutions
Full depth, full markets, audit-ready
Asset managers, brokers, banks and index providers get every field — ratio values and per-test results under each standard — and can export entire markets in one call.
- All 51 data points, including the ratio breakdowns behind each verdict
- Whole-market export, ordered and repeatable
- Dataset version on every response for audit trails; SLA terms on Enterprise
Fintechs & startups
Halal screening inside your product
Add a compliance badge, a halal filter or a purification calculator to your app, robo-advisor or brokerage without building a screening team.
- Plain REST + JSON, HTTP Basic auth — integrate in an afternoon
- Health endpoint and status page for your own monitoring
- Data licensing for use inside your product — scoped and priced separately
What you get
Everything on the platform, as data
Eight standards, one call
AAOIFI, S&P Shariah, Dow Jones Islamic Market, FTSE Shariah, MSCI Islamic, Al Rajhi, Alinma and Al Bilad — a verdict under each, plus how many a listing passes.
Purification & zakat per share
The figures investors actually need to act on, computed on the same dataset as the verdicts.
Impermissible income, itemised
Segment share, interest share and total impermissible income, so you can explain a verdict, not just report it.
Ratio-level detail
Debt, cash and receivables ratios with the pass/fail of each test under each standard — for compliance teams that need to show their work.
Single, batch and market
One ticker, an ISIN, a list of any length, or a whole market in a single response. No pagination to chase.
Self-service keys & usage
Create, reset and revoke keys yourself; see requests and identifiers per day; keys reach the data API only, never your account.
Excel add-in included
The same key powers the Excel add-in — formulas that batch themselves.
Built to be trusted
99.9% uptime commitment, public status page, dataset version on every response, and a health endpoint for your monitors.
Screening methodology maintained in-house by an AAOIFI Certified Shariah Advisor and Auditor.
How it works
Three steps from plan to first request
Choose a plan
Max or Business Advisor for the core data; Corporate or Enterprise for every field. Firms and fintechs: talk to us and we will scope it.
Create a key
On your API keys page: name it, copy it once, revoke it whenever you like.
Call it
Basic auth over HTTPS. curl, Python, JavaScript, Google Sheets or Excel — examples for each in the docs.
# Python — a whole portfolio in one request
import requests
API, AUTH = "https://muslimxchange.com/wp-json/api/v1", ("you", "API-KEY")
r = requests.post(f"{API}/batch", auth=AUTH, json={
"tickers": ["AAPL", "MSFT", "ASML.AS", "RY.TO"],
"fields": ["Result", "TotalImpurePct", "Purification"]
})
for symbol, row in r.json()["results"]["tickers"].items():
print(symbol, row["Result"], row["Purification"])
Plans
Every plan gets every route. Plans differ only in depth.
| Max · Business Advisor | Corporate · Enterprise | |
|---|---|---|
| Single, ISIN and batch lookups | ✓ | ✓ |
| Whole-market export | ✓ | ✓ |
| Verdicts, impermissible income, purification, zakat | ✓ | ✓ |
| Ratio values and per-test results | — | ✓ |
| Excel add-in | ✓ | ✓ |
| Per-account rate limits | None | None |
| SLA terms, invoicing | — | On request |
| Redistribution / use of the data inside your own product | — | Separate licence — contact us |
Members on another plan can try one lookup a day from their API keys page before upgrading.
In practice
What people build with it
A halal badge in a brokerage app
One batch call per market refresh; show the verdict and the standard it’s under next to every quote.
A robo-advisor’s investable universe
Export the market, keep what passes the client’s chosen standard, rebalance — and re-run when the dataset version changes.
Purification statements at year end
Holdings × purification per share, for every client, from a spreadsheet or a script.
An ETF or index screening universe
Every listing in a market with the ratio detail a Shariah board will ask to see.
Questions
Before you start
Is it OAuth? Do I need to build a login flow?
No. It is HTTP Basic authentication: your username and API key in the Authorization header over HTTPS. Every HTTP library and no-code tool supports it natively.
How current is the data?
The dataset is updated on each screening cycle, and every response carries an X-API-Dataset header naming the publication you are reading, so you can record it alongside your own results.
Are there rate limits?
None per account on paid plans — no request cap, no batch cap, no daily allowance. There is one shared, service-wide ceiling (thousands of requests a minute across all customers) that protects the platform as a whole; if it is ever reached you receive a 503 with Retry-After for a few seconds rather than a slower service. With batch and market calls a heavy integration is a handful of requests a minute, so in practice it is never met.
What about listings on more than one exchange?
Tickers are exchange-suffixed (ASML, ASML.AS) so a ticker always names one listing. An ISIN can match several; the API returns them all and lets you pick a market.
Can I use the data in a product I sell?
Plans cover your own and your firm’s use. Showing, redistributing or deriving products from the data for your customers needs a separate data licence, scoped to your use case — tell us what you are building and we will price it.
Where do I see status and uptime?
Your API keys page shows live status and links to the public status page with history. We commit to 99.9% monthly uptime.
Put the screening in your own tools
Pick a plan and create your key in minutes, or tell us what you are building and we will scope it with you.
Already a member? Get your API key · Documentation
