# Polygon API

> Polygon API on Apizie: 10 endpoints (Available Companies, Available Currencies, Historic Aggregates, Historic Forex Ticks, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/finance:polygon/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `finance:polygon`
- Category: Finance
- Status: byok
- Source: https://polygon.io
- Page: https://zieapi.vercel.app/api/finance/polygon
- OpenAPI: https://zieapi.vercel.app/api/finance/polygon/openapi.json

The future of fintech.

## Endpoints

### Available Companies
`GET https://zieapi.vercel.app/v1/finance:polygon/get-v1-companies` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| sort | string | no | Which field to sort by. For desc place a `-` in front of the field name. eg `?sort=-marketcap` |
| perpage | number | no | How many items to be on each page during pagination |
| page | number | no | Which page of results to return |

### Available Currencies
`GET https://zieapi.vercel.app/v1/finance:polygon/get-v1-currencies` (byok)

### Historic Aggregates
`GET https://zieapi.vercel.app/v1/finance:polygon/get-v1-historic-agg-size-symbol-date` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| size | string | yes | Size of the aggregation. `second` or `minute` |
| symbol | string | yes | Symbol of the company to retrieve |
| date | string | yes | Date/Day of the historic ticks to retreive |
| offset | integer | no | Timestamp offset, used for pagination |
| limit | integer | no | Limit the size of response, max: 10000 |

### Historic Forex Ticks
`GET https://zieapi.vercel.app/v1/finance:polygon/get-v1-historic-forex-from-to-date` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| from | string | yes | From Symbol of the currency pair |
| to | string | yes | To Symbol of the currency pair |
| date | string | yes | Date/Day of the historic ticks to retreive |
| offset | integer | no | Timestamp offset, used for pagination |
| limit | integer | no | Limit the size of response, max: 10000 |

### Historic Quotes
`GET https://zieapi.vercel.app/v1/finance:polygon/get-v1-historic-quotes-symbol-date` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | yes | Symbol of the company to retrieve |
| date | string | yes | Date/Day of the historic ticks to retreive |
| offset | integer | no | Timestamp offset, used for pagination |
| limit | integer | no | Limit the size of response, max: 10000 |

### Historic Trades
`GET https://zieapi.vercel.app/v1/finance:polygon/get-v1-historic-trades-symbol-date` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | yes | Symbol of the company to retrieve |
| date | string | yes | Date/Day of the historic ticks to retreive |
| offset | integer | no | Timestamp offset, used for pagination |
| limit | integer | no | Limit the size of response, max: 10000 |

### Last Trade for a Currency Pair
`GET https://zieapi.vercel.app/v1/finance:polygon/get-v1-last-currencies-from-to` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| from | string | yes | From Symbol of the pair |
| to | string | yes | To Symbol of the pair |

### Last Trade for a Symbol
`GET https://zieapi.vercel.app/v1/finance:polygon/get-v1-last-stocks-symbol` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | yes | Symbol of the stock to get |

### Last Quote for a Currency Pair
`GET https://zieapi.vercel.app/v1/finance:polygon/get-v1-last-quote-currencies-from-to` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| from | string | yes | From Symbol of the pair |
| to | string | yes | To Symbol of the pair |

### Last Quote for a Symbol
`GET https://zieapi.vercel.app/v1/finance:polygon/get-v1-last-quote-stocks-symbol` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | yes | Symbol of the stock to get |

## Example
```
curl "https://zieapi.vercel.app/v1/finance:polygon/get-v1-companies" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Polygon API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/finance:polygon/get-v1-companies with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Polygon API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Polygon itself also needs your own key from polygon.io.

### Can AI agents use the Polygon API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key finance:polygon.

### What is the status of the Polygon API?
Needs your own provider key (bring your own key)