polygon.io APIpolygon.io ↗
Access stocks, crypto, forex, and OTC market data via the Polygon.io API. Get OHLCV aggregates, ticker details, financials, news, and real-time snapshots.
curl -X GET 'https://api.parse.bot/scraper/f36d5ee6-8ac4-4778-8ec5-04a9787d2d73/get_all_tickers?limit=5&market=stocks' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve a list of ticker symbols across markets (stocks, crypto, fx, otc). Returns paginated results filtered by market, type, active status, or specific ticker symbol. Requires a valid Massive API key.
| Param | Type | Description |
|---|---|---|
| type | string | Filter by ticker type: CS (common stock), ETF, FUND, etc. |
| limit | integer | Maximum number of results to return. |
| active | boolean | Filter for active tickers only. |
| market | string | Filter by market type: stocks, crypto, fx, otc. |
| ticker | string | Search for a specific ticker symbol. |
| api_keyrequired | string | Your Polygon.io/Massive API key. |
{
"type": "object",
"fields": {
"count": "integer — number of results returned",
"status": "string — response status (e.g. OK)",
"results": "array of ticker objects with symbol, name, market, type, etc.",
"request_id": "string — unique request identifier"
},
"sample": {
"data": {
"count": 5,
"status": "OK",
"results": [
{
"name": "Agilent Technologies Inc.",
"type": "CS",
"active": true,
"market": "stocks",
"ticker": "A"
}
],
"request_id": "abc123"
},
"status": "success"
}
}About the polygon.io API
This API exposes 7 endpoints covering Polygon.io market data across stocks, crypto, forex, and OTC markets. You can retrieve historical OHLCV bars via get_aggregates, pull company metadata and market cap via get_ticker_details, read multi-period income statements and balance sheets via get_financials, and check live session prices for multiple tickers simultaneously via get_universal_snapshot — all returning structured JSON.
Ticker Discovery and Metadata
The get_all_tickers endpoint returns a paginated list of ticker symbols filterable by market (stocks, crypto, fx, otc), type (CS for common stock, ETF, FUND, etc.), and active status. Each ticker object in the results array includes the symbol, name, market, and type. For a single symbol, get_ticker_details returns a richer object covering fields like market_cap, primary_exchange, and other company-level attributes.
Price History and Real-Time Snapshots
get_aggregates accepts a ticker, from_date, and to_date (both in YYYY-MM-DD format) and returns an array of OHLCV bar objects — each with fields t (timestamp), o, h, l, c, and v. The timespan parameter controls bar granularity: minute, hour, day, week, month, quarter, or year, combined with a multiplier for composite intervals like "2 hours". An adjusted flag indicates whether bars are split-adjusted. For current-session data, get_universal_snapshot accepts a comma-separated tickers list and returns live session and price-change data for each symbol across asset classes.
Financials and News
get_financials returns an array of financial reporting periods for a given ticker, each containing nested income_statement, balance_sheet, and cash_flow_statement objects. The limit parameter controls how many historical periods are returned. get_news retrieves recent financial news articles sorted by published_utc descending, optionally filtered by ticker, with each article object including title, author, tickers, and publication metadata.
Market Status
get_market_status is the only endpoint that requires no API key. It returns the current open/closed state for named exchanges (nasdaq, nyse, otc) and currency markets (crypto, fx), plus boolean flags for afterHours and earlyHours trading windows, a serverTime timestamp, and an indicesGroups object for index-level status.
- Build a stock screener using
get_all_tickersfiltered by market type and active status - Backtest a trading strategy using daily or hourly OHLCV bars from
get_aggregates - Display company fundamentals and market cap on an investment research dashboard via
get_ticker_details - Monitor live intraday price changes for a portfolio using
get_universal_snapshot - Automate financial statement ingestion for ratio analysis using
get_financialsincome and balance sheet fields - Surface ticker-specific news in a trading app using
get_newsfiltered by symbol - Gate trading logic on exchange open/closed state using
get_market_statusexchange and hours flags
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. 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 how do I control bar size?+
t (Unix timestamp), o, h, l, c, and v. Bar size is controlled by combining timespan (minute, hour, day, week, month, quarter, year) with a numeric multiplier. For example, multiplier=2 and timespan=hour produces 2-hour bars. The adjusted boolean in the response confirms whether split adjustments were applied.Can I retrieve options or futures contract data through this API?+
get_all_tickers and related endpoints, but options chains and futures contracts are not exposed. You can fork the API on Parse and revise it to add those endpoints.Does `get_financials` return quarterly and annual data?+
income_statement, balance_sheet, and cash_flow_statement objects. The limit parameter controls how many periods are returned, but period type filtering (quarterly vs. annual) is not exposed as an input parameter in the current endpoint definition. You can fork the API on Parse and revise it to add that filter.Does `get_news` support filtering by date range or source publication?+
ticker symbol and a limit on the number of articles returned. Results are sorted by published_utc descending. Date range filtering and source-level filtering are not available as parameters. You can fork the API on Parse and revise it to expose those inputs.