# IPO Calendar API
> The live pipeline of US stock-market initial public offerings, served from Nasdaq's public IPO calendar — no key, nothing cached. This is the deal flow of companies going public, the data IPO investors and traders watch. The priced endpoint returns the IPOs that have just priced and begun trading, each with the ticker, company, exchange, offer price, shares offered, pricing date and total deal size. The upcoming endpoint returns the IPOs expected to price soon, with their price range and expected date — the near-term pipeline. The filed endpoint returns companies that have newly filed to go public, the earliest signal of a coming listing. The calendar endpoint returns the whole month in one call — priced, upcoming and filed — with counts. Any month back through the archive can be requested, and with no month it returns the current one. Everything is live from Nasdaq, nothing stored. This is the IPO-pipeline layer for any trading, investing, screener or finance app. Distinct from stock-quote and earnings APIs — this is the calendar of companies coming to market: priced, upcoming and freshly filed offerings. 4 endpoints, no key on our side.

## 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/ipo-api/..."
```

## Pricing
- **Free** (Free) — 3,200 calls/Mo, 3 req/s
- **Starter** ($9/Mo) — 48,000 calls/Mo, 8 req/s
- **Pro** ($23/Mo) — 260,000 calls/Mo, 20 req/s
- **Mega** ($55/Mo) — 1,250,000 calls/Mo, 50 req/s

## Endpoints

### IPO

#### `GET /v1/calendar` — Whole month: priced, upcoming, filed

**Parameters:**
- `month` (query, optional, string) — YYYY-MM (default current)

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

**Response:**
```json
{
    "data": {
        "year": 2026,
        "filed": [
            {
                "symbol": "CGCFU",
                "company": "Cartesian Growth Corp IV",
                "filed_date": "6/08/2026",
                "deal_size_usd": 287500000
            },
            {
                "symbol": "RACD",
                "company": "Research Alliance Corp IV",
                "filed_date": "6/08/2026",
                "deal_size_usd": 75000000
            },
            {
                "symbol": "SIAI",
                "company": "Silentium Ltd.",
                "filed_date": "6/08/2026",
                "deal_size_usd": 19780000
            },
            {
                "symbol": "APBDU",
                "company": "AParadise II Acquisition Corp.",
                "filed_date": "6/08/2026",
                "deal_size_usd": 155250000
            },
            {
                "symbol": null,
                "company": "Star Integratia Ltd",
                "filed_date": "6/08/2026",
                "deal_size_usd": 38333336
            },
            {
                "symbol": "BSP",
                "company": "Bending Spoons S.p.A.",
                "filed_date": "6/08/2026",
                "deal_size_usd": 100000000
            },
            {
                "symbol": null,
                "company": "Spring Valley Acquisition Corp. V",
                "filed_date": "6/08/2026",
                "deal_size_usd": 230000000
            },
            {
         
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/filed` — Companies newly filed to go public

**Parameters:**
- `month` (query, optional, string) — YYYY-MM (default current)

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

**Response:**
```json
{
    "data": {
        "year": 2026,
        "count": 15,
        "filed": [
            {
                "symbol": "CGCFU",
                "company": "Cartesian Growth Corp IV",
                "filed_date": "6/08/2026",
                "deal_size_usd": 287500000
            },
            {
                "symbol": "RACD",
                "company": "Research Alliance Corp IV",
                "filed_date": "6/08/2026",
                "deal_size_usd": 75000000
            },
            {
                "symbol": "SIAI",
                "company": "Silentium Ltd.",
                "filed_date": "6/08/2026",
                "deal_size_usd": 19780000
            },
            {
                "symbol": "APBDU",
                "company": "AParadise II Acquisition Corp.",
                "filed_date": "6/08/2026",
                "deal_size_usd": 155250000
            },
            {
                "symbol": null,
                "company": "Star Integratia Ltd",
                "filed_date": "6/08/2026",
                "deal_size_usd": 38333336
            },
            {
                "symbol": "BSP",
                "company": "Bending Spoons S.p.A.",
                "filed_date": "6/08/2026",
                "deal_size_usd": 100000000
            },
            {
                "symbol": null,
                "company": "Spring Valley Acquisition Corp. V",
                "filed_date": "6/08/2026",
                "deal_size_usd": 230000000
            },
  
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/priced` — IPOs that have just priced

**Parameters:**
- `month` (query, optional, string) — YYYY-MM (default current)

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

**Response:**
```json
{
    "data": {
        "year": 2026,
        "count": 11,
        "month": 6,
        "priced": [
            {
                "status": "Priced",
                "symbol": "FTRAU",
                "company": "FutureCorp Space Acquisition 1",
                "exchange": "NYSE",
                "priced_date": "6/05/2026",
                "share_price": "10.00",
                "deal_size_usd": 200000000,
                "shares_offered": 20000000
            },
            {
                "status": "Priced",
                "symbol": "LFTO",
                "company": "Liftoff Mobile, Inc.",
                "exchange": "NASDAQ Global Select",
                "priced_date": "6/04/2026",
                "share_price": "23.00",
                "deal_size_usd": 437000000,
                "shares_offered": 19000000
            },
            {
                "status": "Priced",
                "symbol": "SSMR",
                "company": "Sunshine Silver Mining & Refining Co",
                "exchange": "NYSE",
                "priced_date": "6/04/2026",
                "share_price": "13.50",
                "deal_size_usd": 270000000,
                "shares_offered": 20000000
            },
            {
                "status": "Priced",
                "symbol": "LTGRU",
                "company": "Long Table Growth Corp.",
                "exchange": "NASDAQ Global",
                "priced_date": "6/04/2026",
                "share_price": "10.00",
                "de
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/upcoming` — IPOs expected to price soon

**Parameters:**
- `month` (query, optional, string) — YYYY-MM (default current)

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

**Response:**
```json
{
    "data": {
        "year": 2026,
        "count": 9,
        "month": 6,
        "source": "Nasdaq",
        "upcoming": [
            {
                "symbol": "FCBM",
                "company": "First Carolina Financial Services, Inc.",
                "exchange": "NYSE",
                "price_range": "14.00-16.00",
                "deal_size_usd": 101200000,
                "expected_date": "6/18/2026",
                "shares_offered": 5500000
            },
            {
                "symbol": "SPCX",
                "company": "SPACE EXPLORATION TECHNOLOGIES CORP",
                "exchange": "NASDAQ",
                "price_range": "135.00",
                "deal_size_usd": 86249999880,
                "expected_date": "6/12/2026",
                "shares_offered": 555555555
            },
            {
                "symbol": "FRBT",
                "company": "Forbright, Inc.",
                "exchange": "NASDAQ Global Select",
                "price_range": "18.00-20.00",
                "deal_size_usd": 181700000,
                "expected_date": "6/11/2026",
                "shares_offered": 7900000
            },
            {
                "symbol": "JABU",
                "company": "JAB Acquisition Corp I",
                "exchange": "NASDAQ Global",
                "price_range": "10.00",
                "deal_size_usd": 172500000,
                "expected_date": "6/10/2026",
                "shares_offered": 15000000
            },
        
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Spec

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

**Response:**
```json
{
    "data": {
        "source": "Nasdaq IPO calendar (live)",
        "service": "ipo-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/filed": "Companies newly filed to go public (month= optional).",
            "GET /v1/priced": "IPOs that have just priced and begun trading (month= optional).",
            "GET /v1/calendar": "The whole month — priced, upcoming and filed IPOs with counts (month=2026-06, optional).",
            "GET /v1/upcoming": "IPOs expected to price soon, with price range (month= optional)."
        },
        "description": "The live pipeline of US stock-market IPOs from Nasdaq's public IPO calendar: the offerings that have just priced and begun trading (ticker, company, exchange, offer price, shares, date, deal size); the IPOs expected to price soon with their price range; companies that have newly filed to go public; and the whole month in one call with counts. Any past month can be requested; with no month, the current one is returned. Live, no key, nothing stored. Distinct from stock-quote and earnings APIs — this is the calendar of companies coming to market: priced, upcoming and freshly filed offerings.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-09T20:24:47.147Z",
        "request_id": "0a5745fa-76e3-4001-8159-68f38664c3de"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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