Musaffa API integration (Halal Investing · Shariah screening · Portfolio OpenData)

Shariah compliance screener API

Exposes Musaffa's halal/not-halal/questionable status for a ticker, with sub-scores for business activity, interest-bearing debt, cash & receivables ratios, and non-compliant revenue. Used for embedded compliance checks in trading apps and roboadvisors.

Stock & ETF screener API

Search and filter across 60+ exchanges (NYSE, NASDAQ, LSE, TSX, TASI, ADX, DFM, BSE, Bursa Malaysia, Euronext Paris) using 100+ filters — market cap, sector, dividend yield, ESG flags, compliance rating. Ideal for screening widgets and research tools.

Portfolio analytics export

Returns diversification breakdowns (sector exposure, market-cap tiers), compliance-weighted returns, and unrealized purification liabilities. Powers wealth-manager dashboards and private-banking reports.

Watchlist & compliance alerts

Delivers watchlist items and real-time compliance transitions (halal → questionable) via webhooks, so your notification system can warn users the moment a position's Shariah status changes.

Zakat & purification engine

API returns per-transaction purification amounts, yearly zakat calculations per portfolio, and historical purification totals — suitable for accounting sync and charitable-giving platforms.

Market data & fundamentals passthrough

Quotes, historical prices, earnings, sector performance, and the 2025 sector/index summary modules surfaced in one normalized schema, usable in terminal-style trading clients and analyst tools.

1. Authenticated compliance lookup

// Token = Base64(HMAC-SHA512(secretKey, clientId + timestamp + bodyJson))
GET /api/v3/compliance/{ticker}
Host: api.musaffa.com
X-Client-Id: <CLIENT_ID>
X-Timestamp: 20260420123045   // UTC+5, yyyyMMddHHmmss
X-Signature: <BASE64_SHA512_TOKEN>

200 OK
{
  "ticker": "AAPL",
  "complianceStatus": "halal",
  "subScores": {
    "businessActivity": "pass",
    "interestDebtRatio": 0.21,
    "cashAndReceivablesRatio": 0.18,
    "nonCompliantRevenueRatio": 0.027
  },
  "reportPeriod": "2025-Q4",
  "lastUpdated": "2026-03-28T09:10:00Z"
}

2. Portfolio & purification export

POST /api/v1/musaffa/portfolio/export
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

{
  "userRef": "u_8f1a...",
  "from": "2025-01-01",
  "to":   "2025-12-31",
  "include": ["positions","diversification","purification","zakat"]
}

200 OK
{
  "positions": [ { "ticker":"MSFT","qty":12,"cost":312.4,"status":"halal" } ],
  "diversification": { "sectors": {"Technology":0.42,"Healthcare":0.18}, "marketCap": {"Large":0.81} },
  "purification": { "ytdAmountUSD": 42.31, "perTicker": {"MSFT": 12.04} },
  "zakat": { "nisabUSD": 5400, "payableUSD": 318.75 }
}

3. Compliance change webhook

// Subscriber endpoint receives Musaffa-style compliance transitions
POST https://your-app.example.com/webhooks/musaffa
X-Musaffa-Event: compliance.changed
X-Musaffa-Signature: sha512=...

{
  "ticker": "TSLA",
  "previousStatus": "halal",
  "newStatus": "questionable",
  "reason": "debtRatio threshold breached",
  "occurredAt": "2026-04-19T14:22:07Z"
}

// Error handling
// 4xx: signature mismatch -> drop
// 5xx: retry with exponential backoff (up to 5 attempts)

What you receive

• OpenAPI / Swagger spec for the Musaffa-facing service (compliance, screener, portfolio, zakat endpoints).
• Protocol & auth flow report (client ID, SHA-512 signed tokens, timestamp conventions, error semantics).
• Runnable source (Python / Node.js / Go) for compliance lookup, portfolio export, and webhook receiver.
• Postman collection, integration tests, and replayable fixtures for 60+ sample tickers across markets.
• Compliance guide covering GDPR, AAOIFI alignment, regional financial-regulator notes, and retention knobs.

Engagement models

• Source-code delivery from $300 — we hand over runnable source and documentation; you pay after acceptance.
• Pay-per-call hosted API — call our hosted Musaffa integration layer and pay only per request; no upfront fee.
• NDA & signed scoping document on request; sandbox credentials provisioning handled end-to-end.

Zoya

A leading halal investing app covering 30,000+ global stocks with its own Shariah compliance datafeed and API. Users often need consolidated compliance views across Zoya and Musaffa — we normalize ratings and sub-scores across both.

Wahed Invest

A Shariah-certified roboadvisor serving 400,000+ investors. Holdings data from Wahed combined with Musaffa's screener lets teams build end-to-end portfolio-to-compliance pipelines.

Aghaz

US-based halal robo-advisor with goal-based investing. Exporting Aghaz positions alongside Musaffa's purification amounts creates clean zakat and giving workflows.

Simply Ethical

FCA-regulated UK platform covering discretionary management, robo-advisory and brokerage with halal screening. Often paired with Musaffa for UK-specific Shariah reporting.

Minted

A halal gold investing app; transaction data from Minted and equity compliance data from Musaffa together give Islamic wealth managers a cross-asset view.

Qardus

A Shariah-compliant SME lender. Combined with Musaffa's equity screener it supports diversified halal asset-allocation dashboards.

Arabesque

Institutional Islamic fund manager with ESG overlays. Firms cross-reference Arabesque fund holdings against Musaffa compliance ratings for due diligence.

Sarwa

MENA-focused roboadvisor with Shariah portfolios. Musaffa's per-ticker compliance data is frequently used to validate Sarwa-held positions in custom reporting.

Wealthsimple Halal Portfolio

Canadian halal portfolio option; bringing its holdings into a workflow that also reads Musaffa keeps compliance logic consistent across providers.

Tabadulat & IslamicMarkets

Tabadulat offers halal investing tools and education; IslamicMarkets is a knowledge and data network for Islamic finance. Both pair with Musaffa as complementary data sources for research and content automation.

About our studio

We are an independent technical studio focused on OpenData, OpenFinance, and app protocol analysis. Our engineers come from brokerages, Islamic banking, payments, and security research; we have shipped production API layers for halal investing tools, neobanks, e-commerce and OTT media. We speak the language of AAOIFI, GDPR, PSD2, SAMA, and SEBI, and we design integrations that can be audited.

• Halal investing, wealth tech, payments, insurtech, e-commerce, travel.
• Protocol analysis, reverse engineering of documented flows, and authorized B2B API work.
• Full-cycle delivery: scope → protocol & schema → code → tests → compliance notes.
• Flat-fee source-code delivery from $300 or hosted pay-per-call API.

Contact

Tell us your Musaffa integration goals — Shariah screening, portfolio OpenData, zakat automation, or something new — and we will respond with a scoped quote.

Open contact page

Engagement workflow

1. Scope call: confirm Musaffa modules in play (compliance, screener, portfolio, zakat, alerts).
2. Protocol analysis and API design (2–5 business days, depending on surface area).
3. Build & internal validation against Musaffa sandbox credentials (3–8 business days).
4. Docs, sample calls, Postman collection, and automated test suite (1–2 business days).
5. Typical first delivery: 5–15 business days; enterprise rollouts with compliance sign-off may run longer.

FAQ

What do you need from me?

How long does delivery take?

How do you handle compliance?

Can we use this alongside Zoya or Wahed data?