# ETFs

APIs Related to ETFs

## ETF LIST v.1

 - [POST /v1/musaffa/etf/list](https://docs.musaffa.us/apis/etfs/etflistv1.md): Get ETF List.

## Request body:

| Parameter | Value | Description |
| --- | --- | --- |
| country | "US" | Market where ETF traded |

## Response body:

| Parameter | Type | Description |
| --- | --- | --- |
| symbol | string | ETF symbol |
| isin | string | ETF ISIN |
| name | string | ETF Name |
| assetClass | string | Asset Class |
| investmentSegment | string | Investment Segment. |
| market | string | Market |
| navCurrency | string | NAV currency. |
| numberOfHoldings | number | Number of holdings. |
| uncoveredHoldings | number | Number of uncovered holdings. |
| complianceStatus | string | Shariah-compliance Status (Halal, Not Halal, Doubtful) |

## ETF SCREENING REPORT v.1

 - [POST /v1/musaffa/etf/report](https://docs.musaffa.us/apis/etfs/etfscreeningreportv1.md): Get Shariah-Compliant Screening Results for ETFs. You can query by stock ticker.

EndFragment

## Request body:

| Parameter | Value | Description |
| --- | --- | --- |
| symbol | "SEMI" | ETF symbol |

## Response body:

| Parameter | Type | Description |
| --- | --- | --- |
| symbol | string | ETF symbol |
| isin | string | ETF ISIN |
| name | string | ETF Name |
| assetClass | string | Asset Class |
| investmentSegment | string | Investment Segment. |
| market | string | Market |
| navCurrency | string | NAV currency. |
| numberOfHoldings | number | Number of holdings. |
| uncoveredHoldings | number | Number of uncovered holdings. |
| complianceStatus | string | Shariah-compliance Status  (HALAL, NOT HALAL, DOUBTFUL) |
| aggregateRevenueBreakdown | object | Revenue Breakdown JSON Object  _{  "halalRatio": "number", // percentage value from 0 to 100  "notHalalRatio": "number", // percentage value from 0 to 100  "doubtfulRatio": "number", // percentage value from 0 to 100  "doubtfulRevenue": "number", // amount of doubtful revenue  "halalRevenue": "number", // amount of halal revenue  "notHalalRevenue": "number", // amount of not halal revenue  "status": "string", // Pass or Fail  }  _  Combined revenue from DOUBTFUL and NOT HALAL sources must be less than  5% of total revenue to be Shariah compliant based on AAOIFI stock  screening methodology.  Thus,  \- If DOUBTFUL+NOT HALAL revenue is equal or more than 5%, then the  status will be FAIL  \- If DOUBTFUL+NOT HALAL revenue is less than 5%, then the status will be  PASS  \- If HALAL, DOUBTFUL and NOT HALAL has no value, then the status will be  NOT_UNDER_COVERAGE |
| aggregateInterestBearingSecuritiesAndAssets | object | Interest-bearing Securities and Assets JSON Object  {  "interestAmount": "number", // amount of Interest-bearing Securities and Assets  "interestRatio": "number", // percentage value from 0 to N  "status": "string", // Pass or Fail  }  Interest-Bearing Securities and Assets should be less than 30% of  Trailing 36-month Average Market Capitalization to be Shariah compliant  based on AAOIFI stock screening methodology.  Thus,  \- If Interest Ratio is equal or more than 30%, then the status will be  ‘Fail’  \- If Interest Ratio is less than 30%, then the status will be ‘Pass’  \- If Interest Ratio has no value, then the status will be ’NOT_COVERED’ |
| aggregateInterestBearingDebt | object | Interest-bearing Debt JSON Object  _{  "debtAmount": "number", // amount of Interest-bearing Debt  "debtRatio": "number", // percentage value from 0 to N  "status": "string", // Pass or Fail  }  _  Interest-Bearing Debt should be less than 30% of Trailing 36-Month  Average Market Capitalization to be Shariah compliant based on AAOIFI  stock screening methodology.  Thus,  \- If Debt Ratio is equal or more than 30%, then the status will be  ‘Fail’  \- If Debt Ratio is less than 30%, then the status will be ‘Pass’  \- If Debt Ratio has no value, then the status will be ’NOT_COVERED’ |
| lastUpdate | dateTime | Last  update date in ISO 8601 date-time format YYYY "-" MM "-" DD "T" hh(00  through 23) ":" mm(00 through 59) ":" ss(00 through 59) |
| aggregateRevenue | number | Total Revenue of the company |
| month36AverageMarkCap | number | Trailing 36-month Average Market Capitalization of the company. |

## ETF SCREENING PURIFICATION v.1

 - [POST /musaffa/etf/purification](https://docs.musaffa.us/apis/etfs/etfscreeningpurificationv1.md): ETF SCREENING PURIFICATION v.1

## List of ETF holdings

 - [POST /v1/musaffa/etf/holdings](https://docs.musaffa.us/apis/etfs/listofetfholidngs.md): LIST OF ETF Holidngs

## ETF PROFILE

 - [POST /v1/musaffa/etf/profile](https://docs.musaffa.us/apis/etfs/etfprofile.md): ETF PROFILE

## ETF sector

 - [POST /v1/musaffa/etf/sector](https://docs.musaffa.us/apis/etfs/etfsector.md): ETF Sector

## Zakatable assets

 - [POST /v1/musaffa/etf/zakatableAssets](https://docs.musaffa.us/apis/etfs/zakatableassets.md): Generated from cURL: curl --location 'https://b2b.musaffa.us/b2b/api/v1/musaffa/etf/zakatableAssets' \
--header 'Content-Type: application/json' \
--header 'clientId: AX6kFk5ywERyZacb' \
--header 'time: 20250306111840' \
--header 'token: ONcCawsaE09G76NOBa2tI8TaVUHZ2sSB0glfSh720bFS1RrgpzIXg1QMKe62lkJm63TldKkWoAgF3ESKK9y76Q==' \
--data '{
    "symbol":"QQQ"
}'

## ETF country

 - [POST /v1/musaffa/etf/country](https://docs.musaffa.us/apis/etfs/etfcountry.md): ETF Country