# Nasdaq API

> Nasdaq returns earnings, IPO, and dividend data as a workflow and API.

Nasdaq returns scheduled earnings, market caps, and estimates for a reporting date and result limit. Nasdaq returns IPO entries for a month and listing stage, with dates, prices, offer amounts, and shares. Nasdaq returns dividend calendar entries for an ex-dividend date and a company's past payments by name or ticker.

- Page: https://fous.com/workflows/nasdaq
- Handle: `@nasdaq`
- Category: [Finance](https://fous.com/workflows/category/finance)
- Source website: https://nasdaq.com
- Last verified: Sep 29, 2026
- Fous is not affiliated with Nasdaq.

## Methods

### Get dividend calendar

Operation `get_dividend_calendar`, version 1. 1 credit per call.

List Nasdaq dividend calendar entries going ex-dividend on a day, sorted by company name. Includes ETFs and other listed securities shown by Nasdaq; dividend yield is not shown by this calendar and is null.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `date` | string | no | `"2026-09-29"` | Ex-dividend date in US Eastern time, for example 2026-09-28. Defaults to today in US Eastern time. |
| `max_results` | integer | no |  | Maximum number of entries to return, for example 100. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Ex-dividend date in US Eastern time, for example 2026-09-28. Defaults to today in US Eastern time.",
      "examples": [
        "2026-09-29",
        "2026-09-28",
        "2026-09-27"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 100,
      "maximum": 500,
      "minimum": 1,
      "description": "Maximum number of entries to return, for example 100.",
      "x-fous-developer": true
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "date": "2026-09-29"
    },
    {
      "date": "2026-09-28"
    },
    {
      "date": "2026-09-27"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `dividends` | array |  |  |
| `dividends[].ticker` | string | `"ERIC"` | Trading symbol. |
| `dividends[].company` | string | `"Ericsson American Depositary Shares"` | Company or security name. |
| `dividends[].page_link` | string | `"https://www.nasdaq.com/market-activity/stocks/eric/dividend-history"` | Nasdaq dividend history page for this ticker. |
| `dividends[].record_date` | string or null | `"2026-09-29"` | Record date. |
| `dividends[].payment_date` | string or null | `"2026-09-28"` | Payment date. |
| `dividends[].ex_dividend_date` | string or null | `"2026-09-29"` | Ex-dividend date. |
| `dividends[].announcement_date` | string or null | `"2026-09-28"` | Announcement date. |
| `dividends[].dividend_per_share_usd` | number or null | `0.15792` | Dividend per share in USD. |
| `dividends[].dividend_yield_percent` | number or null |  | Dividend yield percentage if shown, otherwise null. |
| `dividends[].indicated_annual_dividend_usd` | number or null | `0.332546` | Historical annual dividend per share in USD as shown by Nasdaq. |

**Example input**

```json
{
  "date": "2026-09-29"
}
```

**Example output**

```json
{
  "dividends": [
    {
      "ticker": "ERIC",
      "company": "Ericsson American Depositary Shares",
      "page_link": "https://www.nasdaq.com/market-activity/stocks/eric/dividend-history",
      "record_date": "2026-09-29",
      "payment_date": "2026-09-28",
      "ex_dividend_date": "2026-09-29",
      "announcement_date": "2026-09-28",
      "dividend_per_share_usd": 0.15792,
      "dividend_yield_percent": null,
      "indicated_annual_dividend_usd": 0.332546
    },
    {
      "ticker": "ITRN",
      "company": "Ituran Location and Control Ltd. Ordinary Shares",
      "page_link": "https://www.nasdaq.com/market-activity/stocks/itrn/dividend-history",
      "record_date": "2026-09-29",
      "payment_date": "2026-10-14",
      "ex_dividend_date": "2026-09-29",
      "announcement_date": "2026-08-12",
      "dividend_per_share_usd": 0.5,
      "dividend_yield_percent": null,
      "indicated_annual_dividend_usd": 2
    },
    {
      "ticker": "SATA",
      "company": "Strive, Inc. Variable Rate Series A Perpetual Preferred Stock",
      "page_link": "https://www.nasdaq.com/market-activity/stocks/sata/dividend-history",
      "record_date": "2026-09-29",
      "payment_date": "2026-09-30",
      "ex_dividend_date": "2026-09-29",
      "announcement_date": "2026-08-13",
      "dividend_per_share_usd": 0.0516,
      "dividend_yield_percent": null,
      "indicated_annual_dividend_usd": 12.8484
    }
  ]
}
```

### Get dividend history

Operation `get_dividend_history`, version 1. 1 credit per call.

Get a company’s dividend summary and past per-share payments, newest first. Nasdaq publishes dividend history only for Nasdaq-listed stocks; other listings may have no available history.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `company` | string | yes | `"AAPL"` | Company name or stock ticker, for example Apple or AAPL. |
| `max_results` | integer | no | `2` | Maximum number of past payments, for example 20. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "company"
  ],
  "properties": {
    "company": {
      "type": "string",
      "description": "Company name or stock ticker, for example Apple or AAPL.",
      "examples": [
        "AAPL",
        "TSLA",
        "Apple"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 200,
      "minimum": 1,
      "description": "Maximum number of past payments, for example 20.",
      "x-fous-developer": true,
      "examples": [
        2,
        5
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "company": "AAPL",
      "max_results": 2
    },
    {
      "company": "TSLA"
    },
    {
      "company": "Apple",
      "max_results": 5
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `ticker` | string | `"AAPL"` | Stock ticker. |
| `company` | string | `"Apple Inc. Common Stock"` | Company name. |
| `page_url` | string | `"https://www.nasdaq.com/market-activity/stocks/aapl/dividend-history"` | Nasdaq dividend history page. |
| `payments` | array |  | Past payments, newest first. |
| `payments[].type` | string or null | `"Cash"` | Dividend payment type. |
| `payments[].page_url` | string | `"https://www.nasdaq.com/market-activity/stocks/aapl/dividend-history"` | Nasdaq page for the payment history. |
| `payments[].record_date` | string or null | `"2026-08-10"` | Record date, YYYY-MM-DD. |
| `payments[].payment_date` | string or null | `"2026-08-13"` | Payment date, YYYY-MM-DD. |
| `payments[].declaration_date` | string or null | `"2026-07-30"` | Declaration date, YYYY-MM-DD. |
| `payments[].ex_dividend_date` | string or null | `"2026-08-10"` | Ex-dividend date, YYYY-MM-DD. |
| `payments[].amount_per_share_usd` | number or null | `0.27` | Cash amount per share in USD. |
| `annual_dividend_usd` | number or null | `1.08` | Current annual dividend in USD per share, or null when unavailable. |
| `payout_ratio_percent` | number or null |  | Payout ratio as a percent only when Nasdaq shows it. |
| `dividend_yield_percent` | number or null | `0.32` | Current dividend yield as a percent, or null when unavailable. |

**Example input**

```json
{
  "company": "AAPL",
  "max_results": 2
}
```

**Example output**

```json
{
  "ticker": "AAPL",
  "company": "Apple Inc. Common Stock",
  "page_url": "https://www.nasdaq.com/market-activity/stocks/aapl/dividend-history",
  "payments": [
    {
      "type": "Cash",
      "page_url": "https://www.nasdaq.com/market-activity/stocks/aapl/dividend-history",
      "record_date": "2026-08-10",
      "payment_date": "2026-08-13",
      "declaration_date": "2026-07-30",
      "ex_dividend_date": "2026-08-10",
      "amount_per_share_usd": 0.27
    },
    {
      "type": "Cash",
      "page_url": "https://www.nasdaq.com/market-activity/stocks/aapl/dividend-history",
      "record_date": "2026-05-11",
      "payment_date": "2026-05-14",
      "declaration_date": "2026-04-30",
      "ex_dividend_date": "2026-05-11",
      "amount_per_share_usd": 0.27
    }
  ],
  "annual_dividend_usd": 1.08,
  "payout_ratio_percent": null,
  "dividend_yield_percent": 0.32
}
```

### Get earnings calendar

Operation `get_earnings_calendar`, version 1. 1 credit per call.

List companies scheduled to report quarterly earnings on a date, sorted by market cap. Nasdaq supplies fiscal quarter ending by month, not exact day; unavailable figures are null.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `date` | string | no | `"2026-09-26"` | Reporting date in US Eastern time, for example 2026-09-29. Defaults to today in US Eastern time. |
| `max_results` | integer | no | `100` | Maximum companies to return, for example 100. Defaults to 100; at most 500. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Reporting date in US Eastern time, for example 2026-09-29. Defaults to today in US Eastern time.",
      "examples": [
        "2026-09-26",
        "2026-09-29",
        "2026-10-29"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 100,
      "maximum": 500,
      "minimum": 1,
      "description": "Maximum companies to return, for example 100. Defaults to 100; at most 500.",
      "x-fous-developer": true,
      "examples": [
        100
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "date": "2026-09-26"
    },
    {
      "date": "2026-09-29",
      "max_results": 100
    },
    {
      "date": "2026-10-29",
      "max_results": 100
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `companies` | array |  | Companies reporting earnings on the selected date, largest market cap first. |
| `companies[].ticker` | string | `"CCL"` | Stock ticker. |
| `companies[].company` | string | `"Carnival Corporation Ltd."` | Company name. |
| `companies[].page_url` | string | `"https://www.nasdaq.com/market-activity/stocks/ccl/earnings"` | Nasdaq earnings page for this company. |
| `companies[].report_time` | string | `"Before market open"` | Expected reporting time. |
| `companies[].market_cap_usd` | number or null | `30474692600` | Full market capitalization in USD. |
| `companies[].eps_forecast_usd` | number or null | `1.36` | Consensus EPS forecast in USD per share. |
| `companies[].last_year_eps_usd` | number or null | `1.43` | EPS reported last year in USD per share. |
| `companies[].number_of_estimates` | integer or null | `7` | Number of analyst estimates. |
| `companies[].fiscal_quarter_ending` | string or null | `"2026-08"` | Fiscal quarter ending month in YYYY-MM format; Nasdaq does not give an exact day. |
| `companies[].last_year_report_date` | string or null | `"2025-09-29"` | Previous year report date in YYYY-MM-DD format. |

**Example input**

```json
{
  "date": "2026-09-26"
}
```

**Example output**

```json
{
  "companies": []
}
```

### Get ipo calendar

Operation `get_ipo_calendar`, version 1. 1 credit per call.

List Nasdaq’s US IPO calendar entries for a month and status, with dates, prices, shares, offer amounts and listing links. Filed and withdrawn entries may not show a price or exchange.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `month` | string | no | `"2026-09"` | Calendar month in YYYY-MM; defaults to the current month. Example: 2026-09. |
| `status` | string | no | `"upcoming"` | Listing stage to return; defaults to upcoming. Example: priced. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "month": {
      "type": "string",
      "pattern": "^[0-9]{4}-(0[1-9]|1[0-2])$",
      "description": "Calendar month in YYYY-MM; defaults to the current month. Example: 2026-09.",
      "examples": [
        "2026-09",
        "2026-10"
      ]
    },
    "status": {
      "enum": [
        "upcoming",
        "priced",
        "filed",
        "withdrawn"
      ],
      "type": "string",
      "default": "upcoming",
      "description": "Listing stage to return; defaults to upcoming. Example: priced.",
      "examples": [
        "upcoming",
        "priced",
        "withdrawn"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "month": "2026-09",
      "status": "upcoming"
    },
    {
      "month": "2026-09",
      "status": "priced"
    },
    {
      "month": "2026-09",
      "status": "withdrawn"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `ipos` | array |  | IPO entries sorted by date, earliest first. The date is the expected listing, pricing, filing or withdrawal date according to status. |
| `ipos[].date` | string or null | `"2026-09-30"` |  |
| `ipos[].ticker` | string or null | `"ACCV"` |  |
| `ipos[].company` | string or null | `"Accelevation Holdings Corp."` |  |
| `ipos[].exchange` | string or null | `"NASDAQ Global Select"` |  |
| `ipos[].deal_size` | number or null | `828000000` | Full offer amount. |
| `ipos[].price_low` | number or null | `20` | Low end of price range, or final price. |
| `ipos[].price_high` | number or null | `24` | High end of price range, or final price. |
| `ipos[].nasdaq_link` | string | `"https://www.nasdaq.com/market-activity/ipos/overview?dealId=1400711-119247"` |  |
| `ipos[].price_currency` | string or null | `"USD"` | USD when a price is shown. |
| `ipos[].shares_offered` | integer or null | `30000000` |  |
| `ipos[].deal_size_currency` | string or null | `"USD"` | USD when an offer amount is shown. |

**Example input**

```json
{
  "month": "2026-09",
  "status": "upcoming"
}
```

**Example output**

```json
{
  "ipos": [
    {
      "date": "2026-09-30",
      "ticker": "ACCV",
      "company": "Accelevation Holdings Corp.",
      "exchange": "NASDAQ Global Select",
      "deal_size": 828000000,
      "price_low": 20,
      "price_high": 24,
      "nasdaq_link": "https://www.nasdaq.com/market-activity/ipos/overview?dealId=1400711-119247",
      "price_currency": "USD",
      "shares_offered": 30000000,
      "deal_size_currency": "USD"
    },
    {
      "date": "2026-09-30",
      "ticker": "OURA",
      "company": "Oura Inc.",
      "exchange": "NASDAQ Global Select",
      "deal_size": 2530000000,
      "price_low": 40,
      "price_high": 44,
      "nasdaq_link": "https://www.nasdaq.com/market-activity/ipos/overview?dealId=1400871-119254",
      "price_currency": "USD",
      "shares_offered": 50000000,
      "deal_size_currency": "USD"
    },
    {
      "date": "2026-09-30",
      "ticker": "PTT",
      "company": "SIYATA PTT",
      "exchange": "NASDAQ Capital",
      "deal_size": null,
      "price_low": null,
      "price_high": null,
      "nasdaq_link": "https://www.nasdaq.com/market-activity/ipos/overview?dealId=1397270-118941",
      "price_currency": null,
      "shares_offered": 6112327,
      "deal_size_currency": null
    }
  ]
}
```

## Quick start

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@nasdaq",
  "visibility": "public",
  "operation": "get_dividend_calendar",
  "version": 1,
  "input": {
    "date": "2026-09-29"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

body = json.loads("{\n  \"api\": \"@nasdaq\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_dividend_calendar\",\n  \"version\": 1,\n  \"input\": {\n    \"date\": \"2026-09-29\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=120) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_000),
  body: JSON.stringify({
  "api": "@nasdaq",
  "visibility": "public",
  "operation": "get_dividend_calendar",
  "version": 1,
  "input": {
    "date": "2026-09-29"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

Or describe the data in plain language: send `{"api":"@nasdaq","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## Use cases

- Review companies scheduled to report earnings on a date.
- Compare earnings estimates and market capitalizations for scheduled companies.
- Track IPO dates, listing stages, prices, and offer amounts.
- Find securities going ex-dividend on a selected date.
- Review a company's past dividend payments and summary.

## FAQ

### Is Fous affiliated with Nasdaq?

No. Fous is not affiliated with Nasdaq. This workflow reads the public nasdaq.com website and returns its data.

### How much does it cost?

Each run costs 1 credit. With pay-as-you-go, a credit costs 1¢; monthly plans cost less per credit.

### Do I need a Nasdaq account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from nasdaq.com when you run it; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 29, 2026.

### Which companies are scheduled to report earnings on a date?

Get earnings calendar lists companies scheduled to report on a selected date, sorted by market capitalization.

### Which IPOs are listed for a month and status?

Get ipo calendar lists IPO entries for a selected month and listing stage, with available dates, prices, and offer amounts.

### What dividends are scheduled or have been paid?

Get dividend calendar lists entries by ex-dividend date. Get dividend history returns past payments and a company's dividend summary.

## Related

- [Yahoo Finance API](https://fous.com/workflows/yahoo-finance.md): Yahoo Finance provides quotes, movers, company financials, analyst ratings, earnings, news, and up to 5,000 price rows with adjusted returns; prices may be delayed.
- [Stock Analysis API](https://fous.com/workflows/stock-analysis.md): Stock Analysis returns free-period company statements, statistics current as of its displayed date, typically top-25 ETF holdings, and US IPOs since 2019 with potentially missing prices or returns.
- [SEC EDGAR API](https://fous.com/workflows/sec-edgar.md): SEC EDGAR provides filings, annual and quarterly financials, exact-phrase matches, up to 200 insider trades, and quarterly 13F manager holdings; older filings appear when available.
- [Investing.com API](https://fous.com/workflows/investing-com.md): Investing.com provides financial markets data and news, economic releases up to 31 days, and current commodity prices and government bond yields, which may be delayed or indicative.
- [CompaniesMarketCap API](https://fous.com/workflows/companiesmarketcap.md): CompaniesMarketCap ranks public companies worldwide or by country and industry across size and financial measures, and provides company figures with market-cap history for completed years.
- [Macrotrends API](https://fous.com/workflows/macrotrends.md): Macrotrends provides long-term financial and economic charts, company metric histories, and yearly commodity and index prices; current-year prices may be incomplete.
- [Google Finance API](https://fous.com/workflows/google-finance.md): Google Finance returns possibly delayed prices and figures, indexes, up to four movers timed by oldest quote, currency conversions, and up to five financial periods.
- [MSN Money API](https://fous.com/workflows/msn-money.md): MSN Money provides stock quotes, key facts, financial news, and market data, including current market movers; quotes and prices may be delayed.
- [All Finance workflows](https://fous.com/workflows/category/finance)