# Polygon — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access real-time and historical market data for stocks, cryptocurrencies, forex, and commodities—including price aggregates, ticker details, and financial statements—all from a single platform. Get the latest market news, check trading status across exchanges, and retrieve comprehensive ticker information to power your investment analysis and trading decisions.

**Category:** Finance & Markets | **Website:** [polygon.io/](https://polygon.io/) | **Docs:** [parse.bot/marketplace/f3f50b3f-831f-4cc5-ac0b-df0b8242c185/polygon-io-api](https://parse.bot/marketplace/f3f50b3f-831f-4cc5-ac0b-df0b8242c185/polygon-io-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-polygon-io-api-f3f50b3f/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_aggregates

Retrieve historical OHLCV bars for a ticker over a date range. Supports configurable timespan (minute to year) and multiplier. Results are optionally adjusted for splits. Defaults to the last 30 days of daily bars. Requires a valid Polygon.io API key.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `adjusted` | boolean | No | Whether results are adjusted for splits. |
| `api_key` | string | Yes | Polygon.io API key. |
| `from_date` | string | No | Start date in YYYY-MM-DD format. Defaults to 30 days ago. |
| `multiplier` | integer | No | The size of the timespan multiplier. |
| `ticker` | string | Yes | The ticker symbol (e.g. AAPL). |
| `timespan` | string | No | Size of the time window: minute, hour, day, week, month, quarter, year. |
| `to_date` | string | No | End date in YYYY-MM-DD format. Defaults to today. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-polygon-io-api-f3f50b3f/get_aggregates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"adjusted":"<boolean>","api_key":"<string>","from_date":"<string>","multiplier":"<integer>","ticker":"<string>","timespan":"<string>","to_date":"<string>"}'
```

### get_all_tickers

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. Requires a valid Polygon.io API key.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `active` | boolean | No | Filter for active tickers only. |
| `api_key` | string | Yes | Polygon.io API key. |
| `limit` | integer | No | Maximum number of results to return. |
| `market` | string | No | Filter by market: stocks, crypto, fx, otc. |
| `ticker` | string | No | Search for a specific ticker symbol. |
| `type` | string | No | Filter by ticker type: CS (common stock), ETF, FUND, etc. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-polygon-io-api-f3f50b3f/get_all_tickers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"active":"<boolean>","api_key":"<string>","limit":"<integer>","market":"<string>","ticker":"<string>","type":"<string>"}'
```

### get_financials

Retrieve standardized financial statement data (income statement, balance sheet, cash flow statement) for a company. Returns the most recent filing periods. Requires a valid Polygon.io API key.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `api_key` | string | Yes | Polygon.io API key. |
| `limit` | integer | No | Number of financial periods to return. |
| `ticker` | string | Yes | The ticker symbol (e.g. AAPL). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-polygon-io-api-f3f50b3f/get_financials \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api_key":"<string>","limit":"<integer>","ticker":"<string>"}'
```

### get_market_status

Retrieve current open/closed status for all exchanges (NYSE, NASDAQ, OTC) and currency markets (crypto, forex). Includes after-hours and early-hours indicators, server time, and index group statuses. No API key required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-polygon-io-api-f3f50b3f/get_market_status \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_news

Retrieve latest financial news articles sorted by publication date descending. Optionally filter by ticker symbol. Each article includes title, author, published timestamp, related tickers, and source URL. Requires a valid Polygon.io API key.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `api_key` | string | Yes | Polygon.io API key. |
| `limit` | integer | No | Maximum number of news articles to return. |
| `ticker` | string | No | Filter news by ticker symbol. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-polygon-io-api-f3f50b3f/get_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api_key":"<string>","limit":"<integer>","ticker":"<string>"}'
```

### get_ticker_details

Retrieve full metadata for a single ticker including company description, market cap, share class shares outstanding, primary exchange, SIC code, and branding. A single round-trip per ticker. Requires a valid Polygon.io API key.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `api_key` | string | Yes | Polygon.io API key. |
| `ticker` | string | Yes | The ticker symbol (e.g. AAPL, MSFT, X:BTCUSD). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-polygon-io-api-f3f50b3f/get_ticker_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api_key":"<string>","ticker":"<string>"}'
```

### get_universal_snapshot

Retrieve real-time snapshots for multiple tickers in a single call. Each snapshot includes last trade, session OHLCV, and price change data. Works across asset classes (stocks, crypto, forex). Requires a valid Polygon.io API key.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `api_key` | string | Yes | Polygon.io API key. |
| `tickers` | string | Yes | Comma-separated list of ticker symbols (e.g. AAPL,MSFT,GOOGL). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-polygon-io-api-f3f50b3f/get_universal_snapshot \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api_key":"<string>","tickers":"<string>"}'
```