Polygon

aid: polygon
name: Polygon
url: https://raw.githubusercontent.com/api-evangelist/polygon/refs/heads/main/apis.yml
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
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-05-29'
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:stocks-api
    name: Polygon Stocks API
    description: >-
      Real-time and historical US equity market data including aggregate (OHLC) bars at minute/hour/day granularity,
      trades, NBBO quotes, snapshots, ticker reference, splits, dividends, and financials. Available via REST and the
      stocks WebSocket cluster.
    humanURL: https://polygon.io/docs/stocks
    baseURL: https://api.polygon.io
    tags:
      - Stocks
      - Equities
      - Market Data
      - Real-time
    properties:
      - type: Documentation
        url: https://polygon.io/docs/stocks
      - type: APIReference
        url: https://polygon.io/docs/stocks
      - type: OpenAPI
        url: openapi/polygon-stocks-openapi.yml
      - 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: Example
        url: examples/polygon-stocks-aggregate-bars-example.json
  - aid: polygon:options-api
    name: Polygon Options API
    description: >-
      OPRA-licensed options market data via REST and WebSocket: aggregates, trades, quotes, snapshots, contract
      reference, and option chains. Greeks and implied volatility are available on paid tiers.
    humanURL: https://polygon.io/docs/options
    baseURL: https://api.polygon.io
    tags:
      - Options
      - OPRA
      - Market Data
    properties:
      - type: Documentation
        url: https://polygon.io/docs/options
      - type: APIReference
        url: https://polygon.io/docs/options
      - type: OpenAPI
        url: openapi/polygon-options-openapi.yml
      - type: JSONSchema
        url: json-schema/polygon-options-contract-schema.json
      - type: JSONStructure
        url: json-structure/polygon-options-contract-structure.json
      - type: Example
        url: examples/polygon-options-chain-snapshot-example.json
  - aid: polygon:indices-api
    name: Polygon Indices API
    description: >-
      Real-time and historical index values for major US and global indices via REST and WebSocket. Includes aggregates,
      snapshots, and index reference data.
    humanURL: https://polygon.io/docs/indices
    baseURL: https://api.polygon.io
    tags:
      - Indices
      - Market Data
    properties:
      - type: Documentation
        url: https://polygon.io/docs/indices
      - type: APIReference
        url: https://polygon.io/docs/indices
      - type: OpenAPI
        url: openapi/polygon-indices-openapi.yml
  - aid: polygon:forex-api
    name: Polygon Forex API
    description: >-
      Real-time and historical FX prices for 1,000+ currency pairs via REST and WebSocket. Covers aggregates, quotes,
      snapshots, conversions, and previous-close.
    humanURL: https://polygon.io/docs/forex
    baseURL: https://api.polygon.io
    tags:
      - Forex
      - FX
      - Currencies
      - Market Data
    properties:
      - type: Documentation
        url: https://polygon.io/docs/forex
      - type: APIReference
        url: https://polygon.io/docs/forex
      - type: OpenAPI
        url: openapi/polygon-forex-openapi.yml
      - type: Example
        url: examples/polygon-forex-conversion-example.json
  - aid: polygon:crypto-api
    name: Polygon Crypto API
    description: >-
      Aggregates, trades, snapshots, and level-2 order books for crypto pairs sourced across major exchanges, plus
      WebSocket streaming on the crypto cluster.
    humanURL: https://polygon.io/docs/crypto
    baseURL: https://api.polygon.io
    tags:
      - Crypto
      - Cryptocurrency
      - Market Data
    properties:
      - type: Documentation
        url: https://polygon.io/docs/crypto
      - type: APIReference
        url: https://polygon.io/docs/crypto
      - type: OpenAPI
        url: openapi/polygon-crypto-openapi.yml
  - aid: polygon:reference-api
    name: Polygon Reference API
    description: >-
      Reference data covering tickers, ticker types, markets, exchanges, market holidays, market status, conditions,
      stock splits, dividends, and ticker news. Shared across all asset classes.
    humanURL: https://polygon.io/docs/stocks/get_v3_reference_tickers
    baseURL: https://api.polygon.io
    tags:
      - Reference
      - Tickers
      - Exchanges
      - Calendars
    properties:
      - type: Documentation
        url: https://polygon.io/docs/stocks/get_v3_reference_tickers
      - type: OpenAPI
        url: openapi/polygon-reference-openapi.yml
      - type: JSONSchema
        url: json-schema/polygon-ticker-schema.json
      - type: JSONStructure
        url: json-structure/polygon-ticker-structure.json
      - type: Example
        url: examples/polygon-reference-tickers-example.json
  - 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: Example
        url: examples/polygon-websocket-subscribe-example.json
common:
  - type: PostmanWorkspace
    url: https://www.postman.com/kinlaneapi/polygon/overview
  - type: ArazzoWorkflows
    url: arazzo/
    workflows:
      - url: arazzo/polygon-corporate-actions-workflow.yml
        name: Polygon Corporate Actions Review
        summary: Resolve a ticker, then list its stock splits and dividends history.
      - url: arazzo/polygon-crypto-daily-comparison-workflow.yml
        name: Polygon Crypto Daily Comparison
        summary: Check market status, snapshot a crypto pair, and read its daily open/close.
      - url: arazzo/polygon-crypto-pair-analysis-workflow.yml
        name: Polygon Crypto Pair Analysis
        summary: Snapshot a crypto pair, pull its aggregate bars, and read its Level-2 order book.
      - url: arazzo/polygon-forex-pair-analysis-workflow.yml
        name: Polygon Forex Pair Analysis
        summary: Read a currency pair's last quote, convert an amount, and pull its aggregate bars.
      - url: arazzo/polygon-grouped-market-scan-workflow.yml
        name: Polygon Grouped Market Scan
        summary: Check market status, pull grouped daily bars for all US stocks, and profile one symbol.
      - url: arazzo/polygon-index-analysis-workflow.yml
        name: Polygon Index Analysis
        summary: Snapshot an index, pull its aggregate bars, and read its previous close.
      - url: arazzo/polygon-market-gated-stock-daily-workflow.yml
        name: Polygon Market-Gated Stock Daily Snapshot
        summary: Check current US market status, then pull a stock's daily open/close and previous close.
      - url: arazzo/polygon-options-chain-scan-workflow.yml
        name: Polygon Options Chain Scan
        summary: Resolve an underlying's details, scan its options chain, and read its previous close.
      - url: arazzo/polygon-options-contract-deep-dive-workflow.yml
        name: Polygon Options Contract Deep Dive
        summary: List an underlying's option contracts, snapshot the top contract, and pull its bars.
      - url: arazzo/polygon-stock-research-workflow.yml
        name: Polygon Stock Research
        summary: Resolve a stock ticker's reference details, pull its aggregate bars, and read its previous close.
      - url: arazzo/polygon-ticker-discovery-workflow.yml
        name: Polygon Ticker Discovery and Profile
        summary: Search active stock tickers, resolve the top match's details, and pull its recent bars.
      - url: arazzo/polygon-ticker-news-context-workflow.yml
        name: Polygon Ticker News Context
        summary: Resolve a ticker's details, pull recent news, and read its previous close.
  - 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: SDK
    url: https://github.com/polygon-io/client-php
    title: Official PHP SDK
  - type: SDK
    url: https://pypi.org/project/polygon-api-client/
    title: Python SDK
  - type: SDK
    url: https://www.npmjs.com/package/@polygon.io/client-js
    title: JavaScript / TypeScript SDK
  - type: SDK
    url: https://central.sonatype.com/artifact/io.polygon.kotlin.sdk/polygon-kotlin-sdk-jvm
    title: Kotlin / JVM SDK
  - type: SDK
    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