# Ishares Metals — Zapi reference

> The US iShares product screener — 524 funds with NAV, fees, identifiers and

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ content, message, errors }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/finance/ishares-metals
- Endpoint catalog: https://zpi.web.id/category/finance
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## Ishares Metals

**Category:** finance · **Slug:** `ishares-metals`
**Detail page:** https://zpi.web.id/api/finance/ishares-metals

The US iShares product screener — 524 funds with NAV, fees, identifiers and

**Tags:** finance, ishares-metals

### Screener

The US iShares product screener — 524 funds with NAV, fees, identifiers and

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:ishares-metals/screener`
- **Cache TTL:** 3600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `query` | string | query | no | Filter by fund name, ticker, ISIN or CUSIP, case-insensitive. |
| `assetClass` | enum(Equity|Fixed Income|Real Estate|Commodity|Multi Asset|Digital Assets|Cash) | query | no | Restrict to one asset class. |
| `page` | number | query | no | Page of funds. Default 1. |
| `limit` | number | query | no | Funds per page. Default 25, max 100. |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:ishares-metals/screener?query=gold&assetClass=Commodity&page=1&limit=25" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:ishares-metals/screener?query=gold&assetClass=Commodity&page=1&limit=25", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:ishares-metals/screener?query=gold&assetClass=Commodity&page=1&limit=25",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "page": 1,
  "count": 3,
  "items": [
    {
      "url": "https://www.ishares.com/us/products/239561/ishares-gold-trust-fund",
      "isin": "US4642852044",
      "name": "iShares Gold Trust",
      "cusip": "464285204",
      "sedol": "BMDB791",
      "region": "Global",
      "ticker": "IAU",
      "navAsOf": "2026-08-20",
      "netAssets": 65975016307.58,
      "assetClass": "Commodity",
      "navPerShare": 84.286191,
      "portfolioId": 239561,
      "returnsAsOf": "2026-07-31",
      "inceptionDate": "2005-01-21",
      "netAssetsAsOf": "2026-08-20",
      "subAssetClass": "Precious Metals",
      "investmentStyle": "Index",
      "returnYtdPercent": -6.668,
      "expenseRatioPercent": 0.25,
      "returnOneYearPercent": 21.758,
      "returnTenYearPercent": 11.3326,
      "returnFiveYearPercent": 16.8481,
      "netExpenseRatioPercent": 0.25,
      "returnThreeYearPercent": 26.5811,
      "returnSinceInceptionPercent": 10.6743
    },
    {
      "url": "https://www.ishares.com/us/products/306979/ishares-gold-trust-micro",
      "isin": "US46436F1030",
      "name": "iShares Gold Trust Micro",
      "cusip": "46436F103",
      "sedol": "-",
      "region": "Global",
      "ticker": "IAUM",
      "navAsOf": "2026-08-20",
      "netAssets": 7776582936.16,
      "assetClass": "Commodity",
      "navPerShare": 44.667335,
      "portfolioId": 306979,
      "returnsAsOf": "2026-07-31",
      "inceptionDate": "2021-06-15",
      "netAssetsAsOf": "2026-08-20",
      "subAssetClass": "Precious Metals",
      "investmentStyle": "Index",
      "returnYtdPercent": -6.569,
      "expenseRatioPercent": 0.09,
      "returnOneYearPercent": 21.976,
      "returnTenYearPercent": null,
      "returnFiveYearPercent": 17.0512,
      "netExpenseRatioPercent": 0.09,
      "returnThreeYearPercent": 26.8068,
      "returnSinceInceptionPercent": 16.1193
    },
    {
      "url": "https://www.ishares.com/us/products/239654/ishares-msci-global-gold-miners-etf",
      "isin": "US46434G8556",
      "name": "iShares MSCI Global Gold Miners ETF",
      "cusip": "46434G855",
      "sedol": "-",
      "region": "Global",
      "ticker": "RING",
      "navAsOf": "2026-08-20",
      "netAssets": 2490576809.96,
      "assetClass": "Equity",
      "navPerShare": 87.38866,
      "portfolioId": 239654,
      "returnsAsOf": "2026-07-31",
      "inceptionDate": "2012-01-31",
      "netAssetsAsOf": "2026-08-20",
      "subAssetClass": "All Cap",
      "investmentStyle": "Index",
      "returnYtdPercent": -12.936497,
      "expenseRatioPercent": 0.39,
      "returnOneYearPercent": 48.030674,
      "returnTenYearPercent": 11.069236,
      "returnFiveYearPercent": 19.350937,
      "netExpenseRatioPercent": 0.39,
      "returnThreeYearPercent": 40.070807,
      "returnSinceInceptionPercent": 2.97921
    }
  ],
  "query": "gold",
  "total": 3,
  "dataset": "screener",
  "hasMore": false,
  "nextPage": null,
  "provider": "ishares-metals",
  "assetClass": null,
  "assetClasses": [
    "Equity",
    "Fixed Income",
    "Real Estate",
    "Commodity",
    "Multi Asset",
    "Digital Assets",
    "Cash"
  ]
}
```

---

### Quote

One iShares metal fund at a glance — NAV, market price, premium/discount, net

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:ishares-metals/quote`
- **Cache TTL:** 900s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `ticker` | enum(IAU|SLV|IAUM|GSG|COMT|CMDY|ISTM) | query | no | Fund ticker. IAU/IAUM hold gold, SLV holds silver. Default IAU. |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:ishares-metals/quote?ticker=IAU" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:ishares-metals/quote?ticker=IAU", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:ishares-metals/quote?ticker=IAU",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "url": "https://www.ishares.com/us/products/239561/ishares-gold-trust-fund",
  "asOf": "Aug 20, 2026",
  "name": "iShares Gold Trust",
  "cusip": "464285204",
  "metal": "gold",
  "ticker": "IAU",
  "dataset": "quote",
  "currency": "USD",
  "exchange": "NYSE Arca",
  "provider": "ishares-metals",
  "benchmark": "LBMA Gold Price",
  "netAssets": 65975016308,
  "dailyVolume": 10875357,
  "portfolioId": 239561,
  "closingPrice": 84.84,
  "inceptionDate": "Jan 21, 2005",
  "midPointPrice": 84.83,
  "ouncesInTrust": 14718802,
  "tonnesInTrust": 457.81,
  "benchmarkTicker": "GOLDLNPM",
  "historyAvailable": false,
  "sharesOutstanding": 782750000,
  "premiumDiscountPercent": 1.15,
  "thirtyDayAverageVolume": 5314173,
  "premiumDiscountClosePercent": 1.16,
  "thirtyDayMedianBidAskSpreadPercent": 0.01
}
```

---

### Fund Facts

iShares physical-metal trusts — the fact table on the fund page, including

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:ishares-metals/fund-facts`
- **Cache TTL:** 900s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `ticker` | enum(IAU|SLV|IAUM|GSG|COMT|CMDY|ISTM) | query | no | Fund ticker. IAU/IAUM hold gold, SLV holds silver. Default IAU. |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:ishares-metals/fund-facts?ticker=IAU" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:ishares-metals/fund-facts?ticker=IAU", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:ishares-metals/fund-facts?ticker=IAU",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "url": "https://www.ishares.com/us/products/239561/ishares-gold-trust-fund",
  "asOf": "Aug 20, 2026",
  "name": "iShares Gold Trust",
  "count": 21,
  "items": [
    {
      "key": "assetClass",
      "unit": null,
      "label": "Asset Class",
      "value": "Commodity",
      "numeric": null,
      "upstreamKey": "assetClass"
    },
    {
      "key": "basketAmt",
      "unit": null,
      "label": "Basket Amount",
      "value": "940.08",
      "numeric": 940.08,
      "upstreamKey": "basketAmt"
    },
    {
      "key": "bidAskMidpointPrice",
      "unit": null,
      "label": "Mid-Point Price",
      "value": "84.83",
      "numeric": 84.83,
      "upstreamKey": "bidAskMidpointPrice"
    },
    {
      "key": "closingPrice",
      "unit": null,
      "label": "Closing Price",
      "value": "84.84",
      "numeric": 84.84,
      "upstreamKey": "closingPrice"
    },
    {
      "key": "dailyVolume",
      "unit": null,
      "label": "Daily Volume",
      "value": "10,875,357.00",
      "numeric": 10875357,
      "upstreamKey": "consolidatedVolume"
    },
    {
      "key": "cusip",
      "unit": null,
      "label": "CUSIP",
      "value": "464285204",
      "numeric": 464285204,
      "upstreamKey": "cusip"
    },
    {
      "key": "exchange",
      "unit": null,
      "label": "Exchange",
      "value": "NYSE Arca",
      "numeric": null,
      "upstreamKey": "exchange"
    },
    {
      "key": "indexSeriesName",
      "unit": null,
      "label": "Reference Benchmark",
      "value": "LBMA Gold Price",
      "numeric": null,
      "upstreamKey": "indexSeriesName"
    }
  ],
  "metal": "gold",
  "ticker": "IAU",
  "dataset": "fund-facts",
  "provider": "ishares-metals",
  "portfolioId": 239561,
  "historyAvailable": false
}
```

---


_Generated: 2026-08-21T07:45:05.077Z_