Polygon website screenshot

Polygon

Polygon (Polygon.io, rebranded as Massive in early 2026) provides real-time and historical market data APIs across US stocks, options, indices, forex, cryptocurrencies, and futures. Coverage is delivered through REST endpoints and WebSocket streams under a single api.polygon.io surface plus an S3 flat files product, with tiered subscription plans for retail developers and Business contracts for redistribution and exchange-licensed data.

Polygon publishes 12 APIs on the APIs.io network, including WebSocket API, Aggregates API, Books API, and 9 more. Tagged areas include Finance, Fintech, Market Data, Stocks, and Options.

The Polygon catalog on APIs.io includes 1 event-driven AsyncAPI specification, 1 JSON-LD context, and 3 Spectral governance rulesets.

Polygon’s developer surface includes changelog, authentication, developer portal, documentation, API reference, getting-started guide, signup flow, and 51 more developer resources.

🌐 Visit website 📡 Source on GitHub
77.0/100 exemplar ▬ flat Agent 59/100 agent native Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
12 APIs 1 MCP Servers 5 Features 5 Use Cases
FinanceFintechMarket DataStocksOptionsForexCryptoIndicesFuturesWebSocketsReal-timeHistoricalPublic APIs

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 77.0/100 · exemplar
Contract Quality 19.5 / 25
Developer Ergonomics 16.4 / 20
Commercial Clarity 16.8 / 20
Operational Transparency 8.9 / 13
Governance 7.6 / 12
Discoverability 9.3 / 10
Agent readiness — 59/100 · agent native
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 9 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 5 / 5
Well-Known Catalog 4 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/polygon: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 12

Individual APIs this provider publishes, each with its own machine-readable definition.

Polygon WebSocket API

Real-time streaming WebSocket clusters per asset class (stocks/options/indices/forex/crypto). Subscribers authenticate with an API key and subscribe to channels for trades, quot...

Polygon Aggregates API

Crypto aggregate bars.

Polygon Books API

Level-2 order book.

Polygon Contracts API

Option contract reference data.

Polygon Conversion API

Real-time currency conversion.

Polygon CorporateActions API

Stock splits and dividends.

Polygon DailyBars API

Daily open/close.

Polygon Markets API

Markets, exchanges, holidays, and status.

Polygon News API

Ticker news.

Polygon Quotes API

FX quote endpoints.

Polygon Snapshots API

Snapshot endpoints.

Polygon Tickers API

Ticker reference and metadata.

Scroll for all 12

Postman Collections 17

Ready-to-run Postman collections for exercising this provider's APIs.

Polygon Crypto REST Aggregates API

POSTMAN

Polygon Crypto REST Aggregates Books API

POSTMAN

Polygon Crypto REST Aggregates Contracts API

POSTMAN

Polygon Crypto REST Aggregates Conversion API

POSTMAN

Polygon Crypto REST Aggregates CorporateActions API

POSTMAN

Polygon Crypto REST API

POSTMAN

Polygon Crypto REST Aggregates DailyBars API

POSTMAN

Polygon Forex REST API

POSTMAN

Polygon Indices REST API

POSTMAN

Polygon Crypto REST Aggregates Markets API

POSTMAN

Polygon Crypto REST Aggregates News API

POSTMAN

Polygon Options REST API

POSTMAN

Polygon Crypto REST Aggregates Quotes API

POSTMAN

Polygon Reference REST API

POSTMAN

Polygon Crypto REST Aggregates Snapshots API

POSTMAN

Polygon Stocks REST API

POSTMAN

Polygon Crypto REST Aggregates Tickers API

POSTMAN

Scroll for all 17

Open Collections 6

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Polygon Crypto REST API

OPEN COLLECTION

Polygon Forex REST API

OPEN COLLECTION

Polygon Indices REST API

OPEN COLLECTION

Polygon Options REST API

OPEN COLLECTION

Polygon Reference REST API

OPEN COLLECTION

Polygon Stocks REST API

OPEN COLLECTION

Arazzo Workflows 12

Multi-step API workflows described with the Arazzo specification.

Polygon Corporate Actions Review

Resolve a ticker, then list its stock splits and dividends history.

ARAZZO

Polygon Crypto Daily Comparison

Check market status, snapshot a crypto pair, and read its daily open/close.

ARAZZO

Polygon Crypto Pair Analysis

Snapshot a crypto pair, pull its aggregate bars, and read its Level-2 order book.

ARAZZO

Polygon Forex Pair Analysis

Read a currency pair's last quote, convert an amount, and pull its aggregate bars.

ARAZZO

Polygon Grouped Market Scan

Check market status, pull grouped daily bars for all US stocks, and profile one symbol.

ARAZZO

Polygon Index Analysis

Snapshot an index, pull its aggregate bars, and read its previous close.

ARAZZO

Polygon Market-Gated Stock Daily Snapshot

Check current US market status, then pull a stock's daily open/close and previous close.

ARAZZO

Polygon Options Chain Scan

Resolve an underlying's details, scan its options chain, and read its previous close.

ARAZZO

Polygon Options Contract Deep Dive

List an underlying's option contracts, snapshot the top contract, and pull its bars.

ARAZZO

Polygon Stock Research

Resolve a stock ticker's reference details, pull its aggregate bars, and read its previous close.

ARAZZO

Polygon Ticker Discovery and Profile

Search active stock tickers, resolve the top match's details, and pull its recent bars.

ARAZZO

Polygon Ticker News Context

Resolve a ticker's details, pull recent news, and read its previous close.

ARAZZO

Scroll for all 12

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Massive MCP server — remote https://mcp.massive.com (OAuth) + open-source mcp_massive (stdio)

MCP SERVER

Pricing Plans 1

Published pricing tiers and plan structures.

Polygon Plans Pricing

12 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Polygon Rate Limits

6 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Polygon Finops

FINOPS

Features 5

Notable capabilities this provider offers.

Multi-asset market data

Unified REST and WebSocket surface for stocks, options, indices, forex, crypto, and futures.

Real-time and historical

Sub-second live feeds plus 20+ years of historical aggregates depending on tier.

WebSocket clusters per asset class

Dedicated streaming clusters for stocks, options, indices, forex, and crypto subscriptions.

Flat files

S3-style daily aggregate, trade, and quote files for bulk historical loads on paid tiers.

Tiered subscriptions

Basic / Starter / Developer / Advanced / Business plans per asset class with distinct rate limits.

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Polygon WebSocket Streaming API

Polygon real-time market data WebSocket clusters. Each asset class (stocks, options, indices, forex, crypto) has its own dedicated cluster at `wss://socket.polygon.io/{cluster}`...

ASYNCAPI

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Polygon Context

10 classes · 40 properties

JSON-LD

Spectral Rules 3

Spectral governance rulesets for linting and validating these APIs.

Polygon API Rules

5 rules · 1 errors 4 warnings

SPECTRAL

Polygon API Rules

5 rules · 4 warnings 1 info

SPECTRAL

Polygon API Rules

21 rules · 4 errors 13 warnings 4 info

SPECTRAL

JSON Schema 5

Standalone JSON Schema definitions for this provider's data models.

Polygon Aggregate Bar

9 properties

JSON SCHEMA

Polygon Options Contract

9 properties

JSON SCHEMA

Polygon NBBO Quote Tick

9 properties

JSON SCHEMA

Polygon Ticker

12 properties

JSON SCHEMA

Polygon Trade Tick

8 properties

JSON SCHEMA

JSON Structure 3

JSON Structure definitions describing this provider's data shapes.

Polygon Aggregate Bar Structure

9 properties

JSON STRUCTURE

Polygon Options Contract Structure

9 properties

JSON STRUCTURE

Polygon Ticker Structure

12 properties

JSON STRUCTURE

Examples 5

Example request and response payloads for these APIs.

Polygon Forex Conversion Example

2 fields

EXAMPLE

Polygon Options Chain Snapshot Example

2 fields

EXAMPLE

Polygon Reference Tickers Example

2 fields

EXAMPLE

Polygon Stocks Aggregate Bars Example

2 fields

EXAMPLE

Polygon Websocket Subscribe Example

3 fields

EXAMPLE

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Polygon Authentication

apiKey/http · 2 schemes

SECURITY

Polygon Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Polygon Scopes

6 scopes · authorizationCode/clientCredentials

6 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Polygon Agentic Access

175 operations

175 operations · 0 acting

AGENTIC

Use Cases 5

What developers build with this provider.

Trading platform price feeds

Power retail and institutional trading UIs with consolidated real-time quotes and bars.

Backtesting and research

Pull decades of aggregated bars and tick data for systematic strategy research.

Risk and surveillance

Stream live trades and quotes into compliance, surveillance, and risk engines.

Analytics dashboards

Build market dashboards, terminals, and embedded charts across asset classes.

Quant pipelines

Drive options Greeks, volatility surfaces, and FX hedging models with reliable feeds.

Integrations 4

Pre-built integrations with other platforms and tools.

TradingView

Polygon data feeds integrate with charting libraries used by trading apps.

Pandas and DataFrames

Python SDK returns DataFrames for direct use in research notebooks.

Snowflake and Databricks

Flat files load into modern data warehouses for SQL-based market analytics.

Kafka and streaming platforms

WebSocket feeds bridge into Kafka, Redpanda, and Kinesis for downstream processing.

Solutions 3

Packaged solutions this provider offers.

Retail brokerages and fintech apps

Tiered plans for consumer-facing investing apps and personal-finance tools.

Quant funds and prop trading

Business contracts for redistribution and full SIP / OPRA / CME exchange-licensed data.

Data and AI research

Flat files and historical APIs for ML feature engineering and financial NLP.

Resources

Get Started 4

Portal, sign-up, and the first successful call

Portal
Portal
 GettingStarted
GettingStarted
 Signup
Signup
 Login
Login

Documentation 3

Reference material describing how the API behaves

OpenAPI
OpenAPI
 Documentation
Documentation
 APIReference
APIReference

Agent Surfaces 5

MCP servers, agent skills, and machine-readable catalogs

MCPServer
MCPServer
 LLMsTxt
LLMsTxt
 WellKnown
WellKnown
 AgentSkill
AgentSkill
 AgenticAccess
AgenticAccess

Design & Contract 21

Pagination, idempotency, versioning, errors, and events

Conformance
Conformance
 ErrorCatalog
ErrorCatalog
 Lifecycle
Lifecycle
 Conventions
Conventions
 Idempotency
Idempotency
 DataModel
DataModel
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 Arazzo
Arazzo
 SpectralRules
SpectralRules
 Vocabulary
Vocabulary
 JSONLD
JSONLD

Scroll for all 21

Build 10

SDKs, sample code, and the tooling you integrate with

ToolCrosswalk
ToolCrosswalk
 Packages
Packages
 PostmanWorkspace
PostmanWorkspace
 GitHubOrganization
GitHubOrganization
 Official Polygon (Massive) MCP Server
Tools
 Official PHP SDK
SDKs
 Python SDK
SDKs
 JavaScript / TypeScript SDK
SDKs
 Kotlin / JVM SDK
SDKs
 Go SDK
SDKs

Scroll for all 10

Access & Security 3

Authentication, authorization, and security posture

OAuthScopes
OAuthScopes
 DomainSecurity
DomainSecurity
 Authentication
Authentication

Operate 4

Status, limits, changes, and where to get help

ChangeLog
ChangeLog
 StatusPage
StatusPage
 Support
Support
 RateLimits
RateLimits

Commercial 5

Pricing, plans, and the legal terms of use

Pricing
Pricing
 TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy
 Plans
Plans
 FinOps
FinOps

Company 2

The organization behind the API

Blog
Blog
 LinkedIn
LinkedIn

Other 1

Properties that don't map to a standard resource type

Overlay
Overlay

Source (apis.yml)

apis.yml Raw ↑ 
aid: polygon
name: Polygon
url: https://raw.githubusercontent.com/api-evangelist/polygon/refs/heads/main/apis.yml
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/polygon.png
description: Polygon (Polygon.io, rebranded as Massive in early 2026) provides real-time and historical market data APIs across
  US stocks, options, indices, forex, cryptocurrencies, and futures. Coverage is delivered through REST endpoints and WebSocket
  streams under a single api.polygon.io surface plus an S3 flat files product, with tiered subscription plans for retail developers
  and Business contracts for redistribution and exchange-licensed data.
specificationVersion: '0.20'
created: '2026-05-28'
modified: '2026-07-22'
x-source: public-apis/public-apis
x-category: Finance
x-type: company
x-tier: 2
x-tier-reason: pipeline-enriched
tags:
- Finance
- Fintech
- Market Data
- Stocks
- Options
- Forex
- Crypto
- Indices
- Futures
- WebSockets
- Real-time
- Historical
- Public APIs
apis:
- aid: polygon:websocket-api
  name: Polygon WebSocket API
  description: Real-time streaming WebSocket clusters per asset class (stocks/options/indices/forex/crypto). Subscribers authenticate
    with an API key and subscribe to channels for trades, quotes, aggregates, and book updates.
  humanURL: https://polygon.io/docs/stocks/ws_getting-started
  baseURL: wss://socket.polygon.io
  tags:
  - WebSocket
  - Streaming
  - Real-time
  properties:
  - type: Documentation
    url: https://polygon.io/docs/stocks/ws_getting-started
  - type: AsyncAPI
    url: asyncapi/polygon-websocket-asyncapi.yml
  - type: JSONSchema
    url: json-schema/polygon-trade-schema.json
  - type: JSONSchema
    url: json-schema/polygon-quote-schema.json
  - type: Examples
    url: examples/polygon-websocket-subscribe-example.json
- aid: polygon:polygon-aggregates-api
  name: Polygon Aggregates API
  description: Crypto aggregate bars.
  humanURL: https://polygon.io/docs/stocks
  baseURL: https://api.polygon.io
  tags:
  - Aggregates
  properties:
  - type: OpenAPI
    url: openapi/polygon-aggregates-api-openapi.yml
  - type: Documentation
    url: https://polygon.io/docs/stocks
  - type: APIReference
    url: https://polygon.io/docs/stocks
  - type: Authentication
    url: https://polygon.io/docs/getting-started
  - type: JSONSchema
    url: json-schema/polygon-aggregate-bar-schema.json
  - type: JSONStructure
    url: json-structure/polygon-aggregate-bar-structure.json
  - type: Examples
    url: examples/polygon-stocks-aggregate-bars-example.json
  - type: Documentation
    url: https://polygon.io/docs/options
  - type: APIReference
    url: https://polygon.io/docs/options
  - type: JSONSchema
    url: json-schema/polygon-options-contract-schema.json
  - type: JSONStructure
    url: json-structure/polygon-options-contract-structure.json
  - type: Examples
    url: examples/polygon-options-chain-snapshot-example.json
  - type: Documentation
    url: https://polygon.io/docs/indices
  - type: APIReference
    url: https://polygon.io/docs/indices
  - type: Documentation
    url: https://polygon.io/docs/forex
  - type: APIReference
    url: https://polygon.io/docs/forex
  - type: Examples
    url: examples/polygon-forex-conversion-example.json
  - type: Documentation
    url: https://polygon.io/docs/crypto
  - type: APIReference
    url: https://polygon.io/docs/crypto
  - type: Documentation
    url: https://polygon.io/docs/stocks/get_v3_reference_tickers
  - type: JSONSchema
    url: json-schema/polygon-ticker-schema.json
  - type: JSONStructure
    url: json-structure/polygon-ticker-structure.json
  - type: Examples
    url: examples/polygon-reference-tickers-example.json
- aid: polygon:polygon-books-api
  name: Polygon Books API
  description: Level-2 order book.
  humanURL: https://polygon.io/docs/stocks
  baseURL: https://api.polygon.io
  tags:
  - Books
  properties:
  - type: OpenAPI
    url: openapi/polygon-books-api-openapi.yml
  - type: Documentation
    url: https://polygon.io/docs/stocks
  - type: APIReference
    url: https://polygon.io/docs/stocks
  - type: Authentication
    url: https://polygon.io/docs/getting-started
  - type: JSONSchema
    url: json-schema/polygon-aggregate-bar-schema.json
  - type: JSONStructure
    url: json-structure/polygon-aggregate-bar-structure.json
  - type: Examples
    url: examples/polygon-stocks-aggregate-bars-example.json
  - type: Documentation
    url: https://polygon.io/docs/options
  - type: APIReference
    url: https://polygon.io/docs/options
  - type: JSONSchema
    url: json-schema/polygon-options-contract-schema.json
  - type: JSONStructure
    url: json-structure/polygon-options-contract-structure.json
  - type: Examples
    url: examples/polygon-options-chain-snapshot-example.json
  - type: Documentation
    url: https://polygon.io/docs/indices
  - type: APIReference
    url: https://polygon.io/docs/indices
  - type: Documentation
    url: https://polygon.io/docs/forex
  - type: APIReference
    url: https://polygon.io/docs/forex
  - type: Examples
    url: examples/polygon-forex-conversion-example.json
  - type: Documentation
    url: https://polygon.io/docs/crypto
  - type: APIReference
    url: https://polygon.io/docs/crypto
  - type: Documentation
    url: https://polygon.io/docs/stocks/get_v3_reference_tickers
  - type: JSONSchema
    url: json-schema/polygon-ticker-schema.json
  - type: JSONStructure
    url: json-structure/polygon-ticker-structure.json
  - type: Examples
    url: examples/polygon-reference-tickers-example.json
- aid: polygon:polygon-contracts-api
  name: Polygon Contracts API
  description: Option contract reference data.
  humanURL: https://polygon.io/docs/stocks
  baseURL: https://api.polygon.io
  tags:
  - Contracts
  properties:
  - type: OpenAPI
    url: openapi/polygon-contracts-api-openapi.yml
  - type: Documentation
    url: https://polygon.io/docs/stocks
  - type: APIReference
    url: https://polygon.io/docs/stocks
  - type: Authentication
    url: https://polygon.io/docs/getting-started
  - type: JSONSchema
    url: json-schema/polygon-aggregate-bar-schema.json
  - type: JSONStructure
    url: json-structure/polygon-aggregate-bar-structure.json
  - type: Examples
    url: examples/polygon-stocks-aggregate-bars-example.json
  - type: Documentation
    url: https://polygon.io/docs/options
  - type: APIReference
    url: https://polygon.io/docs/options
  - type: JSONSchema
    url: json-schema/polygon-options-contract-schema.json
  - type: JSONStructure
    url: json-structure/polygon-options-contract-structure.json
  - type: Examples
    url: examples/polygon-options-chain-snapshot-example.json
  - type: Documentation
    url: https://polygon.io/docs/indices
  - type: APIReference
    url: https://polygon.io/docs/indices
  - type: Documentation
    url: https://polygon.io/docs/forex
  - type: APIReference
    url: https://polygon.io/docs/forex
  - type: Examples
    url: examples/polygon-forex-conversion-example.json
  - type: Documentation
    url: https://polygon.io/docs/crypto
  - type: APIReference
    url: https://polygon.io/docs/crypto
  - type: Documentation
    url: https://polygon.io/docs/stocks/get_v3_reference_tickers
  - type: JSONSchema
    url: json-schema/polygon-ticker-schema.json
  - type: JSONStructure
    url: json-structure/polygon-ticker-structure.json
  - type: Examples
    url: examples/polygon-reference-tickers-example.json
- aid: polygon:polygon-conversion-api
  name: Polygon Conversion API
  description: Real-time currency conversion.
  humanURL: https://polygon.io/docs/stocks
  baseURL: https://api.polygon.io
  tags:
  - Conversion
  properties:
  - type: OpenAPI
    url: openapi/polygon-conversion-api-openapi.yml
  - type: Documentation
    url: https://polygon.io/docs/stocks
  - type: APIReference
    url: https://polygon.io/docs/stocks
  - type: Authentication
    url: https://polygon.io/docs/getting-started
  - type: JSONSchema
    url: json-schema/polygon-aggregate-bar-schema.json
  - type: JSONStructure
    url: json-structure/polygon-aggregate-bar-structure.json
  - type: Examples
    url: examples/polygon-stocks-aggregate-bars-example.json
  - type: Documentation
    url: https://polygon.io/docs/options
  - type: APIReference
    url: https://polygon.io/docs/options
  - type: JSONSchema
    url: json-schema/polygon-options-contract-schema.json
  - type: JSONStructure
    url: json-structure/polygon-options-contract-structure.json
  - type: Examples
    url: examples/polygon-options-chain-snapshot-example.json
  - type: Documentation
    url: https://polygon.io/docs/indices
  - type: APIReference
    url: https://polygon.io/docs/indices
  - type: Documentation
    url: https://polygon.io/docs/forex
  - type: APIReference
    url: https://polygon.io/docs/forex
  - type: Examples
    url: examples/polygon-forex-conversion-example.json
  - type: Documentation
    url: https://polygon.io/docs/crypto
  - type: APIReference
    url: https://polygon.io/docs/crypto
  - type: Documentation
    url: https://polygon.io/docs/stocks/get_v3_reference_tickers
  - type: JSONSchema
    url: json-schema/polygon-ticker-schema.json
  - type: JSONStructure
    url: json-structure/polygon-ticker-structure.json
  - type: Examples
    url: examples/polygon-reference-tickers-example.json
- aid: polygon:polygon-corporateactions-api
  name: Polygon CorporateActions API
  description: Stock splits and dividends.
  humanURL: https://polygon.io/docs/stocks
  baseURL: https://api.polygon.io
  tags:
  - CorporateActions
  properties:
  - type: OpenAPI
    url: openapi/polygon-corporateactions-api-openapi.yml
  - type: Documentation
    url: https://polygon.io/docs/stocks
  - type: APIReference
    url: https://polygon.io/docs/stocks
  - type: Authentication
    url: https://polygon.io/docs/getting-started
  - type: JSONSchema
    url: json-schema/polygon-aggregate-bar-schema.json
  - type: JSONStructure
    url: json-structure/polygon-aggregate-bar-structure.json
  - type: Examples
    url: examples/polygon-stocks-aggregate-bars-example.json
  - type: Documentation
    url: https://polygon.io/docs/options
  - type: APIReference
    url: https://polygon.io/docs/options
  - type: JSONSchema
    url: json-schema/polygon-options-contract-schema.json
  - type: JSONStructure
    url: json-structure/polygon-options-contract-structure.json
  - type: Examples
    url: examples/polygon-options-chain-snapshot-example.json
  - type: Documentation
    url: https://polygon.io/docs/indices
  - type: APIReference
    url: https://polygon.io/docs/indices
  - type: Documentation
    url: https://polygon.io/docs/forex
  - type: APIReference
    url: https://polygon.io/docs/forex
  - type: Examples
    url: examples/polygon-forex-conversion-example.json
  - type: Documentation
    url: https://polygon.io/docs/crypto
  - type: APIReference
    url: https://polygon.io/docs/crypto
  - type: Documentation
    url: https://polygon.io/docs/stocks/get_v3_reference_tickers
  - type: JSONSchema
    url: json-schema/polygon-ticker-schema.json
  - type: JSONStructure
    url: json-structure/polygon-ticker-structure.json
  - type: Examples
    url: examples/polygon-reference-tickers-example.json
- aid: polygon:polygon-dailybars-api
  name: Polygon DailyBars API
  description: Daily open/close.
  humanURL: https://polygon.io/docs/stocks
  baseURL: https://api.polygon.io
  tags:
  - DailyBars
  properties:
  - type: OpenAPI
    url: openapi/polygon-dailybars-api-openapi.yml
  - type: Documentation
    url: https://polygon.io/docs/stocks
  - type: APIReference
    url: https://polygon.io/docs/stocks
  - type: Authentication
    url: https://polygon.io/docs/getting-started
  - type: JSONSchema
    url: json-schema/polygon-aggregate-bar-schema.json
  - type: JSONStructure
    url: json-structure/polygon-aggregate-bar-structure.json
  - type: Examples
    url: examples/polygon-stocks-aggregate-bars-example.json
  - type: Documentation
    url: https://polygon.io/docs/options
  - type: APIReference
    url: https://polygon.io/docs/options
  - type: JSONSchema
    url: json-schema/polygon-options-contract-schema.json
  - type: JSONStructure
    url: json-structure/polygon-options-contract-structure.json
  - type: Examples
    url: examples/polygon-options-chain-snapshot-example.json
  - type: Documentation
    url: https://polygon.io/docs/indices
  - type: APIReference
    url: https://polygon.io/docs/indices
  - type: Documentation
    url: https://polygon.io/docs/forex
  - type: APIReference
    url: https://polygon.io/docs/forex
  - type: Examples
    url: examples/polygon-forex-conversion-example.json
  - type: Documentation
    url: https://polygon.io/docs/crypto
  - type: APIReference
    url: https://polygon.io/docs/crypto
  - type: Documentation
    url: https://polygon.io/docs/stocks/get_v3_reference_tickers
  - type: JSONSchema
    url: json-schema/polygon-ticker-schema.json
  - type: JSONStructure
    url: json-structure/polygon-ticker-structure.json
  - type: Examples
    url: examples/polygon-reference-tickers-example.json
- aid: polygon:polygon-markets-api
  name: Polygon Markets API
  description: Markets, exchanges, holidays, and status.
  humanURL: https://polygon.io/docs/stocks
  baseURL: https://api.polygon.io
  tags:
  - Markets
  properties:
  - type: OpenAPI
    url: openapi/polygon-markets-api-openapi.yml
  - type: Documentation
    url: https://polygon.io/docs/stocks
  - type: APIReference
    url: https://polygon.io/docs/stocks
  - type: Authentication
    url: https://polygon.io/docs/getting-started
  - type: JSONSchema
    url: json-schema/polygon-aggregate-bar-schema.json
  - type: JSONStructure
    url: json-structure/polygon-aggregate-bar-structure.json
  - type: Examples
    url: examples/polygon-stocks-aggregate-bars-example.json
  - type: Documentation
    url: https://polygon.io/docs/options
  - type: APIReference
    url: https://polygon.io/docs/options
  - type: JSONSchema
    url: json-schema/polygon-options-contract-schema.json
  - type: JSONStructure
    url: json-structure/polygon-options-contract-structure.json
  - type: Examples
    url: examples/polygon-options-chain-snapshot-example.json
  - type: Documentation
    url: https://polygon.io/docs/indices
  - type: APIReference
    url: https://polygon.io/docs/indices
  - type: Documentation
    url: https://polygon.io/docs/forex
  - type: APIReference
    url: https://polygon.io/docs/forex
  - type: Examples
    url: examples/polygon-forex-conversion-example.json
  - type: Documentation
    url: https://polygon.io/docs/crypto
  - type: APIReference
    url: https://polygon.io/docs/crypto
  - type: Documentation
    url: https://polygon.io/docs/stocks/get_v3_reference_tickers
  - type: JSONSchema
    url: json-schema/polygon-ticker-schema.json
  - type: JSONStructure
    url: json-structure/polygon-ticker-structure.json
  - type: Examples
    url: examples/polygon-reference-tickers-example.json
- aid: polygon:polygon-news-api
  name: Polygon News API
  description: Ticker news.
  humanURL: https://polygon.io/docs/stocks
  baseURL: https://api.polygon.io
  tags:
  - News
  properties:
  - type: OpenAPI
    url: openapi/polygon-news-api-openapi.yml
  - type: Documentation
    url: https://polygon.io/docs/stocks
  - type: APIReference
    url: https://polygon.io/docs/stocks
  - type: Authentication
    url: https://polygon.io/docs/getting-started
  - type: JSONSchema
    url: json-schema/polygon-aggregate-bar-schema.json
  - type: JSONStructure
    url: json-structure/polygon-aggregate-bar-structure.json
  - type: Examples
    url: examples/polygon-stocks-aggregate-bars-example.json
  - type: Documentation
    url: https://polygon.io/docs/options
  - type: APIReference
    url: https://polygon.io/docs/options
  - type: JSONSchema
    url: json-schema/polygon-options-contract-schema.json
  - type: JSONStructure
    url: json-structure/polygon-options-contract-structure.json
  - type: Examples
    url: examples/polygon-options-chain-snapshot-example.json
  - type: Documentation
    url: https://polygon.io/docs/indices
  - type: APIReference
    url: https://polygon.io/docs/indices
  - type: Documentation
    url: https://polygon.io/docs/forex
  - type: APIReference
    url: https://polygon.io/docs/forex
  - type: Examples
    url: examples/polygon-forex-conversion-example.json
  - type: Documentation
    url: https://polygon.io/docs/crypto
  - type: APIReference
    url: https://polygon.io/docs/crypto
  - type: Documentation
    url: https://polygon.io/docs/stocks/get_v3_reference_tickers
  - type: JSONSchema
    url: json-schema/polygon-ticker-schema.json
  - type: JSONStructure
    url: json-structure/polygon-ticker-structure.json
  - type: Examples
    url: examples/polygon-reference-tickers-example.json
- aid: polygon:polygon-quotes-api
  name: Polygon Quotes API
  description: FX quote endpoints.
  humanURL: https://polygon.io/docs/stocks
  baseURL: https://api.polygon.io
  tags:
  - Quotes
  properties:
  - type: OpenAPI
    url: openapi/polygon-quotes-api-openapi.yml
  - type: Documentation
    url: https://polygon.io/docs/stocks
  - type: APIReference
    url: https://polygon.io/docs/stocks
  - type: Authentication
    url: https://polygon.io/docs/getting-started
  - type: JSONSchema
    url: json-schema/polygon-aggregate-bar-schema.json
  - type: JSONStructure
    url: json-structure/polygon-aggregate-bar-structure.json
  - type: Examples
    url: examples/polygon-stocks-aggregate-bars-example.json
  - type: Documentation
    url: https://polygon.io/docs/options
  - type: APIReference
    url: https://polygon.io/docs/options
  - type: JSONSchema
    url: json-schema/polygon-options-contract-schema.json
  - type: JSONStructure
    url: json-structure/polygon-options-contract-structure.json
  - type: Examples
    url: examples/polygon-options-chain-snapshot-example.json
  - type: Documentation
    url: https://polygon.io/docs/indices
  - type: APIReference
    url: https://polygon.io/docs/indices
  - type: Documentation
    url: https://polygon.io/docs/forex
  - type: APIReference
    url: https://polygon.io/docs/forex
  - type: Examples
    url: examples/polygon-forex-conversion-example.json
  - type: Documentation
    url: https://polygon.io/docs/crypto
  - type: APIReference
    url: https://polygon.io/docs/crypto
  - type: Documentation
    url: https://polygon.io/docs/stocks/get_v3_reference_tickers
  - type: JSONSchema
    url: json-schema/polygon-ticker-schema.json
  - type: JSONStructure
    url: json-structure/polygon-ticker-structure.json
  - type: Examples
    url: examples/polygon-reference-tickers-example.json
- aid: polygon:polygon-snapshots-api
  name: Polygon Snapshots API
  description: Snapshot endpoints.
  humanURL: https://polygon.io/docs/stocks
  baseURL: https://api.polygon.io
  tags:
  - Snapshots
  properties:
  - type: OpenAPI
    url: openapi/polygon-snapshots-api-openapi.yml
  - type: Documentation
    url: https://polygon.io/docs/stocks
  - type: APIReference
    url: https://polygon.io/docs/stocks
  - type: Authentication
    url: https://polygon.io/docs/getting-started
  - type: JSONSchema
    url: json-schema/polygon-aggregate-bar-schema.json
  - type: JSONStructure
    url: json-structure/polygon-aggregate-bar-structure.json
  - type: Examples
    url: examples/polygon-stocks-aggregate-bars-example.json
  - type: Documentation
    url: https://polygon.io/docs/options
  - type: APIReference
    url: https://polygon.io/docs/options
  - type: JSONSchema
    url: json-schema/polygon-options-contract-schema.json
  - type: JSONStructure
    url: json-structure/polygon-options-contract-structure.json
  - type: Examples
    url: examples/polygon-options-chain-snapshot-example.json
  - type: Documentation
    url: https://polygon.io/docs/indices
  - type: APIReference
    url: https://polygon.io/docs/indices
  - type: Documentation
    url: https://polygon.io/docs/forex
  - type: APIReference
    url: https://polygon.io/docs/forex
  - type: Examples
    url: examples/polygon-forex-conversion-example.json
  - type: Documentation
    url: https://polygon.io/docs/crypto
  - type: APIReference
    url: https://polygon.io/docs/crypto
  - type: Documentation
    url: https://polygon.io/docs/stocks/get_v3_reference_tickers
  - type: JSONSchema
    url: json-schema/polygon-ticker-schema.json
  - type: JSONStructure
    url: json-structure/polygon-ticker-structure.json
  - type: Examples
    url: examples/polygon-reference-tickers-example.json
- aid: polygon:polygon-tickers-api
  name: Polygon Tickers API
  description: Ticker reference and metadata.
  humanURL: https://polygon.io/docs/stocks
  baseURL: https://api.polygon.io
  tags:
  - Tickers
  properties:
  - type: OpenAPI
    url: openapi/polygon-tickers-api-openapi.yml
  - type: Documentation
    url: https://polygon.io/docs/stocks
  - type: APIReference
    url: https://polygon.io/docs/stocks
  - type: Authentication
    url: https://polygon.io/docs/getting-started
  - type: JSONSchema
    url: json-schema/polygon-aggregate-bar-schema.json
  - type: JSONStructure
    url: json-structure/polygon-aggregate-bar-structure.json
  - type: Examples
    url: examples/polygon-stocks-aggregate-bars-example.json
  - type: Documentation
    url: https://polygon.io/docs/options
  - type: APIReference
    url: https://polygon.io/docs/options
  - type: JSONSchema
    url: json-schema/polygon-options-contract-schema.json
  - type: JSONStructure
    url: json-structure/polygon-options-contract-structure.json
  - type: Examples
    url: examples/polygon-options-chain-snapshot-example.json
  - type: Documentation
    url: https://polygon.io/docs/indices
  - type: APIReference
    url: https://polygon.io/docs/indices
  - type: Documentation
    url: https://polygon.io/docs/forex
  - type: APIReference
    url: https://polygon.io/docs/forex
  - type: Examples
    url: examples/polygon-forex-conversion-example.json
  - type: Documentation
    url: https://polygon.io/docs/crypto
  - type: APIReference
    url: https://polygon.io/docs/crypto
  - type: Documentation
    url: https://polygon.io/docs/stocks/get_v3_reference_tickers
  - type: JSONSchema
    url: json-schema/polygon-ticker-schema.json
  - type: JSONStructure
    url: json-structure/polygon-ticker-structure.json
  - type: Examples
    url: examples/polygon-reference-tickers-example.json
common:
- type: OpenAPI
  url: openapi/polygon-openapi-original.json
  name: Official Massive (Polygon.io) OpenAPI 3.0.3 — 146 operations, harvested from https://api.polygon.io/openapi
- type: Overlay
  url: overlays/polygon-openapi-overlay.yaml
- type: MCPServer
  url: mcp/polygon-mcp.yml
  name: Massive MCP server — remote https://mcp.massive.com (OAuth) + open-source mcp_massive (stdio)
- type: ToolCrosswalk
  url: mcp/polygon-tool-crosswalk.yml
- type: LLMsTxt
  url: llms/polygon-llms.txt
- type: WellKnown
  url: well-known/polygon-well-known.yml
- type: Packages
  url: packages/polygon-packages.yml
- type: Conformance
  url: conformance/polygon-conformance.yml
- type: ErrorCatalog
  url: errors/polygon-problem-types.yml
- type: Lifecycle
  url: lifecycle/polygon-lifecycle.yml
- type: ChangeLog
  url: changelog/polygon-changelog.yml
- type: Conventions
  url: conventions/polygon-conventions.yml
- type: Idempotency
  url: conventions/polygon-conventions.yml
- type: DataModel
  url: data-model/polygon-data-model.yml
- type: OAuthScopes
  url: scopes/polygon-scopes.yml
- type: AgentSkill
  url: skills/_index.yml
- type: AgenticAccess
  url: agentic-access/polygon-agentic-access.yml
- type: DomainSecurity
  url: security/polygon-domain-security.yml
- type: Authentication
  url: authentication/polygon-authentication.yml
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/polygon/overview
- type: Arazzo
  url: arazzo/polygon-corporate-actions-workflow.yml
  name: Polygon Corporate Actions Review
- type: Arazzo
  url: arazzo/polygon-crypto-daily-comparison-workflow.yml
  name: Polygon Crypto Daily Comparison
- type: Arazzo
  url: arazzo/polygon-crypto-pair-analysis-workflow.yml
  name: Polygon Crypto Pair Analysis
- type: Arazzo
  url: arazzo/polygon-forex-pair-analysis-workflow.yml
  name: Polygon Forex Pair Analysis
- type: Arazzo
  url: arazzo/polygon-grouped-market-scan-workflow.yml
  name: Polygon Grouped Market Scan
- type: Arazzo
  url: arazzo/polygon-index-analysis-workflow.yml
  name: Polygon Index Analysis
- type: Arazzo
  url: arazzo/polygon-market-gated-stock-daily-workflow.yml
  name: Polygon Market-Gated Stock Daily Snapshot
- type: Arazzo
  url: arazzo/polygon-options-chain-scan-workflow.yml
  name: Polygon Options Chain Scan
- type: Arazzo
  url: arazzo/polygon-options-contract-deep-dive-workflow.yml
  name: Polygon Options Contract Deep Dive
- type: Arazzo
  url: arazzo/polygon-stock-research-workflow.yml
  name: Polygon Stock Research
- type: Arazzo
  url: arazzo/polygon-ticker-discovery-workflow.yml
  name: Polygon Ticker Discovery and Profile
- type: Arazzo
  url: arazzo/polygon-ticker-news-context-workflow.yml
  name: Polygon Ticker News Context
- type: Portal
  url: https://polygon.io/
- type: Documentation
  url: https://polygon.io/docs
- type: APIReference
  url: https://polygon.io/docs
- type: GettingStarted
  url: https://polygon.io/docs/getting-started
- type: Signup
  url: https://polygon.io/dashboard/signup
- type: Login
  url: https://polygon.io/dashboard/login
- type: Pricing
  url: https://polygon.io/pricing
- type: StatusPage
  url: https://status.polygon.io/
- type: Blog
  url: https://polygon.io/blog
- type: Support
  url: https://polygon.io/contact
- type: TermsOfService
  url: https://polygon.io/terms
- type: PrivacyPolicy
  url: https://polygon.io/privacy
- type: GitHubOrganization
  url: https://github.com/polygon-io
- type: Tools
  url: https://github.com/polygon-io/mcp_polygon
  title: Official Polygon (Massive) MCP Server
- type: SDKs
  url: https://github.com/polygon-io/client-php
  title: Official PHP SDK
- type: SDKs
  url: https://pypi.org/project/polygon-api-client/
  title: Python SDK
- type: SDKs
  url: https://www.npmjs.com/package/@polygon.io/client-js
  title: JavaScript / TypeScript SDK
- type: SDKs
  url: https://central.sonatype.com/artifact/io.polygon.kotlin.sdk/polygon-kotlin-sdk-jvm
  title: Kotlin / JVM SDK
- type: SDKs
  url: https://pkg.go.dev/github.com/polygon-io/client-go
  title: Go SDK
- type: LinkedIn
  url: https://www.linkedin.com/company/polygon-io
- type: Plans
  url: plans/polygon-plans-pricing.yml
- type: RateLimits
  url: rate-limits/polygon-rate-limits.yml
- type: FinOps
  url: finops/polygon-finops.yml
- type: SpectralRules
  url: rules/polygon-rules.yml
- type: Vocabulary
  url: vocabulary/polygon-vocabulary.yml
- type: JSONLD
  url: json-ld/polygon-context.jsonld
- type: Features
  data:
  - name: Multi-asset market data
    description: Unified REST and WebSocket surface for stocks, options, indices, forex, crypto, and futures.
  - name: Real-time and historical
    description: Sub-second live feeds plus 20+ years of historical aggregates depending on tier.
  - name: WebSocket clusters per asset class
    description: Dedicated streaming clusters for stocks, options, indices, forex, and crypto subscriptions.
  - name: Flat files
    description: S3-style daily aggregate, trade, and quote files for bulk historical loads on paid tiers.
  - name: Tiered subscriptions
    description: Basic / Starter / Developer / Advanced / Business plans per asset class with distinct rate limits.
- type: UseCases
  data:
  - name: Trading platform price feeds
    description: Power retail and institutional trading UIs with consolidated real-time quotes and bars.
  - name: Backtesting and research
    description: Pull decades of aggregated bars and tick data for systematic strategy research.
  - name: Risk and surveillance
    description: Stream live trades and quotes into compliance, surveillance, and risk engines.
  - name: Analytics dashboards
    description: Build market dashboards, terminals, and embedded charts across asset classes.
  - name: Quant pipelines
    description: Drive options Greeks, volatility surfaces, and FX hedging models with reliable feeds.
- type: Integrations
  data:
  - name: TradingView
    description: Polygon data feeds integrate with charting libraries used by trading apps.
  - name: Pandas and DataFrames
    description: Python SDK returns DataFrames for direct use in research notebooks.
  - name: Snowflake and Databricks
    description: Flat files load into modern data warehouses for SQL-based market analytics.
  - name: Kafka and streaming platforms
    description: WebSocket feeds bridge into Kafka, Redpanda, and Kinesis for downstream processing.
- type: Solutions
  data:
  - name: Retail brokerages and fintech apps
    description: Tiered plans for consumer-facing investing apps and personal-finance tools.
  - name: Quant funds and prop trading
    description: Business contracts for redistribution and full SIP / OPRA / CME exchange-licensed data.
  - name: Data and AI research
    description: Flat files and historical APIs for ML feature engineering and financial NLP.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com