---
title: "Get Etf Info"
method: GET
path: "/api/etf/{symbol}/info"
tags: ["etf"]
---

# Get Etf Info

`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`

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:**

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

## Path parameters

- `symbol` string, required: ETF ticker symbol.

## Response `200`

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

- ETFFundInfoResponse: General fund-level metadata for an ETF.
  - `symbol` string, required: ETF ticker symbol.
  - `name` string: ETF fund name.
  - `description` string, nullable: Brief fund description.
  - `inception_date` string, nullable: Fund inception date (YYYY-MM-DD).
  - `expense_ratio` number, nullable: Annual expense ratio as a decimal (0.0003 = 0.03%).
  - `nav` number, nullable: Net asset value per share in USD.
  - `total_assets` number, nullable: Total assets under management in USD.
  - `category` string, nullable: Morningstar or provider category.
  - `family` string, nullable: Fund family name (e.g. 'Vanguard').
  - `exchange` string, nullable: Exchange where the ETF is listed (e.g. 'NYSE Arca').
  - `sector_weightings` object, nullable: Mapping of sector names to portfolio weight percentages.
  - `asset_classes` object, nullable: Mapping of asset class labels (equity, bond, etc.) to weight percentages.
  - `country_weightings` object, nullable: Mapping of country codes/names to portfolio weight percentages.
  - `turnover` number, nullable: Annual portfolio turnover rate as a decimal.

## Other responses

- `404`: ETF symbol not found.
- `422`: Validation Error

---

[API](https://skmtc.dev/halalterminal/apis/halal-terminal-api.md) · [All operations](https://skmtc.dev/halalterminal/apis/halal-terminal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/halalterminal/apis/halal-terminal-api/revisions/78768b250943?raw)