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 7 APIs on the APIs.io network, including Stocks API, Options API, Indices API, and 4 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 authentication, developer portal, documentation, API reference, getting-started guide, signup flow, pricing, and 35 more developer resources.

70.1/100 exemplar ▬ flat Agent 54/100 agent ready Full breakdown ↓
scored 2026-07-21 · rubric v0.4
7 APIs 5 Features
FinanceFintechMarket DataStocksOptionsForexCryptoIndicesFuturesWebSocketsReal-timeHistoricalPublic APIs

API Rating

API Evangelist API Evangelist Rating How this is scored →
scored 2026-07-21 · rubric v0.4
Composite quality — 70.1/100 · exemplar
Contract Quality 17.4 / 25
Developer Ergonomics 14.3 / 20
Commercial Clarity 16.8 / 20
Operational Transparency 6.8 / 13
Governance 7.9 / 12
Discoverability 6.8 / 10
Agent readiness — 54/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 15 / 15
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
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

Polygon Stocks API

Real-time and historical US equity market data including aggregate (OHLC) bars at minute/hour/day granularity, trades, NBBO quotes, snapshots, ticker reference, splits, dividend...

Polygon Options API

OPRA-licensed options market data via REST and WebSocket: aggregates, trades, quotes, snapshots, contract reference, and option chains. Greeks and implied volatility are availab...

Polygon Indices API

Real-time and historical index values for major US and global indices via REST and WebSocket. Includes aggregates, snapshots, and index reference data.

Polygon Forex API

Real-time and historical FX prices for 1,000+ currency pairs via REST and WebSocket. Covers aggregates, quotes, snapshots, conversions, and previous-close.

Polygon Crypto API

Aggregates, trades, snapshots, and level-2 order books for crypto pairs sourced across major exchanges, plus WebSocket streaming on the crypto cluster.

Polygon Reference API

Reference data covering tickers, ticker types, markets, exchanges, market holidays, market status, conditions, stock splits, dividends, and ticker news. Shared across all asset ...

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

Collections

Arazzo Workflows

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

Pricing Plans

Polygon Plans Pricing

12 plans

PLANS

Scroll for all 12

Rate Limits

Polygon Rate Limits

6 limits

RATE LIMITS

Scroll for all 12

FinOps

Features

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.

Use Cases

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

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

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.

Event Specifications

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

Polygon Context

10 classes · 40 properties

JSON-LD

API Governance Rules

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 Structure

Polygon Aggregate Bar Structure

9 properties

JSON STRUCTURE

Polygon Options Contract Structure

9 properties

JSON STRUCTURE

Polygon Ticker Structure

12 properties

JSON STRUCTURE

Example Payloads

Resources

Get Started 4

Portal, sign-up, and the first successful call

Documentation 2

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 15

Pagination, idempotency, versioning, errors, and events

Scroll for all 15

Build 8

SDKs, sample code, and the tooling you integrate with

Scroll for all 8

Access & Security 2

Authentication, authorization, and security posture

Operate 3

Status, limits, changes, and where to get help

Commercial 5

Pricing, plans, and the legal terms of use

Company 2

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
opencollection: 1.0.0
info:
  name: Polygon Stocks REST API
  version: '1.0'
request:
  auth:
    type: apikey
    key: apiKey
    value: '{{apiKey}}'
    placement: query
items:
- info:
    name: Aggregates
    type: folder
  items:
  - info:
      name: Get Aggregate Bars For A Stock Ticker
      type: http
    http:
      method: GET
      url: https://api.polygon.io/v2/aggs/ticker/:stocksTicker/range/:multiplier/:timespan/:from/:to
      params:
      - name: stocksTicker
        value: ''
        type: path
        description: Case-sensitive stock ticker symbol (e.g., AAPL).
      - name: multiplier
        value: ''
        type: path
        description: Size of the timespan multiplier.
      - name: timespan
        value: ''
        type: path
      - name: from
        value: ''
        type: path
        description: Start of the aggregate window (YYYY-MM-DD or millisecond timestamp).
      - name: to
        value: ''
        type: path
        description: End of the aggregate window (YYYY-MM-DD or millisecond timestamp).
      - name: adjusted
        value: ''
        type: query
      - name: sort
        value: ''
        type: query
      - name: limit
        value: ''
        type: query
    docs: 'Returns aggregate bars for a stock over a given date range in

      custom time window sizes (e.g., 5-minute bars between two dates).

      '
- info:
    name: DailyBars
    type: folder
  items:
  - info:
      name: Get Daily Open Close For A Stock Ticker
      type: http
    http:
      method: GET
      url: https://api.polygon.io/v1/open-close/:stocksTicker/:date
      params:
      - name: stocksTicker
        value: ''
        type: path
      - name: date
        value: ''
        type: path
      - name: adjusted
        value: ''
        type: query
    docs: Returns the open, close, high, and low for a stock ticker on a specific date.
  - info:
      name: Get Grouped Daily Bars For US Stocks
      type: http
    http:
      method: GET
      url: https://api.polygon.io/v2/aggs/grouped/locale/us/market/stocks/:date
      params:
      - name: date
        value: ''
        type: path
      - name: adjusted
        value: ''
        type: query
      - name: include_otc
        value: ''
        type: query
    docs: Returns daily aggregate bars for all US stock tickers on a specific date.
  - info:
      name: Get Previous Close For A Stock Ticker
      type: http
    http:
      method: GET
      url: https://api.polygon.io/v2/aggs/ticker/:stocksTicker/prev
      params:
      - name: stocksTicker
        value: ''
        type: path
      - name: adjusted
        value: ''
        type: query
    docs: Returns the previous trading day's open, close, high, and low for a stock ticker.
bundled: true