Skip to content

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
}
32,500+stocks & ETFs
8screening standards
51data points per listing
99.9%uptime commitment
0per-account rate limits

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

AAOIFI Certified Shariah Advisor and Auditor certificate