Polygon.io Market Data

Market data from Polygon.io — price history, latest prices, company facts, news, corporate actions, fundamentals and market hours — for stocks, options, forex and crypto.

Every operation below was checked against Polygon's live OpenAPI spec and then actually called. Results as of 2026-08-17 on a free-tier key are in the last column.

Get a key

1. Sign up at https://polygon.io and copy your key from https://polygon.io/dashboard/api-keys.
2. Store it once: Credentials → New → API Key, name it (e.g. Polygon), paste the key.
3. Name that credential on every polygon task: "credentialName": "Polygon".

There is no apiKey input. This tool cannot work without a key, and a key typed into a workflow travels into its exports, its activity log, and any repository the workflow is committed to. The credential is the only way in, and the vault hands the key to the tool at execution.

A task with no credential is rejected when the workflow is validated — before it can run and fail.

The free tier covers historical data with a 5 calls/minute limit. Real-time endpoints (snapshot, last_trade, last_quote) need a paid plan and answer 403 NOT_AUTHORIZED without one.

Operations

Tickers

AAPL (stock) · X:BTCUSD (crypto) · C:EURUSD (forex) · O:SPY251219C00650000 (option) · I:SPX (index). The colon-prefixed forms are passed through unchanged.

Other inputs

• timespan — minute, hour, day, week, month, quarter, year (default day)
• multiplier — bar size multiplier, e.g. 5 with timespan=minute (default 1)
• limit — row cap; bars allows up to 50,000, reference endpoints default to 10
• query — any extra query parameters as a JSON object string, e.g. {"sort":"asc","adjusted":"true"}
• path — raw only: a path from Polygon's docs, e.g. /v3/snapshot/options/AAPL

Examples

Ten days of daily bars:

{"name":"prices","tool":"polygon","credentialName":"Polygon",
 "properties":{"operation":"bars","ticker":"AAPL","from":"2026-08-03","to":"2026-08-14"}}

credentialName is a field on the TASK — not a property, and never a {{...}} variable. The workflow holds the credential's NAME; the vault holds the key; the two meet inside the running task.

Five-minute bars for one session:

{"properties":{"operation":"bars","ticker":"TSLA","multiplier":"5","timespan":"minute",
               "from":"2026-08-14","to":"2026-08-14","limit":"200"}}

Three latest headlines for a ticker:

{"properties":{"operation":"news","ticker":"AAPL","limit":"3"}}

Bitcoin's previous close, via the escape hatch:

{"properties":{"operation":"raw","path":"/v2/aggs/ticker/X:BTCUSD/prev"}}

Output

• result — the API's JSON response, verbatim
• status — the HTTP status code

Errors carry Polygon's own message plus a hint: 401 → check the key, 403 → not in your plan, 429 → rate limit (5/min on free). The response body is passed through rather than swallowed, so the reason is in the log instead of a bare status number.

Notes

• The key is sent as Authorization: Bearer, not ?apiKey=, so it stays out of URLs and proxy logs. Polygon accepts both.
• api.polygon.io and api.massive.com are the same service (Polygon rebranded to Massive); this tool uses api.polygon.io, which remains live.
• Free-tier data is end-of-day; intraday bars are available but delayed.
• Rate limit: at 5 calls/minute a loop over many tickers needs a delay between steps.

Version history

• 3.0.0 — the key comes from an API Key credential only; the apiKey input is gone. 2.0.0 declared credentialBased: false while its executor read the credential, so the vault could never reach it and the key had to be written into the workflow.
• 2.0.0 — rewritten against the live spec. The 1.0.0 tool was generated from a decade-old Polygon spec: 5 of its 6 operations no longer existed (/v1/companies answered a bare 404), so it could not succeed. Adds credential support, header auth, 16 checked operations and raw.

Publishes

The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.

• result
• status

Input Properties

Every property this tool accepts, from its own tool.iml.