Polygon APIpolygon.io ↗
Access Polygon.io market data via API: ticker details, OHLCV aggregates, real-time snapshots, financial statements, news, and exchange status across stocks, crypto, and forex.
What is the Polygon API?
This API exposes 7 endpoints against Polygon.io's financial data platform, covering stocks, crypto, forex, and OTC markets. You can pull historical OHLCV bars with get_aggregates, retrieve real-time multi-ticker snapshots with get_universal_snapshot, fetch standardized income statement and balance sheet data with get_financials, and check live exchange open/closed status with get_market_status — all in a single integration.
curl -X GET 'https://api.parse.bot/scraper/f36d5ee6-8ac4-4778-8ec5-04a9787d2d73/get_all_tickers?limit=5&active=true&market=stocks&ticker=AAPL' \ -H 'X-API-Key: $PARSE_API_KEY'
List ticker symbols across markets (stocks, crypto, fx, otc). Filterable by market, type, active status, or ticker search string. Each result is a lightweight summary with symbol, name, market, type, and active status; a next_url field is present when more results exist beyond limit. One round-trip per call. No API key is required: without one the request is served through the site's public quote data; a supplied api_key is used instead and, when the key is unknown, the call returns a stale_input error.
| Param | Type | Description |
|---|---|---|
| type | string | Filter by ticker type code such as CS (common stock) or ETF. |
| limit | integer | Maximum number of results to return. |
| active | boolean | Filter for active tickers only. |
| market | string | Filter by market: stocks, crypto, fx, otc. |
| ticker | string | Search for a specific ticker symbol. |
| api_key | string | Optional Polygon.io/Massive API key. When omitted the public keyless data path is used. |
{
"type": "object",
"fields": {
"count": "integer — number of results returned",
"status": "string — response status (e.g. OK)",
"results": "array of ticker summary objects with ticker, name, market, type, locale, active, currency_name",
"next_url": "string — present only when more results exist beyond limit",
"request_id": "string — unique request identifier"
},
"sample": {
"data": {
"count": 1,
"status": "OK",
"results": [
{
"cik": "0000320193",
"name": "Apple Inc.",
"type": "CS",
"active": true,
"locale": "us",
"market": "stocks",
"ticker": "AAPL",
"currency_name": "usd",
"composite_figi": "BBG000B9XRY4",
"last_updated_utc": "2026-10-04T06:10:29.256280113Z",
"primary_exchange": "XNAS",
"share_class_figi": "BBG001S5N8V8"
}
],
"request_id": "a86bc3c9dfbff592fe00f1e8588fc8e7"
},
"status": "success"
}
}About the Polygon API
Ticker Discovery and Metadata
The get_all_tickers endpoint lists ticker symbols across stocks, crypto, forex, and OTC markets. Responses include ticker, name, market, type, locale, active, and currency_name per result. You can filter with the market param (stocks, crypto, fx, otc), the type param (e.g. CS for common stock, ETF), and an active boolean. get_ticker_details accepts a single ticker param and returns a deeper object with market_cap, primary_exchange, sic_code, company description, and branding data.
Historical and Real-Time Price Data
get_aggregates returns OHLCV bars for any ticker over a configurable date range. The timespan param accepts minute, hour, day, week, month, quarter, or year, and multiplier sets the interval size (e.g. multiplier=5 with timespan=minute gives 5-minute bars). Each bar in the results array carries t (timestamp in milliseconds), o, h, l, c, v (volume), vw (volume-weighted average price), and n (number of trades). The adjusted boolean controls split adjustment.
get_universal_snapshot accepts a comma-separated tickers list and returns a session object per ticker with open, high, low, close, volume, and price change fields — useful for building multi-asset dashboards in a single call.
Financials, News, and Market Status
get_financials returns standardized filing data: each result in the array contains income_statement, balance_sheet, and cash_flow_statement sub-objects alongside filing metadata. The limit param controls how many periods are returned.
get_news returns articles sorted by published_utc descending, each with title, author, article_url, related tickers, and description. Filter by symbol using the ticker param. get_market_status requires no API key and returns real-time open/closed state for nasdaq, nyse, and otc exchanges plus crypto and fx currency markets, afterHours and earlyHours booleans, and a serverTime ISO timestamp.
The Polygon API is a managed, monitored endpoint for polygon.io — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when polygon.io changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official polygon.io API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Charting historical price data using
get_aggregatesOHLCV bars with configurable timespans - Screening tickers by market and type using
get_all_tickerswithmarketandtypefilters - Building a multi-asset watchlist dashboard with real-time session data from
get_universal_snapshot - Automating fundamental analysis by pulling income statement and balance sheet data from
get_financials - Displaying company profiles with
market_cap,sic_code, anddescriptionfromget_ticker_details - Gating trading logic on exchange open/closed state using
get_market_statuswithout consuming API quota - Monitoring financial news flow for a specific stock by filtering
get_newswith thetickerparam
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Polygon.io have an official developer API?+
What does `get_aggregates` return, and can it handle intraday data?+
t in milliseconds), open, high, low, close, volume (v), volume-weighted average price (vw), and trade count (n). Setting timespan to minute or hour and providing from_date/to_date within a recent window returns intraday bars. Intraday data availability depends on your Polygon.io API key tier.Does the API return real-time streaming quotes?+
get_universal_snapshot endpoint returns the latest session snapshot per ticker as a point-in-time response. For continuous streaming data, Polygon.io's own WebSocket API would need to be integrated separately. You can fork this API on Parse and add a polling wrapper or additional snapshot endpoints to approximate near-real-time feeds.Are options or futures contracts covered?+
How many periods does `get_financials` return, and how recent is the data?+
limit param controls how many filing periods are returned per call. Data freshness depends on when Polygon.io ingests filings from public sources such as SEC EDGAR. There is no guaranteed lag SLA built into this endpoint — the most recently filed period available on Polygon.io at query time is what the API reflects.