# 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/tools/nasdaq
- Handle: `@nasdaq`
- Category: [Finance](https://fous.com/tools/category/finance)
- Source website: https://nasdaq.com
- Last verified: Sep 29, 2026

## Methods

### Get dividend calendar

Operation `get_dividend_calendar`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

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 completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

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 completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

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 completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

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

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_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.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

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=180) 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.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_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);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/nasdaq`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_dividend_calendar`: Get dividend calendar. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_dividend_history`: Get dividend history. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_earnings_calendar`: Get earnings calendar. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_ipo_calendar`: Get ipo calendar. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-nasdaq https://api.fous.com/mcp/tools/nasdaq --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## 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

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Nasdaq tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. 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. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified 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/tools/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/tools/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/tools/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/tools/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/tools/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/tools/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/tools/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/tools/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 tools](https://fous.com/tools/category/finance)