> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Polygon.io

> Stock market price history, daily open/close, previous close, and ticker reference data from the Polygon.io (Massive) market data API

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: API key.
* **Connection**: The key from `POLYGON_API_KEY` is sent as the `Bearer` prefixed `Authorization` header.
* **Docs**: [https://massive.com/docs/rest/quickstart](https://massive.com/docs/rest/quickstart)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable          | Required | Description                                                                                                                                   |
| ----------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `POLYGON_API_KEY` | Yes      | API key from the Massive (formerly Polygon.io) dashboard, sent as an Authorization: Bearer header [Docs](https://massive.com/dashboard/keys). |

## Setup

1. **Create an account**: Sign up at [https://massive.com](https://massive.com) (Polygon.io is now Massive). The free Basic plan works for testing: it includes end-of-day stock data, 2 years of history, and 5 API calls per minute.
2. **Copy your API key**: Open [https://massive.com/dashboard/keys](https://massive.com/dashboard/keys) and copy the API key shown for your account. Existing Polygon.io keys keep working.
3. **Store the key**: Set the key as POLYGON\_API\_KEY. It is sent as an Authorization: Bearer header on every request.
4. **Verify access**: Call the Get Previous Close tool with a ticker like AAPL. A 401 means the key is invalid; a 429 means you hit the 5 requests/minute limit on the free plan.

* Polygon.io was renamed to Massive in October 2025; api.polygon.io and api.massive.com run in parallel and accept the same keys, so this connector's api.polygon.io endpoints continue to work.
* All five tools are available on the free Basic plan; data recency depends on your plan (end-of-day on Basic, 15-minute delayed on Starter/Developer, real-time on Advanced).
* The free Basic plan is limited to 5 API calls per minute; exceeding it returns HTTP 429.

Provider API reference: [https://massive.com/docs/rest/quickstart](https://massive.com/docs/rest/quickstart)

## Tools

| Tool                 | Access | Description                                                                                                                                            |
| -------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Get Aggregate Bars   | Read   | Get OHLCV aggregate bars (candles) for a stock ticker over a custom date range and time window                                                         |
| Get Previous Close   | Read   | Get the previous trading day's open, high, low, close, and volume for a stock ticker                                                                   |
| Get Daily Open/Close | Read   | Get the open, close, high, low, volume, and pre-market/after-hours prices for a stock ticker on a specific date                                        |
| Search Tickers       | Read   | Search and list ticker symbols across stocks, indices, forex, and crypto reference data                                                                |
| Get Ticker Details   | Read   | Get reference details for a single ticker: company name, market, exchange, market cap, description, and identifiers                                    |
| Get Market Status    | Read   | Get the current trading status of US exchanges and market-wide sessions (open, closed, early hours, after hours) - a cheap check before quoting prices |
| Get Ticker News      | Read   | Get recent news articles for a ticker, including publisher, summary, and per-ticker sentiment insights                                                 |

## Example prompts

* Get daily price bars for a ticker I provide over the last month using Polygon.io and summarize the trend.
* Look up the previous trading day's open, high, low, and close for a ticker I provide.
* Search Polygon.io reference data for a company name I provide and show the matching ticker symbols with their exchanges.
