Polygon API

Get Polygon data as clean JSON with one key: 4 endpoints, 1 to 5 credits per call, the same response shape as every other platform.

What you get#

Onekey exposes Polygon as 4 endpoints behind one API key: 2 endpoints return one record (data is an object) and 2 endpoints return a list (data is an array). Every answer uses the same envelope (success, data, metadata, error), the cost is reported in metadata.credits_charged, and fields are mapped onto the unified schema so the code you write for Polygon also works for the rest of the finance & markets category.

Endpoints#

EndpointWhat it doesParametersCreditsStatus
aggregatesDaily OHLCV bars for a ticker between two dates.ticker*, from_date*, to_date*5beta
previous_closePrevious trading day OHLCV for a ticker.ticker*1beta
ticker_detailsReference details for a ticker.ticker*1beta
ticker_searchSearch reference tickers.q*5beta

A * marks a required parameter. Each endpoint name links to its reference page with the full parameter table, caching window and a recorded response.

Make a request#

This calls polygon.previous_close (1 credit, beta). Replace YOUR_API_KEY with your key; sign up, no card. 1,000 free credits cover the open-platform endpoints. Hard-to-reach platforms (X, TikTok, Instagram, Reddit, and others marked on their page) need a verified email and a purchased pack.

curl "https://api.onekey.dev/v1/polygon/previous_close?ticker=AAPL" \
  -H "x-api-key: YOUR_API_KEY"

Fields you get back#

These unified fields come back from Polygon, with the same names as on every other platform. The count is how many of its 4 mapped endpoints return the field; a field the source lacks is null, never missing. 2 platform-specific fields (ext.<name>) come on top, documented on each endpoint page.

FieldTypeEndpoints
market.symbolstring3
entity.categorystring2
entity.dateISO 8601 date2
entity.namestring2
entity.typestring2
market.closenumber2
market.exchangestring2
market.highnumber2
market.lownumber2
market.opennumber2
market.volumenumber2
entity.createdAtISO 8601 date1
entity.descriptionstring1
entity.urlURL1
market.marketCapnumber1

The full schema is in Unified schema.

Pricing#

Polygon calls cost 1 to 5 credits, flat per endpoint. Free when served from cache (0.2 credit for a cached response over 100 KB). Invalid, failed or not-found calls are not charged. See pricing for credit packs.