[Integrations](https://spiral.ai/integrations) › [Gemini](https://spiral.ai/integrations/gemini) › [Marketstack dividend history](https://spiral.ai/integrations/gemini/marketstack-dividend-history)

# How to Use Marketstack dividend history in Gemini

Marketstack dividend history returns dividend amounts, ex-dividend dates, payment dates, record dates, declaration dates, and distribution frequency for a ticker. Use it to review distributions or build a payment timeline.

|  |  |
| --- | --- |
| Model | Marketstack dividend history |
| Available through | Alexandria |
| Category | Finance |
| Price | Up to $0.034918 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Marketstack dividend history in Gemini

- Use Marketstack dividend history to list AAPL's 2024 dividends, showing each amount, ex-dividend date, and payment date.
- Use Marketstack dividend history to compare KO's returned dividend amounts in 2023 and 2024.
- Use Marketstack dividend history for MSFT during 2025 and show declaration, ex-dividend, record, and payment dates in separate columns.
- Use Marketstack dividend history to look this up and give me the result as a table.
- Pull the latest numbers from Marketstack dividend history and tell me what changed since last week.

## How to set up Marketstack dividend history in Gemini

Pick the way that suits you. Each takes about two minutes.

### Use the Gemini connector

1. **Open Connected Apps**: On your computer, go to gemini.google.com. At the bottom, click Settings › Connected Apps. If you don't see Connected Apps, click Personal Intelligence first, then Connected Apps.

2. **Add Spiral as a custom app**: Under Custom apps, click Add a custom app and paste this MCP server URL:

```text
https://api.spiral.ai/mcp
```

3. **Sign in to Spiral and approve**: Follow the on-screen instructions. Spiral opens: sign in, pick the organization and click Authorize. No API key.

### Use the Spiral skill

1. **Send Gemini this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Marketstack dividend history**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "marketstack/corporate-actions/dividends",
    "input": {
      "symbols": "<symbols>"
    }
  }'
```

Then paste one of the prompts above: Gemini finds Marketstack dividend history on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini

## Marketstack dividend history tools and prices

- [Marketstack · Dividends](https://spiral.ai/tools/alexandria/marketstack/corporate-actions/dividends) (Alexandria): Up to $0.034918 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| sort | DESC, ASC, desc, asc | — | Order by date. DESC, newest first, is the default. |
| limit | 1 to 100 | — | Rows per page, from 1 to 100. Default 100. The request costs the same whatever the row count. |
| offset | 0 to 1000000 | — | Rows to skip for the next page. Default 0. |
| date_to |  | — | Latest date, YYYY-MM-DD. |
| date_from |  | — | Earliest date, YYYY-MM-DD. |

## What can you do with Marketstack dividend history in Gemini?

Get a dated account of a public company's distributions or stock splits. A chat app can turn Marketstack's returned amounts, dates, and ratios into a table with an explanation of each event.

### Build a corporate action timeline

Combine Marketstack dividend history and Marketstack stock split history into a dated timeline for AAPL. Keep dividend milestones and split events labeled separately.

### Audit historical adjustments

Compare returned dividend events and split factors with the adjustment records in an existing market dataset. Produce a list of dates and values that need investigation.

### Test portfolio accounting

Use returned dividend distributions and split events as dated examples for testing cash entries and share-count changes in portfolio software.

### Prepare a company research brief

Summarize a public company's returned distributions and split events over a defined period. Include the dividend amounts and split ratios behind the summary.

### Review dividend payment timing

Arrange returned dividend records by payment date and compare them with their declaration, record, and ex-dividend dates.

### Compare dividend distributions over time

Group MSFT's returned dividend records by year and show the distribution amounts alongside their dates. Flag changes for further research.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Gemini guides](https://spiral.ai/integrations/gemini)

## Marketstack dividend history in other agents

- [Amp](https://spiral.ai/integrations/amp/marketstack-dividend-history)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/marketstack-dividend-history)
- [Claude](https://spiral.ai/integrations/claude-desktop/marketstack-dividend-history)
- [Claude Code](https://spiral.ai/integrations/claude-code/marketstack-dividend-history)
- [Cline](https://spiral.ai/integrations/cline/marketstack-dividend-history)
- [Codex](https://spiral.ai/integrations/codex/marketstack-dividend-history)
- [Cursor](https://spiral.ai/integrations/cursor/marketstack-dividend-history)
- [Devin](https://spiral.ai/integrations/devin/marketstack-dividend-history)
- [dots](https://spiral.ai/integrations/dots/marketstack-dividend-history)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/marketstack-dividend-history)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/marketstack-dividend-history)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/marketstack-dividend-history)
- [goose](https://spiral.ai/integrations/goose/marketstack-dividend-history)
- [Grok](https://spiral.ai/integrations/grok/marketstack-dividend-history)
- [Grok Build](https://spiral.ai/integrations/grok-build/marketstack-dividend-history)
- [Hermes](https://spiral.ai/integrations/hermes/marketstack-dividend-history)
- [Instinct](https://spiral.ai/integrations/instinct/marketstack-dividend-history)
- [Manus](https://spiral.ai/integrations/manus/marketstack-dividend-history)
- [Muse](https://spiral.ai/integrations/muse/marketstack-dividend-history)
- [Muse Code](https://spiral.ai/integrations/muse-code/marketstack-dividend-history)
- [n8n](https://spiral.ai/integrations/n8n/marketstack-dividend-history)
- [Notion](https://spiral.ai/integrations/notion/marketstack-dividend-history)
- [OpenClaw](https://spiral.ai/integrations/openclaw/marketstack-dividend-history)
- [opencode](https://spiral.ai/integrations/opencode/marketstack-dividend-history)
- [Perplexity](https://spiral.ai/integrations/perplexity/marketstack-dividend-history)
- [Raycast](https://spiral.ai/integrations/raycast/marketstack-dividend-history)
- [VS Code](https://spiral.ai/integrations/vscode/marketstack-dividend-history)
- [Windsurf](https://spiral.ai/integrations/windsurf/marketstack-dividend-history)
- [Zapier](https://spiral.ai/integrations/zapier/marketstack-dividend-history)

## More Gemini guides

- [Marketstack daily stock prices](https://spiral.ai/integrations/gemini/marketstack-daily-stock-prices)
- [Marketstack stock exchange directory](https://spiral.ai/integrations/gemini/marketstack-stock-exchange-directory)
- [Marketstack company profile](https://spiral.ai/integrations/gemini/marketstack-company-profile)
- [Marketstack stock split history](https://spiral.ai/integrations/gemini/marketstack-stock-split-history)
- [Japan MOF sanctions record](https://spiral.ai/integrations/gemini/japan-mof-sanctions-record)
- [Marketstack ticker search](https://spiral.ai/integrations/gemini/marketstack-ticker-search)

## Questions about Marketstack dividend history in Gemini

**Can Gemini use Marketstack dividend history?**

Yes. Add Spiral to Gemini as an MCP server, and Gemini can find and run Marketstack dividend history like any built-in tool.

**How much does Marketstack dividend history cost in Gemini?**

Up to $0.034918 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini plan is separate.

**Do I need an Alexandria account to use Marketstack dividend history in Gemini?**

No. Spiral runs Marketstack dividend history on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Marketstack dividend history in Gemini?**

About two minutes: open Connected Apps, then add Spiral as a custom app, then sign in to Spiral and approve.

**Does Gemini wait while Marketstack dividend history runs?**

Marketstack dividend history runs in the background. Gemini starts the run, checks on it and gives you the json when it's ready.

**Which markets does Marketstack explicitly cover for corporate actions?**

The corporate action documentation lists NASDAQ, NYSE, NYSE ARCA, PINK, SHG, OTCQB, and BATS for dividend and split data. That list defines the documented coverage boundary for these records.

**Where does Marketstack obtain its US market data?**

Marketstack names Tiingo, Inc., based in New York City, as its licensed source for stock market data from United States exchanges.

**Does one response contain a stock's entire corporate action history?**

Marketstack returns paginated results and distinguishes the current page's count from the total available. Retrieve the remaining pages before describing a dividend or split history as complete.

**Does Marketstack stream corporate action updates?**

Marketstack says it offers no WebSocket or streaming APIs. Its data is retrieved through requests rather than a continuous event stream.

**Does Marketstack guarantee that its records are accurate and always available?**

APILayer's published SaaS agreement expressly disclaims responsibility for licensed data's availability, content, and accuracy. It does not provide an unconditional accuracy guarantee for dividend or split records.

