# NASDAQ Listings API
> The directory of every security listed on the NASDAQ stock market as an API — the reference a brokerage, stock screener or ticker-validation tool needs to confirm a symbol is NASDAQ-listed and see what kind of instrument it is. For each of 5,400+ securities the API returns its ticker symbol, the full security name and a normalized security type (common stock, ETF / fund, warrant, unit, right, preferred, note or depositary receipt) derived from the listing. Look a ticker up, search by symbol or company name, filter by security type, or list them all with a per-type breakdown. This is the NASDAQ listing directory — distinct from sp500-api (S&P 500 index membership) and finance-api (live quotes). Served from memory — always fast.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/nasdaq-api/..."
```

## Pricing
- **Free** (Free) — 16,000 calls/Mo, 3 req/s
- **Starter** ($8/Mo) — 180,000 calls/Mo, 10 req/s
- **Pro** ($23/Mo) — 900,000 calls/Mo, 25 req/s
- **Mega** ($55/Mo) — 4,500,000 calls/Mo, 60 req/s

## Endpoints

### Lookup

#### `GET /v1/symbol` — Security by ticker symbol

**Parameters:**
- `symbol` (query, required, string) — Ticker symbol Example: `AAPL`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nasdaq-api/v1/symbol?symbol=AAPL"
```

**Response:**
```json
{
    "data": {
        "security": {
            "name": "Apple Inc. - Common Stock",
            "type": "Common Stock",
            "symbol": "AAPL",
            "type_raw": "Common Stock"
        }
    },
    "meta": {
        "timestamp": "2026-06-08T18:25:05.646Z",
        "request_id": "d1c478fa-8b79-4704-86d7-301cd1cf3ce6"
    },
    "status": "ok",
    "message": "Security retrieved successfully",
    "success": true
}
```

### Search

#### `GET /v1/search` — Search by symbol or name

**Parameters:**
- `q` (query, required, string) — Search query (min 2 chars) Example: `apple`
- `limit` (query, optional, string) — Max results (1-100) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nasdaq-api/v1/search?q=apple&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 1,
        "query": "apple",
        "total": 1,
        "securities": [
            {
                "name": "Apple Inc. - Common Stock",
                "type": "Common Stock",
                "symbol": "AAPL",
                "type_raw": "Common Stock"
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-08T18:25:05.763Z",
        "request_id": "1568ff97-3835-4134-81bf-6c36fc476337"
    },
    "status": "ok",
    "message": "Search results retrieved successfully",
    "success": true
}
```

### Type

#### `GET /v1/type` — Securities of a type

**Parameters:**
- `type` (query, required, string) — common stock, etf, warrant, unit, right, preferred, note, depositary receipt Example: `etf`
- `limit` (query, optional, string) — Page size (1-500) Example: `100`
- `offset` (query, optional, string) — Offset Example: `0`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nasdaq-api/v1/type?type=etf&limit=100&offset=0"
```

**Response:**
```json
{
    "data": {
        "type": "etf",
        "count": 100,
        "total": 1243,
        "securities": [
            {
                "name": "AdvisorShares Dorsey Wright ADR ETF",
                "type": "Fund / ETF",
                "symbol": "AADR",
                "type_raw": ""
            },
            {
                "name": "Alpha Architect US Equity 2 ETF",
                "type": "Fund / ETF",
                "symbol": "AAEQ",
                "type_raw": ""
            },
            {
                "name": "Leverage Shares 2X Long AAL Daily ETF",
                "type": "Fund / ETF",
                "symbol": "AALG",
                "type_raw": ""
            },
            {
                "name": "GraniteShares 2x Long AAPL Daily ETF",
                "type": "Fund / ETF",
                "symbol": "AAPB",
                "type_raw": ""
            },
            {
                "name": "Direxion Daily AAPL Bear 1X ETF",
                "type": "Fund / ETF",
                "symbol": "AAPD",
                "type_raw": ""
            },
            {
                "name": "Direxion Daily AAPL Bull 2X ETF",
                "type": "Fund / ETF",
                "symbol": "AAPU",
                "type_raw": ""
            },
            {
                "name": "Alpha Architect US Equity ETF",
                "type": "Fund / ETF",
                "symbol": "AAUS",
                "type_raw": ""
            },
            {
                "name": "Alp
…(truncated, see openapi.json for full schema)
```

### List

#### `GET /v1/list` — List all securities

**Parameters:**
- `limit` (query, optional, string) — Page size (1-500) Example: `50`
- `offset` (query, optional, string) — Offset Example: `0`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nasdaq-api/v1/list?limit=50&offset=0"
```

**Response:**
```json
{
    "data": {
        "count": 50,
        "total": 5481,
        "securities": [
            {
                "name": "Artius II Acquisition Inc. - Class A Ordinary Shares",
                "type": "Common Stock",
                "symbol": "AACB",
                "type_raw": "Class A Ordinary Shares"
            },
            {
                "name": "Artius II Acquisition Inc. - Rights",
                "type": "Right",
                "symbol": "AACBR",
                "type_raw": "Rights"
            },
            {
                "name": "Artius II Acquisition Inc. - Units",
                "type": "Unit",
                "symbol": "AACBU",
                "type_raw": "Units"
            },
            {
                "name": "ATA Creativity Global - American Depositary Shares, each representing two common shares",
                "type": "Depositary Receipt",
                "symbol": "AACG",
                "type_raw": "American Depositary Shares, each representing two common shares"
            },
            {
                "name": "Armada Acquisition Corp. III - Class A Ordinary Share",
                "type": "Common Stock",
                "symbol": "AACI",
                "type_raw": "Class A Ordinary Share"
            },
            {
                "name": "Armada Acquisition Corp. III - Units",
                "type": "Unit",
                "symbol": "AACIU",
                "type_raw": "Units"
            },
            {
                "name":
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata + type breakdown

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nasdaq-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "types": {
            "Note": 63,
            "Unit": 251,
            "Other": 46,
            "Right": 92,
            "Warrant": 370,
            "Preferred": 110,
            "Fund / ETF": 1243,
            "Common Stock": 3141,
            "Depositary Receipt": 165
        },
        "service": "nasdaq-api",
        "endpoints": {
            "GET /v1/list": "List all securities (limit, offset).",
            "GET /v1/meta": "This document.",
            "GET /v1/type": "Securities of a type (type=, e.g. etf, warrant, unit, common stock).",
            "GET /v1/search": "Search by symbol or company name (q=).",
            "GET /v1/symbol": "Security by ticker symbol (symbol=, e.g. AAPL)."
        },
        "description": "Directory of NASDAQ-listed securities: ticker symbol, security name and normalized type (common stock, ETF/fund, warrant, unit, right, preferred, note, depositary receipt). Look up a ticker, search by symbol or name, filter by type, or list them all. The reference for confirming a symbol is NASDAQ-listed. Distinct from sp500-api (index) and finance-api (quotes). No key.",
        "total_securities": 5481
    },
    "meta": {
        "timestamp": "2026-06-08T18:25:06.140Z",
        "request_id": "02be7bf3-3cf3-41c8-85cd-c7a4f7501ff3"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/nasdaq-api
OpenAPI spec: https://www.oanor.com/api/nasdaq-api/openapi.json
