# Polygon.io

**Provider:** Polygon.io
**Category:** finance
**Base URL:** `https://api.polygon.io/v2`
**Auth:** api-key — `?apiKey=YOUR_API_KEY`
**Rate Limit:** 5 calls/min (free) · Unlimited (paid)
**Free Tier:** Yes — [object Object]
**Pricing:** from $29/mo (freemium)
**Docs:** https://polygon.io/docs

## Description

Polygon.io provides institutional-grade financial market data via a clean REST and WebSocket API. Access real-time trades, quotes, aggregates, and snapshots for US stocks, options chains, forex pairs, and crypto assets. Includes company financials, news, and technical indicators. Used by quant funds, fintech apps, and trading bots.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://api.polygon.io/v2/aggs/ticker/{ticker}/range/{multiplier}/{timespan}/{from}/{to}` | Aggregate OHLCV bars for a ticker |
| GET | `https://api.polygon.io/v2/snapshot/locale/us/markets/stocks/tickers` | Real-time snapshots for all US stocks |
| GET | `https://api.polygon.io/v2/last/trade/{stocksTicker}` | Get the last trade for a stock |
| GET | `https://api.polygon.io/v2/reference/tickers` | List and search all available tickers |
| GET | `https://api.polygon.io/v2/v3/reference/options/contracts` | List options contracts with filtering |
| GET | `https://api.polygon.io/v2/v2/forex/currencies` | Get all forex currency pairs |

## Authentication

Pass your API key as a query parameter named apiKey on every request.

```
?apiKey=YOUR_API_KEY
```

## Sample Request

```bash
curl "https://api.polygon.io/v2/aggs/ticker/AAPL/range/1/day/2024-01-01/2024-01-31?adjusted=true&sort=asc&apiKey=$POLYGON_API_KEY"
```

## Sample Response

```json
{
  "ticker": "AAPL",
  "resultsCount": 21,
  "results": [{
    "v": 55884904,
    "o": 185.57,
    "c": 185.92,
    "h": 186.74,
    "l": 183.82,
    "t": 1704067200000,
    "n": 531365
  }]
}
```

## Pricing Details

Free: delayed data, limited endpoints. Starter $29/mo: real-time data. Developer $79/mo: options + forex. Advanced $199/mo: unlimited assets + WebSocket.

---

*Source: [API Map](https://apimap.dev/apis/polygon-io/) — CC BY 4.0*