etf

Get Etf Info

Retrieve general fund information for an ETF.

Returns metadata such as the fund name, description, inception date, expense ratio, NAV, total assets, category, sector weightings, and country weightings.

curl example:

curl -X GET "http://localhost:8000/api/etf/SPY/info"

Python requests example:

import requests
resp = requests.get("http://localhost:8000/api/etf/SPY/info")
info = resp.json()
print(info["name"], "- expense ratio:", info["expense_ratio"])
get/api/etf/{symbol}/info

Request

  • Base URL: https://api.halalterminal.com
  • URL: https://api.halalterminal.com/api/etf/{symbol}/info
  • Auth: API key in header X-API-Key

Path parameters

symbolstring required

ETF ticker symbol.

Response

Fund-level metadata including expense ratio, AUM, sector weightings.

symbolstring required

ETF ticker symbol.

namestring

ETF fund name.

descriptionstring nullable

Brief fund description.

inception_datestring nullable

Fund inception date (YYYY-MM-DD).

expense_rationumber nullable

Annual expense ratio as a decimal (0.0003 = 0.03%).

navnumber nullable

Net asset value per share in USD.

total_assetsnumber nullable

Total assets under management in USD.

categorystring nullable

Morningstar or provider category.

familystring nullable

Fund family name (e.g. 'Vanguard').

exchangestring nullable

Exchange where the ETF is listed (e.g. 'NYSE Arca').

sector_weightingsobject nullable

Mapping of sector names to portfolio weight percentages.

asset_classesobject nullable

Mapping of asset class labels (equity, bond, etc.) to weight percentages.

country_weightingsobject nullable

Mapping of country codes/names to portfolio weight percentages.

turnovernumber nullable

Annual portfolio turnover rate as a decimal.

Example response

{
  "category": "Large Blend",
  "description": "Tracks the S&P 500 index.",
  "exchange": "NYSE Arca",
  "expense_ratio": 0.0945,
  "family": "SPDR State Street Global Advisors",
  "inception_date": "1993-01-22",
  "name": "SPDR S&P 500 ETF Trust",
  "nav": 510.25,
  "sector_weightings": {
    "healthcare": 0.13,
    "technology": 0.3
  },
  "symbol": "SPY",
  "total_assets": 500000000000,
  "turnover": 0.02
}

Changes

No recorded changes to this operation across all 1 revision of this API.