# Nasdaq — 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.

> Track real-time and historical stock prices, ETF and mutual fund quotes, cryptocurrency data, and comprehensive company financials including earnings, dividends, and SEC filings all from one source. Research market trends with institutional holdings, short interest data, retail trading activity, and market movers to make informed investment decisions.

**Category:** Finance & Markets | **Website:** [nasdaq.com/](https://nasdaq.com/) | **Docs:** [parse.bot/marketplace/8357401b-21c5-4fa5-8701-fff62d9a9922/nasdaq-com-api](https://parse.bot/marketplace/8357401b-21c5-4fa5-8701-fff62d9a9922/nasdaq-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/nasdaq/`
**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 cryptocurrency quote

Real-time cryptocurrency price and daily change. Coverage limited to major coins supported by Nasdaq (confirmed: BTC, ETH). Unsupported symbols return an upstream error.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Crypto symbol (e.g. BTC, ETH). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nasdaq/get-cryptocurrency-quote \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### Get earnings calendar

Earnings calendar for a specified date. Past dates include actual EPS and surprise; future dates include EPS forecasts and analyst estimates.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Calendar date in YYYY-MM-DD format. Omitting defaults to today. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nasdaq/get-earnings-calendar \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>"}'
```

### Get etf quote

Real-time quote and details for an ETF including price, net change, percentage change, volume, and market status.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | ETF symbol (e.g. QQQ). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nasdaq/get-etf-quote \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### Get index detail

Detailed quote data for a specific market index including price, net change, percentage change, volume, and daily high/low.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | No | Index symbol (e.g. COMP, NDX, NBI). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nasdaq/get-index-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### Get market indices

Current values for the NASDAQ Composite index (COMP) including last price, net change, percentage change, volume, and daily high/low.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nasdaq/get-market-indices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get market movers

Top market movers: most active by share volume, most advanced, most declined, most active by dollar volume, and Nasdaq 100 movers. Each section has a table of symbols with price and change data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asset_class` | string | No | Asset class: stocks, etf. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nasdaq/get-market-movers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"asset_class":"<string>"}'
```

### Get mutual fund quote

Quote and details for a mutual fund including NAV and daily change. Mutual funds show isRealTime=false and have no bid/ask/volume data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Mutual fund symbol (e.g. VFIAX). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nasdaq/get-mutual-fund-quote \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### Get retail trading activity

Retail Trading Activity Tracker (RTAT) showing the top 5 stocks by percent of retail equity flow, with activity percentage change and buy/sell sentiment.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nasdaq/get-retail-trading-activity \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get stock dividend history

Dividend history for a stock including ex-dividend date, current yield, annualized dividend, payout ratio, and historical dividend payment records.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asset_class` | string | No | Asset class: stocks, etf, mutualfunds. |
| `symbol` | string | Yes | Stock symbol (e.g. AAPL). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nasdaq/get-stock-dividend-history \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"asset_class":"<string>","symbol":"<string>"}'
```

### Get stock earnings

Earnings data for a stock: EPS history (previous and upcoming quarters with consensus vs actual) and upcoming earnings date with analyst forecast information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Stock symbol (e.g. AAPL). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nasdaq/get-stock-earnings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### Get stock financials

Financial statements for a stock: Income Statement, Balance Sheet, Cash Flow, and Financial Ratios. Returns 4 periods of data (annual or quarterly based on frequency parameter).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `frequency` | integer | No | 1 for annual, 2 for quarterly. |
| `symbol` | string | Yes | Stock symbol (e.g. AAPL). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nasdaq/get-stock-financials \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"frequency":"<integer>","symbol":"<string>"}'
```

### Get stock historical quotes

Historical OHLCV price data for a symbol. Without explicit date range, defaults to one year ending today. Each row contains date, close, volume, open, high, and low.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asset_class` | string | No | Asset class: stocks, etf, mutualfunds, crypto. |
| `from_date` | string | No | Start date in YYYY-MM-DD format. Omitting defaults to one year ago. |
| `limit` | integer | No | Number of records to return. |
| `symbol` | string | Yes | Stock symbol (e.g. AAPL). |
| `to_date` | string | No | End date in YYYY-MM-DD format. Omitting defaults to today. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nasdaq/get-stock-historical-quotes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"asset_class":"<string>","from_date":"<string>","limit":"<integer>","symbol":"<string>","to_date":"<string>"}'
```

### Get stock institutional holdings

Institutional holdings data for a stock: ownership summary, active/new/sold-out position counts, and individual holder transactions sorted by market value.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max records to return in holdingsTransactions. |
| `symbol` | string | Yes | Stock symbol (e.g. AAPL). |
| `type` | string | No | Holdings type filter: TOTAL, INCREASED, DECREASED, NEW, SOLD_OUT. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nasdaq/get-stock-institutional-holdings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","symbol":"<string>","type":"<string>"}'
```

### Get stock news

Latest news headlines for a stock symbol. Returns articles where the symbol appears as primary or related symbol, with title, publisher, description, and publication date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asset_class` | string | No | Asset class: stocks, etf, mutualfunds, crypto. |
| `limit` | integer | No | Max results to return. |
| `offset` | integer | No | Offset for pagination. |
| `symbol` | string | Yes | Stock symbol (e.g. AAPL). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nasdaq/get-stock-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"asset_class":"<string>","limit":"<integer>","offset":"<integer>","symbol":"<string>"}'
```

### Get stock option chain

Options chain data for a stock including calls and puts with strike prices, bid/ask, volume, and open interest. Grouped by expiry date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asset_class` | string | No | Asset class: stocks, etf. |
| `limit` | integer | No | Max records to return. |
| `symbol` | string | Yes | Stock symbol (e.g. AAPL). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nasdaq/get-stock-option-chain \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"asset_class":"<string>","limit":"<integer>","symbol":"<string>"}'
```

### Get stock quote

Real-time quote for a single equity including last sale price, net change, percentage change, bid/ask, volume, 52-week range, and market status. Response shape varies by asset class (stocks show keyStats; ETFs and crypto do not).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asset_class` | string | No | Asset class: stocks, etf, mutualfunds, crypto. |
| `symbol` | string | Yes | Stock symbol (e.g. AAPL). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nasdaq/get-stock-quote \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"asset_class":"<string>","symbol":"<string>"}'
```

### Get stock screener

Screen stocks by exchange and market capitalization. Returns paginated results with symbol, name, last sale, change, and market cap. Also returns available filter option values.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `exchange` | string | No | Exchange filter: NASDAQ, NYSE, AMEX. |
| `limit` | integer | No | Max results to return. |
| `market_cap` | string | No | Market cap filter: mega, large, mid, small, micro, nano. |
| `offset` | integer | No | Offset for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nasdaq/get-stock-screener \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"exchange":"<string>","limit":"<integer>","market_cap":"<string>","offset":"<integer>"}'
```

### Get stock sec filings

SEC filings for a stock symbol including 10-K, 10-Q, 8-K, and other filing types. Returns filing metadata with links to view documents.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max records to return. |
| `symbol` | string | Yes | Stock symbol (e.g. AAPL). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nasdaq/get-stock-sec-filings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","symbol":"<string>"}'
```

### Get stock short interest

Short interest history for a stock: settlement dates, short interest counts, average daily share volume, and days to cover. Typically 24 biweekly data points.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asset_class` | string | No | Asset class: stocks, etf. |
| `symbol` | string | Yes | Stock symbol (e.g. AAPL). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nasdaq/get-stock-short-interest \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"asset_class":"<string>","symbol":"<string>"}'
```

### Search symbols

Full-text search across stocks, ETFs, funds, and indices by symbol or company name. Returns scored results with metadata (exchange, asset type, market cap) and real-time market data (last sale, change, percent change). Results are relevance-ranked; the top_hit field surfaces the single best match.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results to return. |
| `query` | string | Yes | Search keyword (symbol or company name). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nasdaq/search-symbols \
  -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.