# Blackrock — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access comprehensive BlackRock iShares ETF data to research fund performance, holdings, fees, and sector allocations, plus search and compare specific ETFs. Monitor investment details like distributions, key characteristics, and broad market indices all in one place.

**Category:** Finance & Markets | **Website:** [blackrock.com/](https://blackrock.com/) | **Docs:** [parse.bot/marketplace/36b759ee-03f1-40cb-8184-f006ee7f6558/blackrock-com-api](https://parse.bot/marketplace/36b759ee-03f1-40cb-8184-f006ee7f6558/blackrock-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-blackrock-com-api-36b759ee/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_broad_market_index_etfs

Retrieve the subset of major broad market index ETFs and funds including S&P 500, Russell 2000, MSCI World, and Aggregate Bond trackers. Filters by fund name keywords and a curated list of major tickers.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-blackrock-com-api-36b759ee/get_broad_market_index_etfs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_etf_fees

Retrieve detailed fee information for an ETF including gross and net expense ratios and management fee.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ticker` | string | Yes | ETF ticker symbol (e.g. IVV, AGG, EEM). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-blackrock-com-api-36b759ee/get_etf_fees \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticker":"<string>"}'
```

### get_etf_holdings

Retrieve the full holdings list for a specific iShares ETF including individual positions, weights, and identifiers. Data is sourced from the v2 product-data API. Omitting as_of_date returns the most recent available holdings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `as_of_date` | string | No | Date in YYYYMMDD format to retrieve historical holdings. If omitted, returns latest available date. |
| `ticker` | string | Yes | ETF ticker symbol (e.g. IVV, AGG, EEM). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-blackrock-com-api-36b759ee/get_etf_holdings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"as_of_date":"<string>","ticker":"<string>"}'
```

### get_etf_holdings_download

Retrieve complete holdings data as JSON (structured equivalent of CSV download). Returns same data as get_etf_holdings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ticker` | string | Yes | ETF ticker symbol (e.g. IVV, AGG, EEM). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-blackrock-com-api-36b759ee/get_etf_holdings_download \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticker":"<string>"}'
```

### get_etf_key_facts

Retrieve key facts and portfolio characteristics for an ETF including dividend yield, expense ratio, and classification data. Some metrics like PE ratio, PB ratio, beta may be null depending on fund type.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ticker` | string | Yes | ETF ticker symbol (e.g. IVV, AGG, EEM). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-blackrock-com-api-36b759ee/get_etf_key_facts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticker":"<string>"}'
```

### get_etf_list

Retrieve the full list of iShares ETFs with ticker, fund name, inception date, expense ratios, net assets, yield, and YTD return. Returns all US-listed iShares products from the screener. Use limit to cap the number of results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results to return (0 for all). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-blackrock-com-api-36b759ee/get_etf_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### get_etf_overview

Retrieve the summary/overview for a specific ETF including NAV, yield, returns, and classification. Uses the product screener dataset for fast lookups without an additional API call.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ticker` | string | Yes | ETF ticker symbol (e.g. IVV, AGG, MCHI). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-blackrock-com-api-36b759ee/get_etf_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticker":"<string>"}'
```

### get_etf_performance

Retrieve annualized performance metrics (YTD, 1Y, 3Y, 5Y, 10Y, since inception) for an ETF based on NAV returns from the product screener dataset.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ticker` | string | Yes | ETF ticker symbol (e.g. IVV, AGG, EEM). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-blackrock-com-api-36b759ee/get_etf_performance \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticker":"<string>"}'
```

### get_etf_sector_breakdown

Retrieve the sector allocation for a specific ETF, aggregated from individual holdings. Returns sectors sorted by weight descending. Uses the holdings v2 API internally.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ticker` | string | Yes | ETF ticker symbol (e.g. IVV, AGG, EEM). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-blackrock-com-api-36b759ee/get_etf_sector_breakdown \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticker":"<string>"}'
```

### search_etfs

Search for iShares ETFs by keyword, ticker symbol, or fund name. Returns matching ETFs with basic identifiers. Case-insensitive substring match against ticker and fund name.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results to return (0 for all). |
| `query` | string | Yes | Search keyword or ticker symbol (case-insensitive). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-blackrock-com-api-36b759ee/search_etfs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```