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

> 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-nasdaq-com-api-8357401b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-nasdaq-com-api-8357401b/get_cryptocurrency_quote \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nasdaq-com-api-8357401b/get_earnings_calendar \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nasdaq-com-api-8357401b/get_etf_quote \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nasdaq-com-api-8357401b/get_index_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nasdaq-com-api-8357401b/get_market_indices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nasdaq-com-api-8357401b/get_market_movers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nasdaq-com-api-8357401b/get_mutual_fund_quote \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nasdaq-com-api-8357401b/get_retail_trading_activity \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nasdaq-com-api-8357401b/get_stock_dividend_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nasdaq-com-api-8357401b/get_stock_earnings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nasdaq-com-api-8357401b/get_stock_financials \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nasdaq-com-api-8357401b/get_stock_historical_quotes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nasdaq-com-api-8357401b/get_stock_institutional_holdings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nasdaq-com-api-8357401b/get_stock_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nasdaq-com-api-8357401b/get_stock_option_chain \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nasdaq-com-api-8357401b/get_stock_quote \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nasdaq-com-api-8357401b/get_stock_screener \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nasdaq-com-api-8357401b/get_stock_sec_filings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nasdaq-com-api-8357401b/get_stock_short_interest \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nasdaq-com-api-8357401b/search_symbols \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```