# Blackrock — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/blackrock/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/blackrock/get-broad-market-index-etfs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/blackrock/get-etf-fees \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/blackrock/get-etf-holdings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/blackrock/get-etf-holdings-download \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/blackrock/get-etf-key-facts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/blackrock/get-etf-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/blackrock/get-etf-overview \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/blackrock/get-etf-performance \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/blackrock/get-etf-sector-breakdown \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/blackrock/search-etfs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.