API Reference
cURL
curl --request GET \ --url https://api.halal.sh/v1/etfs/{symbol} \ --header 'X-API-Key: <api-key>'
{ "data": { "symbol": "SPY", "name": "SPDR S&P 500 ETF Trust", "purity_percentage": 72.5, "holdings_breakdown": { "compliant": 289, "non_compliant": 156, "pending": 58, "total": 503 }, "analysis_date": "2023-12-25" }, "meta": { "request_id": "req_abc123", "methodology": "aaoifi-ss21@2024", "as_of": "2026-03-08T12:00:00Z", "retry_after": 120 } }
Returns Shariah purity analysis for an ETF — compliant/non-compliant/pending holdings breakdown.
"SPY"
ETF purity data
Show child attributes