Getting Started

The Polygon.io API is organized around REST. Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

The financial data that you can access through the Polygon.io API differs based on your plan. These docs are customized to your version of the API and display your key and data, which only you can see.

Authentication

Pass your API key in the query string like follows:

https://api.polygon.io/v2/aggs/ticker/AAPL/range/1/day/2020-06-01/2020-06-17?apiKey=*

Alternatively, you can add an Authorization header to the request with your API Key as the token in the following form:

Authorization: Bearer <token>

Tickers

get
/v3/reference/tickers

Query all ticker symbols which are supported by Polygon.io. This API currently includes Stocks/Equities, Crypto, and Forex.

Parameters

Specify a ticker symbol. Defaults to empty string which queries all tickers.

Return results where this field is less than the value.

Return results where this field is less than or equal to the value.

Return results where this field is greater than the value.

Return results where this field is greater than or equal to the value.

Specify the type of the tickers. Find the types that we support via our Ticker Types API. Defaults to empty string which queries all types.

Filter by market type. By default all markets are included.

Specify the primary exchange of the asset in the ISO code format. Find more information about the ISO codes at the ISO org website. Defaults to empty string which queries all exchanges.

Specify the CUSIP code of the asset you want to search for. Find more information about CUSIP codes at their website. Defaults to empty string which queries all CUSIPs.

Note: Although you can query by CUSIP, due to legal reasons we do not return the CUSIP in the response.

Specify the CIK of the asset you want to search for. Find more information about CIK codes at their website. Defaults to empty string which queries all CIKs.

Specify a point in time to retrieve tickers available on that date. Defaults to the most recent available date.

Search for terms within the ticker and/or company name.

Specify if the tickers returned should be actively traded on the queried date. Default is true.

The field to sort the results on. Default is ticker. If the search query parameter is present, sort is ignored and results are ordered by relevance.

The order to sort the results on. Default is asc (ascending).

Limit the size of the response, default is 100 and max is 1000.

If your query returns more than the max limit and you want to retrieve the next page of results, see the next_url response attribute.

https://api.polygon.io/v3/reference/tickers?&apiKey=*

Response Attributes
resultsarray

An array of tickers that match your query.

Note: Although you can query by CUSIP, due to legal reasons we do not return the CUSIP in the response.

tickerstring

The exchange symbol that this item is traded under.


namestring

The name of the asset. For stocks/equities this will be the companies registered name. For crypto/fx this will be the name of the currency or coin pair.


marketenum [stocks, crypto, fx]

The market type of the asset.


localeenum [us, global]

The locale of the asset.


primary_exchangestring

The ISO code of the primary listing exchange for this asset.


typestring

The type of the asset. Find the types that we support via our Ticker Types API.


activeboolean

Whether or not the asset is actively traded. False means the asset has been delisted.


currency_namestring

The name of the currency that this asset is traded with.


cikstring

The CIK number for this ticker. Find more information here.


composite_figistring

The composite OpenFIGI number for this ticker. Find more information here


share_class_figistring

The share Class OpenFIGI number for this ticker. Find more information here


last_updated_utcstring

The last time this asset record was updated.


delisted_utcstring

The last date that the asset was traded.


next_urlstring

If present, this value can be used to fetch the next page of data.


request_idstring

A request id assigned by the server.


statusstring

The status of this request's response.


countinteger

The total number of results for this request.


Response Object

{
 "results": [
  {
   "ticker": "A",
   "name": "Agilent Technologies Inc.",
   "market": "stocks",
   "locale": "us",
   "primary_exchange": "XNYS",
   "type": "CS",
   "active": true,
   "currency_name": "usd",
   "cik": "0001090872",
   "composite_figi": "BBG000BWQYZ5",
   "share_class_figi": "BBG001SCTQY4",
   "last_updated_utc": "2021-04-25T00:00:00Z"
  }
 ],
 "status": "OK",
 "request_id": "e70013d92930de90e089dc8fa098888e",
 "count": 1,
 "next_url": "https://api.polygon.io/vX/reference/tickers?cursor=YWN0aXZlPXRydWUmZGF0ZT0yMDIxLTA0LTI1JmxpbWl0PTEmb3JkZXI9YXNjJnBhZ2VfbWFya2VyPUElN0M5YWRjMjY0ZTgyM2E1ZjBiOGUyNDc5YmZiOGE1YmYwNDVkYzU0YjgwMDcyMWE2YmI1ZjBjMjQwMjU4MjFmNGZiJnNvcnQ9dGlja2Vy"
}

Ticker Types

get
/v2/reference/types

Get a mapping of ticker types to their descriptive names.

https://api.polygon.io/v2/reference/types?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


resultsobject
typesobject
CSstring

Common Stock


ADRstring

American Depository Receipt


NVDRstring

Non-Voting Depository Receipt


GDRstring

Global Depositary Receipt


SDRstring

Special Drawing Right


CEFstring

Closed-End Fund


ETPstring

Exchange Traded Product/Fund


REITstring

Real Estate Investment Trust


MLPstring

Master Limited Partnership


WRTstring

Equity WRT


PUBstring

Public


NYRSstring

New York Registry Shares


UNITstring

Unit


RIGHTstring

Right


TRAKstring

Tracking stock or targeted stock


LTDPstring

Limited Partnership


RYLTstring

Royalty Trust


MFstring

Mutual Fund


PFDstring

Preferred Stock


FDRstring

Foreign Ordinary Shares


OSTstring

Other Security Type


FUNDstring

Fund


SPstring

Structured Product


SIstring

Secondary Issue


indexTypesobject
INDEXstring

Index


ETFstring

Exchange Traded Fund (ETF)


ETNstring

Exchange Traded Note (ETN)


ETMFstring

Exchange Traded Managed Fund (ETMF)


SETTLEMENTstring

Settlement


SPOTstring

Spot


SUBPRODstring

Subordinated product


WCstring

World Currency


ALPHAINDEXstring

Alpha Index


Response Object

{
 "status": "OK",
 "results": {
  "types": {
   "CS": "Common Stock",
   "BOND": "Bond",
   "BASKET": "Basket",
   "ADRC": "American Depository Receipt Common",
   "ADRP": "American Depository Receipt Preferred",
   "ADRW": "American Depository Receipt Warrant",
   "ADRR": "American Depository Receipt Right",
   "NVDR": "Non-Voting Depository Receipt",
   "GDR": "Global Depositary Receipt",
   "SDR": "Special Drawing Right",
   "CEF": "Closed-End Fund",
   "ETP": "Exchange Traded Product/Fund",
   "REIT": "Real Estate Investment Trust",
   "MLP": "Master Limited Partnership",
   "WRT": "Equity WRT",
   "PUB": "Public",
   "NYRS": "New York Registry Shares",
   "UNIT": "Unit",
   "RIGHT": "Right",
   "TRAK": "Tracking stock or targeted stock",
   "LTDP": "Limited Partnership",
   "RYLT": "Royalty Trust",
   "MF": "Mutual Fund",
   "PFD": "Preferred Stock",
   "FDR": "Foreign Ordinary Shares",
   "OST": "Other Security Type",
   "FUND": "Fund",
   "SP": "Structured Product",
   "SI": "Secondary Issue",
   "WARRANT": "Warrant"
  },
  "indexTypes": {
   "INDEX": "Index",
   "ETF": "Exchange Traded Fund (ETF)",
   "ETN": "Exchange Traded Note (ETN)",
   "ETMF": "Exchange Traded Managed Fund (ETMF)",
   "SETTLEMENT": "Settlement",
   "SPOT": "Spot",
   "SUBPROD": "Subordinated product",
   "WC": "World Currency",
   "ALPHAINDEX": "Alpha Index"
  }
 }
}

Ticker Details

get
/v1/meta/symbols/{stocksTicker}/company

Get details for a ticker symbol's company/entity. This provides a general overview of the entity with information such as name, sector, exchange, logo and similar companies.

Parameters

The ticker symbol of the stock/equity.

https://api.polygon.io/v1/meta/symbols/{stocksTicker}/company?&apiKey=*

Response Attributes
logostring

The URL of the entity's logo.


exchangestring

The symbol's primary exchange.


exchangeSymbolstring

The exchange code (id) of the symbol's primary exchange.


typestring

The type or class of the security. (Full List of Ticker Types)


namestring

The name of the company/entity.


symbolstring

The exchange symbol that this item is traded under.


listdatestring

The date that the symbol was listed on the exchange.


cikstring

The official CIK guid used for SEC database/filings.


bloombergstring

The Bloomberg guid for the symbol.


figistring

The OpenFigi project guid for the symbol. (https://openfigi.com/)


leistring

The Legal Entity Identifier (LEI) guid for the symbol. (https://en.wikipedia.org/wiki/Legal_Entity_Identifier)


sicinteger

Standard Industrial Classification (SIC) id for the symbol. (https://en.wikipedia.org/wiki/Legal_Entity_Identifier)


countrystring

The country in which the company is registered.


industrystring

The industry in which the company operates.


sectorstring

The sector of the indsutry in which the symbol operates.


marketcapinteger

The current market cap for the company.


employeesinteger

The approximate number of employees for the company.


phonestring

The phone number for the company. This is usually a corporate contact number.


ceostring

The name of the company's current CEO.


urlstring

The URL of the company's website


descriptionstring

A description of the company and what they do/offer.


hq_addressstring

The street address for the company's headquarters.


hq_statestring

The state in which the company's headquarters is located.


hq_countrystring

The country in which the company's headquarters is located.


similararray [string]

A list of ticker symbols for similar companies.


tagsarray [string]

A list of words related to the company.


updatedstring

The last time this company record was updated.


activeboolean

Indicates if the security is actively listed. If false, this means the company is no longer listed and cannot be traded.


Response Object

{
 "logo": "https://s3.polygon.io/logos/aapl/logo.png",
 "listdate": "1990-01-02T00:00:00.000Z",
 "cik": 320193,
 "bloomberg": "EQ0010169500001000",
 "figi": null,
 "lei": "HWUPKR0MPOU8FGXBT394",
 "sic": 3571,
 "country": "usa",
 "industry": "Computer Hardware",
 "sector": "Technology",
 "marketcap": 908316631180,
 "employees": 123000,
 "phone": "+1 408 996-1010",
 "ceo": "Timothy D. Cook",
 "url": "http://www.apple.com",
 "description": "Apple Inc is designs, manufactures and markets mobile communication and media devices and personal computers, and sells a variety of related software, services, accessories, networking solutions and third-party digital content and applications.",
 "exchange": "Nasdaq Global Select",
 "name": "Apple Inc.",
 "symbol": "AAPL",
 "exchangeSymbol": "NGS",
 "hq_address": "1 Infinite Loop Cupertino CA, 95014",
 "hq_state": "CA",
 "hq_country": "USA",
 "type": "CS",
 "updated": "11/16/2018",
 "tags": [
  "Technology",
  "Consumer Electronics",
  "Computer Hardware"
 ],
 "similar": [
  "MSFT",
  "NOK",
  "IBM",
  "HPQ",
  "GOOGL",
  "BB",
  "XLK"
 ],
 "active": true
}

Ticker Details vX

get
/vX/reference/tickers/{ticker}

Get a single ticker supported by Polygon.io. This response will have detailed information about the ticker and the company behind it.

This API is experimental and will replace Ticker Details

Parameters

The ticker symbol of the asset.

Specify a point in time to get information about the ticker available on that date. When retrieving information from SEC filings, we compare this date with the period of report date on the SEC filing.

For example, consider an SEC filing submitted by AAPL on 2019-07-31, with a period of report date ending on 2019-06-29. That means that the filing was submitted on 2019-07-31, but the filing was created based on information from 2019-06-29. If you were to query for AAPL details on 2019-06-29, the ticker details would include information from the SEC filing.

Defaults to the most recent available date.

https://api.polygon.io/vX/reference/tickers/{ticker}?&apiKey=*

Response Attributes
resultsobject

Ticker with details.

tickerstring

The exchange symbol that this item is traded under.


namestring

The name of the asset. For stocks/equities this will be the companies registered name. For crypto/fx this will be the name of the currency or coin pair.


marketenum [stocks, crypto, fx]

The market type of the asset.


localeenum [us, global]

The locale of the asset.


primary_exchangestring

The ISO code of the primary listing exchange for this asset.


typestring

The type of the asset. Find the types that we support via our Ticker Types API.


activeboolean

Whether or not the asset is actively traded. False means the asset has been delisted.


currency_namestring

The name of the currency that this asset is traded with.


cikstring

The CIK number for this ticker. Find more information here.


composite_figistring

The composite OpenFIGI number for this ticker. Find more information here


share_class_figistring

The share Class OpenFIGI number for this ticker. Find more information here


last_updated_utcstring

The last time this asset record was updated.


delisted_utcstring

The last date that the asset was traded.


outstanding_sharesnumber

The recorded number of outstanding shares.


market_capnumber

The most recent close price of the ticker multiplied by outstanding shares.


phone_numberstring

The phone number for the company behind this ticker.


addressobject
address1string

The first line of the company's headquarters address.


citystring

The city of the company's headquarters address.


statestring

The state of the company's headquarters address.


sic_codestring

The standard industrial classification code for this ticker. For a list of SIC Codes, see the SEC's SIC Code List.


sic_descriptionstring

A description of this ticker's SIC code.


request_idstring

A request id assigned by the server.


statusstring

The status of this request's response.


countinteger

The total number of results for this request.


Response Object

{
 "results": {
  "ticker": "AAPL",
  "name": "Apple Inc.",
  "market": "stocks",
  "locale": "us",
  "primary_exchange": "XNAS",
  "type": "CS",
  "active": true,
  "currency_name": "usd",
  "cik": "0000320193",
  "composite_figi": "BBG000B9XRY4",
  "share_class_figi": "BBG001S5N8V8",
  "last_updated_utc": "2020-12-27T00:00:00Z",
  "outstanding_shares": 17001800000,
  "market_cap": 2082042128180,
  "phone_number": "(408) 996-1010",
  "address": {
   "address1": "One Apple Park Way",
   "city": "Cupertino",
   "state": "CA"
  },
  "sic_code": "3571",
  "sic_description": "ELECTRONIC COMPUTERS"
 },
 "status": "OK",
 "request_id": "31d59dda-80e5-4721-8496-d0d32a654afe",
 "count": 1
}

Ticker News

get
/v2/reference/news

Get the most recent news articles relating to a stock ticker symbol, including a summary of the article and a link to the original source.

Parameters

Limit the size of the response, default is 100 and max is 1000.

If your query returns more than the max limit and you want to retrieve the next page of results, see the next_url response attribute.

Order the results in ascending or descending order.

The field key to sort the results on.

Return results where this field equals the value.

Return results where this field is less than the value.

Return results where this field is less than or equal to the value.

Return results where this field is greater than the value.

Return results where this field is greater than or equal to the value.

Return results where this field equals the value.

Return results where this field is less than the value.

Return results where this field is less than or equal to the value.

Return results where this field is greater than the value.

Return results where this field is greater than or equal to the value.

https://api.polygon.io/v2/reference/news?&apiKey=*

Response Attributes
resultsarray
id*string

Unique identifier for the article.


publisher*object
namestring

The publisher's name.


logo_urlstring

The publisher's logo URL.


homepage_urlstring

The publisher's homepage URL.


favicon_urlstring

The publisher's homepage favicon URL.


title*string

The title of the news article.


author*string

The article's author.


published_utc*string

The date the article was published on.


article_url*string

A link to the news article.


tickers*array [string]

The ticker symbols associated with the article.


amp_urlstring

The mobile friendly Accelerated Mobile Page (AMP) URL.


image_urlstring

The article's image URL.


descriptionstring

A description of the article.


keywordsarray [string]

The keywords associated with the article (which will vary depending on the publishing source).


next_urlstring

If present, this value can be used to fetch the next page of data.


request_idstring

A request id assigned by the server.


statusstring

The status of this request's response.


countinteger

The total number of results for this request.


Response Object

{
 "results": [
  {
   "id": "nJsSJJdwViHZcw5367rZi7_qkXLfMzacXBfpv-vD9UA",
   "publisher": {
    "name": "Benzinga",
    "homepage_url": "https://www.benzinga.com/",
    "logo_url": "https://storage.googleapis.com/polygon-io-public/assets/news/logos/benzinga.svg",
    "favicon_url": "https://storage.googleapis.com/polygon-io-public/assets/news/favicons/benzinga.ico"
   },
   "title": "Cathie Wood Adds More Coinbase, Skillz, Trims Square",
   "author": "Rachit Vats",
   "published_utc": "2021-04-26T02:33:17Z",
   "article_url": "https://www.benzinga.com/markets/cryptocurrency/21/04/20784086/cathie-wood-adds-more-coinbase-skillz-trims-square",
   "tickers": [
    "DOCU",
    "DDD",
    "NIU",
    "ARKF",
    "NVDA",
    "SKLZ",
    "PCAR",
    "MASS",
    "PSTI",
    "SPFR",
    "TREE",
    "PHR",
    "IRDM",
    "BEAM",
    "ARKW",
    "ARKK",
    "ARKG",
    "PSTG",
    "SQ",
    "IONS",
    "SYRS"
   ],
   "amp_url": "https://amp.benzinga.com/amp/content/20784086",
   "image_url": "https://cdn2.benzinga.com/files/imagecache/og_image_social_share_1200x630/images/story/2012/andre-francois-mckenzie-auhr4gcqcce-unsplash.jpg?width=720",
   "description": "<p>Cathie Wood-led Ark Investment Management on Friday snapped up another 221,167 shares of the cryptocurrency exchange <strong>Coinbase Global Inc </strong>(NASDAQ: <a class=\"ticker\" href=\"https://www.benzinga.com/stock/coin#NASDAQ\">COIN</a>) worth about $64.49 million on the stock&rsquo;s Friday&rsquo;s dip and also its fourth-straight loss.</p>\n<p>The investment firm&rsquo;s <strong>Ark Innovation ETF</strong> (NYSE: <a class=\"ticker\" href=\"https://www.benzinga.com/stock/arkk#NYSE\">ARKK</a>) bought the shares of the company that closed 0.63% lower at $291.60 on Friday, giving the cryptocurrency exchange a market cap of $58.09 billion. Coinbase&rsquo;s market cap has dropped from $85.8 billion on its blockbuster listing earlier this month.</p>\n<p>The New York-based company also added another 3,873 shares of the mobile gaming company <strong>Skillz Inc</strong> (NYSE: <a class=\"ticker\" href=\"https://www.benzinga.com/stock/sklz#NYSE\">SKLZ</a>), <a href=\"http://www.benzinga.com/markets/cryptocurrency/21/04/20762794/cathie-woods-ark-loads-up-another-1-2-million-shares-in-skillz-also-adds-coinbase-draftkin\">just a day after</a> snapping 1.2 million shares of the stock.</p>\n<p>ARKK bought the shares of the company which closed ...</p><p><a href=https://www.benzinga.com/markets/cryptocurrency/21/04/20784086/cathie-wood-adds-more-coinbase-skillz-trims-square alt=Cathie Wood Adds More Coinbase, Skillz, Trims Square>Full story available on Benzinga.com</a></p>",
   "keywords": [
    "Sector ETFs",
    "Penny Stocks",
    "Cryptocurrency",
    "Small Cap",
    "Markets",
    "Trading Ideas",
    "ETFs"
   ]
  }
 ],
 "status": "OK",
 "request_id": "831afdb0b8078549fed053476984947a",
 "count": 1,
 "next_url": "https://api.polygon.io:443/v2/reference/news?cursor=eyJsaW1pdCI6MSwic29ydCI6InB1Ymxpc2hlZF91dGMiLCJvcmRlciI6ImFzY2VuZGluZyIsInRpY2tlciI6e30sInB1Ymxpc2hlZF91dGMiOnsiZ3RlIjoiMjAyMS0wNC0yNiJ9LCJzZWFyY2hfYWZ0ZXIiOlsxNjE5NDA0Mzk3MDAwLG51bGxdfQ"
}

Markets

get
/v2/reference/markets

Get a list of markets that are currently supported by Polygon.io.

https://api.polygon.io/v2/reference/markets?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


resultsarray

A list of supported markets.

marketstring

The name of the market.


descstring

A description of the market.


Response Object

{
 "status": "OK",
 "results": [
  {
   "market": "STOCKS",
   "desc": "Stocks / Equities / ETFs"
  },
  {
   "market": "INDICES",
   "desc": "Indices"
  },
  {
   "market": "MF",
   "desc": "Mutual Funds"
  },
  {
   "market": "MMF",
   "desc": "Money Market Funds"
  },
  {
   "market": "CRYPTO",
   "desc": "Crypto"
  },
  {
   "market": "FX",
   "desc": "Forex / Currencies"
  },
  {
   "market": "BONDS",
   "desc": "Bonds"
  }
 ]
}

Locales

get
/v2/reference/locales

Get a list of locales currently supported by Polygon.io.

https://api.polygon.io/v2/reference/locales?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


resultsarray
localestring

An abbreviated country name.


namestring

The name of the country.


Response Object

{
 "status": "OK",
 "results": [
  {
   "locale": "G",
   "name": "Global"
  },
  {
   "locale": "US",
   "name": "United States of America"
  },
  {
   "locale": "GB",
   "name": "Great Britain"
  },
  {
   "locale": "CA",
   "name": "Canada"
  },
  {
   "locale": "NL",
   "name": "Netherlands"
  },
  {
   "locale": "GR",
   "name": "Greece"
  },
  {
   "locale": "SP",
   "name": "Spain"
  },
  {
   "locale": "DE",
   "name": "Germany"
  },
  {
   "locale": "BE",
   "name": "Belgium"
  },
  {
   "locale": "DK",
   "name": "Denmark"
  },
  {
   "locale": "FI",
   "name": "Finland"
  },
  {
   "locale": "IE",
   "name": "Ireland"
  },
  {
   "locale": "PT",
   "name": "Portugal"
  },
  {
   "locale": "IN",
   "name": "India"
  },
  {
   "locale": "MX",
   "name": "Mexico"
  },
  {
   "locale": "FR",
   "name": "France"
  },
  {
   "locale": "CN",
   "name": "China"
  },
  {
   "locale": "CH",
   "name": "Switzerland"
  },
  {
   "locale": "SE",
   "name": "Sweden"
  }
 ]
}

Stock Splits

get
/v2/reference/splits/{stocksTicker}

Get a list of historical stock splits for a ticker symbol, including the execution and payment dates of the stock split, and the split ratio.

Parameters

The ticker symbol of the stock/equity.

https://api.polygon.io/v2/reference/splits/{stocksTicker}?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


countinteger

The total number of results for this request.


resultsarray
tickerstring

The exchange symbol that this item is traded under.


exDatestring

The execution date of the stock split.


paymentDatestring

The payment date of the stock split.


declaredDatestring

The declared date of the stock split.


rationumber

This refers to the split ratio. The split ratio is an inverse of the number of shares that a holder of the stock would have after the split divided by the number of shares that the holder had before.

For example: A split ratio of .5 means a 2 for 1 split.


tofactorinteger

The "to" factor of the split. This is used to calculate the split ratio forfactor/tofactor = ratio (eg ½ = 0.5).


forfactorinteger

The "for" factor of the split. This is used to calculate the split ratio forfactor/tofactor = ratio (eg ½ = 0.5).


Response Object

{
 "status": "OK",
 "count": 4,
 "results": [
  {
   "ticker": "AAPL",
   "exDate": "2020-08-31T00:00:00.000Z",
   "paymentDate": "2020-08-28T00:00:00.000Z",
   "declaredDate": "2020-07-30T00:00:00.000Z",
   "ratio": 0.25,
   "tofactor": 1,
   "forfactor": 4
  },
  {
   "ticker": "AAPL",
   "exDate": "2014-06-09T00:00:00.000Z",
   "paymentDate": "2014-06-10T00:00:00.000Z",
   "ratio": 0.14285714285714285,
   "tofactor": 1,
   "forfactor": 7
  },
  {
   "ticker": "AAPL",
   "exDate": "2005-02-28T00:00:00.000Z",
   "paymentDate": "2005-02-28T00:00:00.000Z",
   "ratio": 0.5
  },
  {
   "ticker": "AAPL",
   "exDate": "2000-06-21T00:00:00.000Z",
   "paymentDate": "2000-06-21T00:00:00.000Z",
   "ratio": 0.5
  }
 ]
}

Stock Dividends

get
/v2/reference/dividends/{stocksTicker}

Get a list of historical dividends for a stock, including the relevant dates and the amount of the dividend.

Parameters

The ticker symbol of the stock/equity.

https://api.polygon.io/v2/reference/dividends/{stocksTicker}?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


countinteger

The total number of results for this request.


resultsarray
tickerstring

The exchange symbol that this item is traded under.


exDatestring

The execution date of the dividend.


paymentDatestring

The payment date of the dividend.


recordDatestring

The date of record for the dividend.

See Investor.gov for an explanation on dividend dates and their meaning.


amountnumber

The amount of the dividend.


Response Object

{
 "status": "OK",
 "count": 2,
 "results": [
  {
   "ticker": "AAPL",
   "exDate": "2020-05-08T00:00:00.000Z",
   "paymentDate": "2020-05-14T00:00:00.000Z",
   "recordDate": "2020-05-11T00:00:00.000Z",
   "amount": 0.82
  },
  {
   "ticker": "AAPL",
   "exDate": "2020-02-07T00:00:00.000Z",
   "paymentDate": "2020-02-13T00:00:00.000Z",
   "recordDate": "2020-02-10T00:00:00.000Z",
   "amount": 0.77
  }
 ]
}

Stock Financials

get
/v2/reference/financials/{stocksTicker}

Get historical financial data for a stock ticker.

Parameters

The ticker symbol of the stock/equity.

Limit the number of results.

Specify a type of report to return.

Y = Year YA = Year annualized Q = Quarter QA = Quarter Annualized T = Trailing twelve months TA = trailing twelve months annualized

The direction to sort the returned results.

https://api.polygon.io/v2/reference/financials/{stocksTicker}?&apiKey=*

Response Attributes
statusstring

countinteger

resultsarray
ticker*string

The exchange symbol that this item is traded under.


periodenum [Q, T, QA, TA, Y, YA]

Reporting period.


calendarDatestring

reportPeriodstring

updatedstring

accumulatedOtherComprehensiveIncomeinteger

assetsinteger

assetsAverageinteger

assetsCurrentinteger

assetTurnoverinteger

assetsNonCurrentinteger

bookValuePerSharenumber

capitalExpenditureinteger

cashAndEquivalentsinteger

cashAndEquivalentsUSDinteger

costOfRevenueinteger

consolidatedIncomeinteger

currentRationumber

debtToEquityRationumber

debtinteger

debtCurrentinteger

debtNonCurrentinteger

debtUSDinteger

deferredRevenueinteger

depreciationAmortizationAndAccretioninteger

depositsinteger

dividendYieldinteger

dividendsPerBasicCommonShareinteger

earningBeforeInterestTaxesinteger

earningsBeforeInterestTaxesDepreciationAmortizationinteger

EBITDAMarginnumber

earningsBeforeInterestTaxesDepreciationAmortizationUSDinteger

earningBeforeInterestTaxesUSDinteger

earningsBeforeTaxinteger

earningsPerBasicSharenumber

earningsPerDilutedSharenumber

earningsPerBasicShareUSDnumber

shareholdersEquityinteger

averageEquityinteger

shareholdersEquityUSDinteger

enterpriseValueinteger

enterpriseValueOverEBITinteger

enterpriseValueOverEBITDAnumber

freeCashFlowinteger

freeCashFlowPerSharenumber

foreignCurrencyUSDExchangeRateinteger

grossProfitinteger

grossMarginnumber

goodwillAndIntangibleAssetsinteger

interestExpenseinteger

investedCapitalinteger

investedCapitalAverageinteger

inventoryinteger

investmentsinteger

investmentsCurrentinteger

investmentsNonCurrentinteger

totalLiabilitiesinteger

currentLiabilitiesinteger

liabilitiesNonCurrentinteger

marketCapitalizationinteger

netCashFlowinteger

netCashFlowBusinessAcquisitionsDisposalsinteger

issuanceEquitySharesinteger

issuanceDebtSecuritiesinteger

paymentDividendsOtherCashDistributionsinteger

netCashFlowFromFinancinginteger

netCashFlowFromInvestinginteger

netCashFlowInvestmentAcquisitionsDisposalsinteger

netCashFlowFromOperationsinteger

effectOfExchangeRateChangesOnCashinteger

netIncomeinteger

netIncomeCommonStockinteger

netIncomeCommonStockUSDinteger

netLossIncomeFromDiscontinuedOperationsinteger

netIncomeToNonControllingInterestsinteger

profitMarginnumber

operatingExpensesinteger

operatingIncomeinteger

tradeAndNonTradePayablesinteger

payoutRatiointeger

priceToBookValuenumber

priceEarningsnumber

priceToEarningsRationumber

propertyPlantEquipmentNetinteger

preferredDividendsIncomeStatementImpactinteger

sharePriceAdjustedClosenumber

priceSalesnumber

priceToSalesRationumber

tradeAndNonTradeReceivablesinteger

accumulatedRetainedEarningsDeficitinteger

revenuesinteger

revenuesUSDinteger

researchAndDevelopmentExpenseinteger

returnOnAverageAssetsinteger

returnOnAverageEquityinteger

returnOnInvestedCapitalinteger

returnOnSalesnumber

shareBasedCompensationinteger

sellingGeneralAndAdministrativeExpenseinteger

shareFactorinteger

sharesinteger

weightedAverageSharesinteger

weightedAverageSharesDilutedinteger

salesPerSharenumber

tangibleAssetValueinteger

taxAssetsinteger

incomeTaxExpenseinteger

taxLiabilitiesinteger

tangibleAssetsBookValuePerSharenumber

workingCapitalinteger

Response Object

{
 "status": "OK",
 "count": 1,
 "results": [
  {
   "ticker": "string",
   "period": "Q",
   "calendarDate": "2019-03-31",
   "reportPeriod": "2019-03-31",
   "updated": "1999-03-28",
   "accumulatedOtherComprehensiveIncome": 0,
   "assets": 0,
   "assetsAverage": 0,
   "assetsCurrent": 0,
   "assetTurnover": 0,
   "assetsNonCurrent": 0,
   "bookValuePerShare": 0,
   "capitalExpenditure": 0,
   "cashAndEquivalents": 0,
   "cashAndEquivalentsUSD": 0,
   "costOfRevenue": 0,
   "consolidatedIncome": 0,
   "currentRatio": 0,
   "debtToEquityRatio": 0,
   "debt": 0,
   "debtCurrent": 0,
   "debtNonCurrent": 0,
   "debtUSD": 0,
   "deferredRevenue": 0,
   "depreciationAmortizationAndAccretion": 0,
   "deposits": 0,
   "dividendYield": 0,
   "dividendsPerBasicCommonShare": 0,
   "earningBeforeInterestTaxes": 0,
   "earningsBeforeInterestTaxesDepreciationAmortization": 0,
   "EBITDAMargin": 0,
   "earningsBeforeInterestTaxesDepreciationAmortizationUSD": 0,
   "earningBeforeInterestTaxesUSD": 0,
   "earningsBeforeTax": 0,
   "earningsPerBasicShare": 0,
   "earningsPerDilutedShare": 0,
   "earningsPerBasicShareUSD": 0,
   "shareholdersEquity": 0,
   "averageEquity": 0,
   "shareholdersEquityUSD": 0,
   "enterpriseValue": 0,
   "enterpriseValueOverEBIT": 0,
   "enterpriseValueOverEBITDA": 0,
   "freeCashFlow": 0,
   "freeCashFlowPerShare": 0,
   "foreignCurrencyUSDExchangeRate": 0,
   "grossProfit": 0,
   "grossMargin": 0,
   "goodwillAndIntangibleAssets": 0,
   "interestExpense": 0,
   "investedCapital": 0,
   "investedCapitalAverage": 0,
   "inventory": 0,
   "investments": 0,
   "investmentsCurrent": 0,
   "investmentsNonCurrent": 0,
   "totalLiabilities": 0,
   "currentLiabilities": 0,
   "liabilitiesNonCurrent": 0,
   "marketCapitalization": 0,
   "netCashFlow": 0,
   "netCashFlowBusinessAcquisitionsDisposals": 0,
   "issuanceEquityShares": 0,
   "issuanceDebtSecurities": 0,
   "paymentDividendsOtherCashDistributions": 0,
   "netCashFlowFromFinancing": 0,
   "netCashFlowFromInvesting": 0,
   "netCashFlowInvestmentAcquisitionsDisposals": 0,
   "netCashFlowFromOperations": 0,
   "effectOfExchangeRateChangesOnCash": 0,
   "netIncome": 0,
   "netIncomeCommonStock": 0,
   "netIncomeCommonStockUSD": 0,
   "netLossIncomeFromDiscontinuedOperations": 0,
   "netIncomeToNonControllingInterests": 0,
   "profitMargin": 0,
   "operatingExpenses": 0,
   "operatingIncome": 0,
   "tradeAndNonTradePayables": 0,
   "payoutRatio": 0,
   "priceToBookValue": 0,
   "priceEarnings": 0,
   "priceToEarningsRatio": 0,
   "propertyPlantEquipmentNet": 0,
   "preferredDividendsIncomeStatementImpact": 0,
   "sharePriceAdjustedClose": 0,
   "priceSales": 0,
   "priceToSalesRatio": 0,
   "tradeAndNonTradeReceivables": 0,
   "accumulatedRetainedEarningsDeficit": 0,
   "revenues": 0,
   "revenuesUSD": 0,
   "researchAndDevelopmentExpense": 0,
   "returnOnAverageAssets": 0,
   "returnOnAverageEquity": 0,
   "returnOnInvestedCapital": 0,
   "returnOnSales": 0,
   "shareBasedCompensation": 0,
   "sellingGeneralAndAdministrativeExpense": 0,
   "shareFactor": 0,
   "shares": 0,
   "weightedAverageShares": 0,
   "weightedAverageSharesDiluted": 0,
   "salesPerShare": 0,
   "tangibleAssetValue": 0,
   "taxAssets": 0,
   "incomeTaxExpense": 0,
   "taxLiabilities": 0,
   "tangibleAssetsBookValuePerShare": 0,
   "workingCapital": 0
  }
 ]
}

Market Holidays

get
/v1/marketstatus/upcoming

Get upcoming market holidays and their open/close times.

https://api.polygon.io/v1/marketstatus/upcoming?&apiKey=*

Response Attributes
responsearray
exchangestring

Which market the record is for.


namestring

The name of the holiday.


statusstring

The status of the market on the holiday.


datestring

The date of the holiday.


openstring

The market open time on the holiday (if it's not closed).


closestring

The market close time on the holiday (if it's not closed).


Response Object

[
 {
  "exchange": "NYSE",
  "name": "Thanksgiving",
  "date": "2020-11-26T00:00:00.000Z",
  "status": "closed"
 },
 {
  "exchange": "NASDAQ",
  "name": "Thanksgiving",
  "date": "2020-11-26T00:00:00.000Z",
  "status": "closed"
 },
 {
  "exchange": "OTC",
  "name": "Thanksgiving",
  "date": "2020-11-26T00:00:00.000Z",
  "status": "closed"
 },
 {
  "exchange": "NASDAQ",
  "name": "Thanksgiving",
  "date": "2020-11-27T00:00:00.000Z",
  "status": "early-close",
  "open": "2020-11-27T14:30:00.000Z",
  "close": "2020-11-27T18:00:00.000Z"
 },
 {
  "exchange": "NYSE",
  "name": "Thanksgiving",
  "date": "2020-11-27T00:00:00.000Z",
  "status": "early-close",
  "open": "2020-11-27T14:30:00.000Z",
  "close": "2020-11-27T18:00:00.000Z"
 }
]

Market Status

get
/v1/marketstatus/now

Get the current trading status of the exchanges and overall financial markets.

https://api.polygon.io/v1/marketstatus/now?&apiKey=*

Response Attributes
marketstring

The status of the market as a whole.


serverTimestring

The current time of the server.


exchangesobject
nysestring

The status of the NYSE market.


nasdaqstring

The status of the Nasdaq market.


otcstring

The status of the OTC market.


currenciesobject
fxstring

The status of the forex market.


cryptostring

The status of the crypto market.


Response Object

{
 "market": "extended-hours",
 "serverTime": "2020-11-10T22:37:37.000Z",
 "exchanges": {
  "nyse": "extended-hours",
  "nasdaq": "extended-hours",
  "otc": "closed"
 },
 "currencies": {
  "fx": "open",
  "crypto": "open"
 }
}

Stock Exchanges

get
/v1/meta/exchanges

Get a list of stock exchanges which are supported by Polygon.io.

https://api.polygon.io/v1/meta/exchanges?&apiKey=*

Response Attributes
responsearray
idnumber

The ID of the exchange.


typestring

The type of exchange.

  • TRF = Trade Reporting Facility
  • exchange = Reporting exchange on the tape

marketstring

The market data type that this exchange contains.


micstring

The Market Identification Code or MIC as defined in ISO 10383 (https://en.wikipedia.org/wiki/Market_Identifier_Code).


namestring

The name of the exchange.


tapestring

The tape id of the exchange.


codestring

A unique identifier for the exchange internal to Polygon.io. This is not an industry code or ISO standard.


Response Object

[
 {
  "id": 0,
  "type": "TRF",
  "market": "equities",
  "mic": "TFF",
  "name": "Multiple",
  "tape": "-"
 },
 {
  "id": 1,
  "type": "exchange",
  "market": "equities",
  "mic": "XASE",
  "name": "NYSE American (AMEX)",
  "tape": "A",
  "code": "AMX"
 },
 {
  "id": 2,
  "type": "exchange",
  "market": "equities",
  "mic": "XNAS",
  "name": "NASDAQ OMX BX",
  "tape": "B",
  "code": "NSD"
 },
 {
  "id": 3,
  "type": "TRF",
  "market": "equities",
  "name": "National Stock Exchange",
  "mic": "XCIS",
  "tape": "C"
 }
]

Condition Mappings

get
/v1/meta/conditions/{ticktype}

Get a unified numerical mapping for conditions on trades and quotes. Each feed/exchange uses its own set of codes to identify conditions, so the same condition may have a different code depending on the originator of the data. Polygon.io defines its own mapping to allow for uniformly identifying a condition across feeds/exchanges.

Parameters

The type of ticks to return mappings for.

https://api.polygon.io/v1/meta/conditions/{ticktype}?&apiKey=*

Response Attributes
conditionstring

Polygon.io's mapping for condition codes. For more information, see our Trade Conditions Glossary.


Response Object

{
 "0": "Regular",
 "1": "Acquisition",
 "2": "AveragePrice",
 "3": "AutomaticExecution",
 "4": "Bunched",
 "5": "BunchSold",
 "6": "CAPElection",
 "7": "CashTrade",
 "8": "Closing",
 "9": "Cross",
 "10": "DerivativelyPriced",
 "11": "Distribution",
 "12": "FormT(ExtendedHours)",
 "13": "FormTOutOfSequence",
 "14": "InterMarketSweep",
 "15": "MarketCenterOfficialClose",
 "16": "MarketCenterOfficialOpen",
 "17": "MarketCenterOpening",
 "18": "MarketCenterReOpenning",
 "19": "MarketCenterClosing",
 "20": "NextDay",
 "21": "PriceVariation",
 "22": "PriorReferencePrice",
 "23": "Rule155Amex",
 "24": "Rule127Nyse",
 "25": "Opening",
 "26": "Opened",
 "27": "RegularStoppedStock",
 "28": "ReOpening",
 "29": "Seller",
 "30": "SoldLast",
 "31": "SoldLastStoppedStock",
 "32": "SoldOutOfSequence",
 "33": "SoldOutOfSequenceStoppedStock",
 "34": "Split",
 "35": "StockOption",
 "36": "YellowFlag",
 "37": "OddLot",
 "38": "CorrectedConsolidatedClosePrice",
 "39": "Unknown",
 "40": "Held",
 "41": "TradeThruExempt",
 "42": "NonEligible",
 "43": "NonEligible-extended",
 "44": "Cancelled",
 "45": "Recovery",
 "46": "Correction",
 "47": "AsOf",
 "48": "AsOfCorrection",
 "49": "AsOfCancel",
 "50": "OOB",
 "51": "Summary",
 "52": "Contingent",
 "53": "Contingent(Qualified)",
 "54": "Errored"
}

Crypto Exchanges

get
/v1/meta/crypto-exchanges

Get a list of cryptocurrency exchanges which are supported by Polygon.io.

https://api.polygon.io/v1/meta/crypto-exchanges?&apiKey=*

Response Attributes
responsearray
idinteger

The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.


typestring

Type of exchange feed


marketstring

Market data type this exchange contains ( crypto only currently )


namestring

Name of the exchange


urlstring

URL of this exchange


Response Object

[
 {
  "id": 1,
  "type": "exchange",
  "market": "crypto",
  "name": "Coinbase",
  "url": "https://www.coinbase.com/"
 },
 {
  "id": 2,
  "type": "exchange",
  "market": "crypto",
  "name": "BITFINEX",
  "url": "https://www.bitfinex.com/"
 },
 {
  "id": 6,
  "type": "exchange",
  "market": "crypto",
  "name": "Bitstamp",
  "url": "https://www.bitstamp.net/"
 },
 {
  "id": 23,
  "type": "exchange",
  "market": "crypto",
  "name": "Kraken",
  "url": "https://www.kraken.com/en-us/"
 }
]

Trades

get
/v2/ticks/stocks/trades/{ticker}/{date}

Get trades for a given ticker symbol on a specified date.

Parameters

The ticker symbol we want trades for.

The date/day of the trades to retrieve in the format YYYY-MM-DD.

The timestamp offset, used for pagination. This is the offset at which to start the results. Using the timestamp of the last result as the offset will give you the next page of results.

The maximum timestamp allowed in the results.

Reverse the order of the results.

Limit the size of the response, max 50000 and default 5000.

https://api.polygon.io/v2/ticks/stocks/trades/{ticker}/{date}?&apiKey=*

Response Attributes
tickerstring

The exchange symbol that this item is traded under.


results_countinteger

The total number of results for this request.


db_latencyinteger

Latency in milliseconds for the query results from the database.


successboolean

Whether or not this query was executed successfully.


resultsarray
Tstring

The exchange symbol that this item is traded under.


tinteger

The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this message from the exchange which produced it.


yinteger

The nanosecond accuracy Participant/Exchange Unix Timestamp. This is the timestamp of when the quote was actually generated at the exchange.


finteger

The nanosecond accuracy TRF(Trade Reporting Facility) Unix Timestamp. This is the timestamp of when the trade reporting facility received this message.


qinteger

The sequence number represents the sequence in which message events happened. These are increasing and unique per ticker symbol, but will not always be sequential (e.g., 1, 2, 6, 9, 10, 11).


carray [integer]

A list of condition codes.


iinteger

The Trade ID which uniquely identifies a trade. These are unique per combination of ticker, exchange, and TRF. For example: A trade for AAPL executed on NYSE and a trade for AAPL executed on NASDAQ could potentially have the same Trade ID.


pnumber

The price of the trade. This is the actual dollar value per whole share of this trade. A trade of 100 shares with a price of $2.00 would be worth a total dollar value of $200.00.


snumber

The size of a trade (also known as volume).


einteger

The trade correction indicator.


xinteger

The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.


rinteger

The ID for the Trade Reporting Facility where the trade took place.


zinteger

There are 3 tapes which define which exchange the ticker is listed on. These are integers in our objects which represent the letter of the alphabet. Eg: 1 = A, 2 = B, 3 = C.

  • Tape A is NYSE listed securities
  • Tape B is NYSE ARCA / NYSE American
  • Tape C is NASDAQ

Response Object

{
 "ticker": "AAPL",
 "results_count": 2,
 "db_latency": 11,
 "success": true,
 "results": [
  {
   "t": 1517562000016036600,
   "y": 1517562000015577000,
   "q": 1063,
   "i": "1",
   "x": 11,
   "s": 100,
   "c": [
    12,
    41
   ],
   "p": 171.55,
   "z": 3
  },
  {
   "t": 1517562000016038100,
   "y": 1517562000015577600,
   "q": 1064,
   "i": "2",
   "x": 11,
   "s": 100,
   "c": [
    12,
    41
   ],
   "p": 171.55,
   "z": 3
  }
 ],
 "map": {
  "I": {
   "name": "orig_id",
   "type": "string"
  },
  "x": {
   "name": "exchange",
   "type": "int"
  },
  "p": {
   "name": "price",
   "type": "float64"
  },
  "i": {
   "name": "id",
   "type": "string"
  },
  "e": {
   "name": "correction",
   "type": "int"
  },
  "r": {
   "name": "trf_id",
   "type": "int"
  },
  "t": {
   "name": "sip_timestamp",
   "type": "int64"
  },
  "y": {
   "name": "participant_timestamp",
   "type": "int64"
  },
  "f": {
   "name": "trf_timestamp",
   "type": "int64"
  },
  "q": {
   "name": "sequence_number",
   "type": "int64"
  },
  "c": {
   "name": "conditions",
   "type": "int"
  },
  "s": {
   "name": "size",
   "type": "int"
  },
  "z": {
   "name": "tape",
   "type": "int"
  }
 }
}

Quotes (NBBO)

get
/v2/ticks/stocks/nbbo/{ticker}/{date}

Get NBBO quotes for a given ticker symbol on a specified date.

Parameters

The ticker symbol we want quotes for.

The date/day of the quotes to retrieve in the format YYYY-MM-DD.

The timestamp offset, used for pagination. This is the offset at which to start the results. Using the timestamp of the last result as the offset will give you the next page of results.

The maximum timestamp allowed in the results.

Reverse the order of the results.

Limit the size of the response, max 50000 and default 5000.

https://api.polygon.io/v2/ticks/stocks/nbbo/{ticker}/{date}?&apiKey=*

Response Attributes
tickerstring

The exchange symbol that this item is traded under.


results_countinteger

The total number of results for this request.


db_latencyinteger

Latency in milliseconds for the query results from the database.


successboolean

Whether or not this query was executed successfully.


resultsarray
Tstring

The exchange symbol that this item is traded under.


tinteger

The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this message from the exchange which produced it.


yinteger

The nanosecond accuracy Participant/Exchange Unix Timestamp. This is the timestamp of when the quote was actually generated at the exchange.


finteger

The nanosecond accuracy TRF(Trade Reporting Facility) Unix Timestamp. This is the timestamp of when the trade reporting facility received this message.


qinteger

The sequence number represents the sequence in which message events happened. These are increasing and unique per ticker symbol, but will not always be sequential (e.g., 1, 2, 6, 9, 10, 11).


carray [integer]

A list of condition codes.


iarray [integer]

The indicators. For more information, see our glossary of Conditions and Indicators.


pnumber

The bid price.


sinteger

The bid size. This represents the number of round lot orders at the given bid price. The normal round lot size is 100 shares. A bid size of 2 means there are 200 shares for purchase at the given bid price.


xinteger

Bid Exchange Id


Pnumber

The ask price.


Sinteger

The ask size. This represents the number of round lot orders at the given ask price. The normal round lot size is 100 shares. An ask size of 2 means there are 200 shares available to purchase at the given ask price.


Xinteger

Ask Exchange Id


zinteger

There are 3 tapes which define which exchange the ticker is listed on. These are integers in our objects which represent the letter of the alphabet. Eg: 1 = A, 2 = B, 3 = C.

  • Tape A is NYSE listed securities
  • Tape B is NYSE ARCA / NYSE American
  • Tape C is NASDAQ

Response Object

{
 "ticker": "AAPL",
 "success": true,
 "results_count": 2,
 "db_latency": 43,
 "results": [
  {
   "t": 1517562000065700400,
   "y": 1517562000065321200,
   "q": 2060,
   "c": [
    1
   ],
   "z": 3,
   "p": 102.7,
   "s": 60,
   "x": 11,
   "P": 0,
   "S": 0,
   "X": 0
  },
  {
   "t": 1517562000065791500,
   "y": 1517562000065408300,
   "q": 2061,
   "c": [
    1
   ],
   "z": 3,
   "p": 170,
   "s": 2,
   "x": 11,
   "P": 0,
   "S": 0,
   "X": 0
  }
 ],
 "map": {
  "t": {
   "name": "sip_timestamp",
   "type": "int64"
  },
  "y": {
   "name": "participant_timestamp",
   "type": "int64"
  },
  "i": {
   "name": "indicators",
   "type": "int"
  },
  "P": {
   "name": "ask_price",
   "type": "float64"
  },
  "X": {
   "name": "ask_exchange",
   "type": "int"
  },
  "f": {
   "name": "trf_timestamp",
   "type": "int64"
  },
  "q": {
   "name": "sequence_number",
   "type": "int"
  },
  "c": {
   "name": "conditions",
   "type": "int"
  },
  "p": {
   "name": "bid_price",
   "type": "float64"
  },
  "s": {
   "name": "bid_size",
   "type": "int"
  },
  "x": {
   "name": "bid_exchange",
   "type": "int"
  },
  "S": {
   "name": "ask_size",
   "type": "int"
  },
  "z": {
   "name": "tape",
   "type": "int"
  }
 }
}

Last Trade for a Symbol

get
/v1/last/stocks/{stocksTicker}

Get the most recent trade for a given stock.

This API has been deprecated and will be replaced by Last Trade for a Symbol v2 on September 01, 2021

Parameters

The ticker symbol of the stock/equity.

https://api.polygon.io/v1/last/stocks/{stocksTicker}?&apiKey=*

Response Attributes
symbolstring

The exchange symbol that this item is traded under.


statusstring

The status of this request's response.


request_idstring

A request id assigned by the server.


lastobject
pricenumber

The price of the trade. This is the actual dollar value per whole share of this trade. A trade of 100 shares with a price of $2.00 would be worth a total dollar value of $200.00.


sizenumber

The size of a trade (also known as volume).


exchangeinteger

The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.


cond1integer

Condition 1 of the trade. See Polygon.io's mapping of conditions to exchange descriptions.


cond2integer

Condition 2 of the trade. See Polygon.io's mapping of conditions to exchange descriptions.


cond3integer

Condition 3 of the trade. See Polygon.io's mapping of conditions to exchange descriptions.


cond4integer

Condition 4 of the trade. See Polygon.io's mapping of conditions to exchange descriptions.


timestampinteger

The Unix Msec timestamp for the start of the aggregate window.


Response Object

{
 "symbol": "AAPL",
 "status": "success",
 "request_id": "fbb6074f249ea54a1ad924e4967c36af",
 "last": {
  "cond1": 37,
  "exchange": 4,
  "price": 119.1802,
  "size": 10,
  "timestamp": 1605122370210
 }
}

Last Trade for a Symbol v2

get
/v2/last/trade/{stocksTicker}

Get the most recent trade for a given stock.

Parameters

The ticker symbol of the stock/equity.

https://api.polygon.io/v2/last/trade/{stocksTicker}?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


request_idstring

A request id assigned by the server.


resultsobject
Tstring

The exchange symbol that this item is traded under.


tinteger

The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this message from the exchange which produced it.


yinteger

The nanosecond accuracy Participant/Exchange Unix Timestamp. This is the timestamp of when the quote was actually generated at the exchange.


finteger

The nanosecond accuracy TRF(Trade Reporting Facility) Unix Timestamp. This is the timestamp of when the trade reporting facility received this message.


qinteger

The sequence number represents the sequence in which message events happened. These are increasing and unique per ticker symbol, but will not always be sequential (e.g., 1, 2, 6, 9, 10, 11).


carray [integer]

A list of condition codes.


iinteger

The Trade ID which uniquely identifies a trade. These are unique per combination of ticker, exchange, and TRF. For example: A trade for AAPL executed on NYSE and a trade for AAPL executed on NASDAQ could potentially have the same Trade ID.


pnumber

The price of the trade. This is the actual dollar value per whole share of this trade. A trade of 100 shares with a price of $2.00 would be worth a total dollar value of $200.00.


snumber

The size of a trade (also known as volume).


einteger

The trade correction indicator.


xinteger

The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.


rinteger

The ID for the Trade Reporting Facility where the trade took place.


zinteger

There are 3 tapes which define which exchange the ticker is listed on. These are integers in our objects which represent the letter of the alphabet. Eg: 1 = A, 2 = B, 3 = C.

  • Tape A is NYSE listed securities
  • Tape B is NYSE ARCA / NYSE American
  • Tape C is NASDAQ

Response Object

{
 "request_id": "f05562305bd26ced64b98ed68b3c5d96",
 "status": "OK",
 "results": {
  "T": "AAPL",
  "c": [
   37
  ],
  "f": 1617901342969796400,
  "i": "118749",
  "p": 129.8473,
  "q": 3135876,
  "r": 202,
  "s": 25,
  "t": 1617901342969834000,
  "x": 4,
  "y": 1617901342968000000,
  "z": 3
 }
}

Last Quote for a Symbol

get
/v1/last_quote/stocks/{stocksTicker}

Get the most recent quote tick for a given stock.

This API has been deprecated and will be replaced by Last Quote for a Symbol v2 on September 01, 2021

Parameters

The ticker symbol of the stock/equity.

https://api.polygon.io/v1/last_quote/stocks/{stocksTicker}?&apiKey=*

Response Attributes
symbolstring

The exchange symbol that this item is traded under.


statusstring

The status of this request's response.


request_idstring

A request id assigned by the server.


lastobject
askpricenumber

The ask price.


asksizeinteger

The ask size. This represents the number of round lot orders at the given ask price. The normal round lot size is 100 shares. An ask size of 2 means there are 200 shares available to purchase at the given ask price.


askexchangeinteger

The exchange ID that this liquidity is available on. See Exchanges for Polygon.io's mapping of exchange IDs.


bidpricenumber

The bid price.


bidsizeinteger

The bid size. This represents the number of round lot orders at the given bid price. The normal round lot size is 100 shares. A bid size of 2 means there are 200 shares for purchase at the given bid price.


bidexchangeinteger

The exchange ID that this liquidity is available on. See Exchanges for Polygon.io's mapping of exchange IDs.


timestampinteger

The Unix Msec timestamp for the start of the aggregate window.


Response Object

{
 "symbol": "AAPL",
 "status": "success",
 "request_id": "9463580f28a577b10c3b46266fc7203e",
 "last": {
  "askexchange": 8,
  "askprice": 119.51,
  "asksize": 8,
  "bidexchange": 11,
  "bidprice": 119.5,
  "bidsize": 2,
  "timestamp": 1605121721850
 }
}

Last Quote for a Symbol v2

get
/v2/last/nbbo/{stocksTicker}

Get the most recent NBBO (Quote) tick for a given stock.

Parameters

The ticker symbol of the stock/equity.

https://api.polygon.io/v2/last/nbbo/{stocksTicker}?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


request_idstring

A request id assigned by the server.


resultsobject
Tstring

The exchange symbol that this item is traded under.


tinteger

The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this message from the exchange which produced it.


yinteger

The nanosecond accuracy Participant/Exchange Unix Timestamp. This is the timestamp of when the quote was actually generated at the exchange.


finteger

The nanosecond accuracy TRF(Trade Reporting Facility) Unix Timestamp. This is the timestamp of when the trade reporting facility received this message.


qinteger

The sequence number represents the sequence in which message events happened. These are increasing and unique per ticker symbol, but will not always be sequential (e.g., 1, 2, 6, 9, 10, 11).


carray [integer]

A list of condition codes.


iarray [integer]

The indicators. For more information, see our glossary of Conditions and Indicators.


pnumber

The bid price.


sinteger

The bid size. This represents the number of round lot orders at the given bid price. The normal round lot size is 100 shares. A bid size of 2 means there are 200 shares for purchase at the given bid price.


xinteger

Bid Exchange Id


Pnumber

The ask price.


Sinteger

The ask size. This represents the number of round lot orders at the given ask price. The normal round lot size is 100 shares. An ask size of 2 means there are 200 shares available to purchase at the given ask price.


Xinteger

Ask Exchange Id


zinteger

There are 3 tapes which define which exchange the ticker is listed on. These are integers in our objects which represent the letter of the alphabet. Eg: 1 = A, 2 = B, 3 = C.

  • Tape A is NYSE listed securities
  • Tape B is NYSE ARCA / NYSE American
  • Tape C is NASDAQ

Response Object

{
 "request_id": "b84e24636301f19f88e0dfbf9a45ed5c",
 "status": "OK",
 "results": {
  "P": 127.98,
  "S": 7,
  "T": "AAPL",
  "X": 19,
  "p": 127.96,
  "q": 83480742,
  "s": 1,
  "t": 1617827221349730300,
  "x": 11,
  "y": 1617827221349366000,
  "z": 3
 }
}

Daily Open/Close

get
/v1/open-close/{stocksTicker}/{date}

Get the open, close and afterhours prices of a stock symbol on a certain date.

Parameters

The ticker symbol of the stock/equity.

The date of the requested open/close in the format YYYY-MM-DD.

Whether or not the results are adjusted for splits. By default, results are adjusted. Set this to true to get results that are NOT adjusted for splits.

https://api.polygon.io/v1/open-close/{stocksTicker}/{date}?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


fromstring

The requested date.


symbolstring

The exchange symbol that this item is traded under.


opennumber

The open price for the symbol in the given time period.


highnumber

The highest price for the symbol in the given time period.


lownumber

The lowest price for the symbol in the given time period.


closenumber

The close price for the symbol in the given time period.


volumenumber

The trading volume of the symbol in the given time period.


preMarketinteger

The open price of the ticker symbol in pre-market trading.


afterHoursnumber

The close price of the ticker symbol in after hours trading.


Response Object

{
 "status": "OK",
 "from": "2020-10-14T00:00:00.000Z",
 "symbol": "AAPL",
 "open": 324.66,
 "high": 326.2,
 "low": 322.3,
 "close": 325.12,
 "volume": 26122646,
 "afterHours": 322.1,
 "preMarket": 324.5
}

Grouped Daily (Bars)

get
/v2/aggs/grouped/locale/us/market/stocks/{date}

Get the daily open, high, low, and close (OHLC) for the entire stocks/equities markets.

Parameters

The beginning date for the aggregate window.

Whether or not the results are adjusted for splits. By default, results are adjusted. Set this to true to get results that are NOT adjusted for splits.

https://api.polygon.io/v2/aggs/grouped/locale/us/market/stocks/{date}?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


adjustedboolean

Whether or not this response was adjusted for splits.


queryCountinteger

The number of aggregates (minute or day) used to generate the response.


resultsCountinteger

The total number of results for this request.


request_idstring

A request id assigned by the server.


resultsarray
Tstring

The exchange symbol that this item is traded under.


onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


nnumber

The number of transactions in the aggregate window.


Response Object

{
 "status": "OK",
 "queryCount": 3,
 "resultsCount": 3,
 "adjusted": true,
 "results": [
  {
   "T": "C:AUDCHF",
   "v": 160131,
   "o": 0.6618886,
   "c": 0.6619247,
   "h": 0.6643625,
   "l": 0.6596,
   "t": 1599796800000
  },
  {
   "T": "C:AUDCAD",
   "v": 92488,
   "o": 0.9584955,
   "c": 0.9598082,
   "h": 0.9620029,
   "l": 0.9575,
   "t": 1599796800000
  },
  {
   "T": "C:AUDBGN",
   "v": 87209,
   "o": 1.2023558,
   "c": 1.2009374,
   "h": 1.2055938,
   "l": 1.199437,
   "t": 1599796800000
  }
 ]
}

Previous Close

get
/v2/aggs/ticker/{stocksTicker}/prev

Get the previous day's open, high, low, and close (OHLC) for the specified stock ticker.

Parameters

The ticker symbol of the stock/equity.

Whether or not the results are adjusted for splits. By default, results are adjusted. Set this to true to get results that are NOT adjusted for splits.

https://api.polygon.io/v2/aggs/ticker/{stocksTicker}/prev?&apiKey=*

Response Attributes
tickerstring

The exchange symbol that this item is traded under.


statusstring

The status of this request's response.


adjustedboolean

Whether or not this response was adjusted for splits.


queryCountinteger

The number of aggregates (minute or day) used to generate the response.


resultsCountinteger

The total number of results for this request.


request_idstring

A request id assigned by the server.


resultsarray
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


nnumber

The number of transactions in the aggregate window.


Response Object

{
 "ticker": "AAPL",
 "status": "OK",
 "queryCount": 1,
 "resultsCount": 1,
 "adjusted": true,
 "results": [
  {
   "T": "AAPL",
   "v": 131704427,
   "vw": 116.3058,
   "o": 115.55,
   "c": 115.97,
   "h": 117.59,
   "l": 114.13,
   "t": 1605042000000
  }
 ],
 "request_id": "6a7e466379af0a71039d60cc78e72282"
}

Aggregates (Bars)

get
/v2/aggs/ticker/{stocksTicker}/range/{multiplier}/{timespan}/{from}/{to}

Get aggregate bars for a stock over a given date range in custom time window sizes.

For example, if timespan = ‘minute’ and multiplier = ‘5’ then 5-minute bars will be returned.

Parameters

The ticker symbol of the stock/equity.

The size of the timespan multiplier.

The size of the time window.

The start of the aggregate time window.

The end of the aggregate time window.

Whether or not the results are adjusted for splits. By default, results are adjusted. Set this to true to get results that are NOT adjusted for splits.

Sort the results by timestamp. asc will return results in ascending order (oldest at the top), desc will return results in descending order (newest at the top).

Limits the number of base aggregates queried to create the aggregate results. Max 50000 and Default 5000. Read more about how limit is used to calculate aggregate results in our article on Aggregate Data API Improvements.

https://api.polygon.io/v2/aggs/ticker/{stocksTicker}/range/{multiplier}/{timespan}/{from}/{to}?&apiKey=*

Response Attributes
tickerstring

The exchange symbol that this item is traded under.


statusstring

The status of this request's response.


adjustedboolean

Whether or not this response was adjusted for splits.


queryCountinteger

The number of aggregates (minute or day) used to generate the response.


resultsCountinteger

The total number of results for this request.


request_idstring

A request id assigned by the server.


resultsarray
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


nnumber

The number of transactions in the aggregate window.


Response Object

{
 "ticker": "AAPL",
 "status": "OK",
 "queryCount": 2,
 "resultsCount": 2,
 "adjusted": true,
 "results": [
  {
   "v": 135647456,
   "vw": 74.6099,
   "o": 74.06,
   "c": 75.0875,
   "h": 75.15,
   "l": 73.7975,
   "t": 1577941200000,
   "n": 1
  },
  {
   "v": 146535512,
   "vw": 74.7026,
   "o": 74.2875,
   "c": 74.3575,
   "h": 75.145,
   "l": 74.125,
   "t": 1578027600000,
   "n": 1
  }
 ],
 "request_id": "6a7e466379af0a71039d60cc78e72282"
}

Snapshot - All Tickers

get
/v2/snapshot/locale/us/markets/stocks/tickers

Get the current minute, day, and previous day’s aggregate, as well as the last trade and quote for all traded stock symbols.

Note: Snapshot data is cleared at 12am EST and gets populated as data is received from the exchanges. This can happen as early as 4am EST.

Parameters

A comma separated list of tickers to get snapshots for.

https://api.polygon.io/v2/snapshot/locale/us/markets/stocks/tickers?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


countinteger

The total number of results for this request.


tickersarray
dayobject
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


lastQuoteobject
pnumber

The bid price.


sinteger

The bid size in lots.


Pnumber

The ask price.


Sinteger

The ask size in lots.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


lastTradeobject
carray [string]

The trade conditions.


iinteger

The Trade ID which uniquely identifies a trade. These are unique per combination of ticker, exchange, and TRF. For example: A trade for AAPL executed on NYSE and a trade for AAPL executed on NASDAQ could potentially have the same Trade ID.


pnumber

The price of the trade. This is the actual dollar value per whole share of this trade. A trade of 100 shares with a price of $2.00 would be worth a total dollar value of $200.00.


sinteger

The size (volume) of the trade.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


xinteger

The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.


minobject

The last available minute bar.

avinteger

The accumulated volume.


onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


prevDayobject
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


tickerstring

The exchange symbol that this item is traded under.


todaysChangenumber

The value of the change the from previous day.


todaysChangePercnumber

The percentage change since the previous day.


updatedinteger

The last updated timestamp.


Response Object

{
 "status": "OK",
 "count": 1,
 "tickers": [
  {
   "day": {
    "c": 20.506,
    "h": 20.64,
    "l": 20.506,
    "o": 20.64,
    "v": 37216,
    "vw": 20.616
   },
   "lastQuote": {
    "P": 20.6,
    "S": 22,
    "p": 20.5,
    "s": 13,
    "t": 1605192959994246100
   },
   "lastTrade": {
    "c": [
     14,
     41
    ],
    "i": "71675577320245",
    "p": 20.506,
    "s": 2416,
    "t": 1605192894630916600,
    "x": 4
   },
   "min": {
    "av": 37216,
    "c": 20.506,
    "h": 20.506,
    "l": 20.506,
    "o": 20.506,
    "v": 5000,
    "vw": 20.5105
   },
   "prevDay": {
    "c": 20.63,
    "h": 21,
    "l": 20.5,
    "o": 20.79,
    "v": 292738,
    "vw": 20.6939
   },
   "ticker": "BCAT",
   "todaysChange": -0.124,
   "todaysChangePerc": -0.601,
   "updated": 1605192894630916600
  }
 ]
}

Snapshot - Ticker

get
/v2/snapshot/locale/us/markets/stocks/tickers/{stocksTicker}

Get the current minute, day, and previous day’s aggregate, as well as the last trade and quote for a single traded stock ticker.

Note: Snapshot data is cleared at 12am EST and gets populated as data is received from the exchanges. This can happen as early as 4am EST.

Parameters

The ticker symbol of the stock/equity.

https://api.polygon.io/v2/snapshot/locale/us/markets/stocks/tickers/{stocksTicker}?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


tickerobject
dayobject
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


lastQuoteobject
pnumber

The bid price.


sinteger

The bid size in lots.


Pnumber

The ask price.


Sinteger

The ask size in lots.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


lastTradeobject
carray [string]

The trade conditions.


iinteger

The Trade ID which uniquely identifies a trade. These are unique per combination of ticker, exchange, and TRF. For example: A trade for AAPL executed on NYSE and a trade for AAPL executed on NASDAQ could potentially have the same Trade ID.


pnumber

The price of the trade. This is the actual dollar value per whole share of this trade. A trade of 100 shares with a price of $2.00 would be worth a total dollar value of $200.00.


sinteger

The size (volume) of the trade.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


xinteger

The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.


minobject

The last available minute bar.

avinteger

The accumulated volume.


onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


prevDayobject
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


tickerstring

The exchange symbol that this item is traded under.


todaysChangenumber

The value of the change the from previous day.


todaysChangePercnumber

The percentage change since the previous day.


updatedinteger

The last updated timestamp.


Response Object

{
 "status": "OK",
 "ticker": {
  "day": {
   "c": 120.4229,
   "h": 120.53,
   "l": 118.81,
   "o": 119.62,
   "v": 28727868,
   "vw": 119.725
  },
  "lastQuote": {
   "P": 120.47,
   "S": 4,
   "p": 120.46,
   "s": 8,
   "t": 1605195918507251700
  },
  "lastTrade": {
   "c": [
    14,
    41
   ],
   "i": "4046",
   "p": 120.47,
   "s": 236,
   "t": 1605195918306274000,
   "x": 10
  },
  "min": {
   "av": 28724441,
   "c": 120.4201,
   "h": 120.468,
   "l": 120.37,
   "o": 120.435,
   "v": 270796,
   "vw": 120.4129
  },
  "prevDay": {
   "c": 119.49,
   "h": 119.63,
   "l": 116.44,
   "o": 117.19,
   "v": 110597265,
   "vw": 118.4998
  },
  "ticker": "AAPL",
  "todaysChange": 0.98,
  "todaysChangePerc": 0.82,
  "updated": 1605195918306274000
 }
}

Snapshot - Gainers/Losers

get
/v2/snapshot/locale/us/markets/stocks/{direction}

Get the current top 20 gainers or losers of the day in stocks/equities markets.

Top gainers are those tickers whose price has increased by the highest percentage since the previous day's close. Top losers are those tickers whose price has decreased by the highest percentage since the previous day's close.

Note: Snapshot data is cleared at 12am EST and gets populated as data is received from the exchanges.

Parameters

The direction of the snapshot results to return.

https://api.polygon.io/v2/snapshot/locale/us/markets/stocks/{direction}?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


tickersarray
dayobject
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


lastQuoteobject
pnumber

The bid price.


sinteger

The bid size in lots.


Pnumber

The ask price.


Sinteger

The ask size in lots.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


lastTradeobject
carray [string]

The trade conditions.


iinteger

The Trade ID which uniquely identifies a trade. These are unique per combination of ticker, exchange, and TRF. For example: A trade for AAPL executed on NYSE and a trade for AAPL executed on NASDAQ could potentially have the same Trade ID.


pnumber

The price of the trade. This is the actual dollar value per whole share of this trade. A trade of 100 shares with a price of $2.00 would be worth a total dollar value of $200.00.


sinteger

The size (volume) of the trade.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


xinteger

The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.


minobject

The last available minute bar.

avinteger

The accumulated volume.


onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


prevDayobject
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


tickerstring

The exchange symbol that this item is traded under.


todaysChangenumber

The value of the change the from previous day.


todaysChangePercnumber

The percentage change since the previous day.


updatedinteger

The last updated timestamp.


Response Object

{
 "status": "OK",
 "tickers": [
  {
   "day": {
    "c": 14.2284,
    "h": 15.09,
    "l": 14.2,
    "o": 14.33,
    "v": 133963,
    "vw": 14.5311
   },
   "lastQuote": {
    "P": 14.44,
    "S": 11,
    "p": 14.2,
    "s": 25,
    "t": 1605195929997325600
   },
   "lastTrade": {
    "c": [
     63
    ],
    "i": "79372124707124",
    "p": 14.2284,
    "s": 536,
    "t": 1605195848258266000,
    "x": 4
   },
   "min": {
    "av": 133963,
    "c": 14.2284,
    "h": 14.325,
    "l": 14.2,
    "o": 14.28,
    "v": 6108,
    "vw": 14.2426
   },
   "prevDay": {
    "c": 0.73,
    "h": 0.799,
    "l": 0.73,
    "o": 0.75,
    "v": 1568097,
    "vw": 0.7721
   },
   "ticker": "PDS",
   "todaysChange": 13.498,
   "todaysChangePerc": 1849.096,
   "updated": 1605195848258266000
  }
 ]
}

Historic Forex Ticks

get
/v1/historic/forex/{from}/{to}/{date}

Get historic ticks for a forex currency pair.

Parameters

The "from" symbol of the currency pair.

Example: For USD/JPY the from would be USD.

The "to" symbol of the currency pair.

Example: For USD/JPY the to would be JPY.

The date/day of the historic ticks to retrieve.

The timestamp offset, used for pagination. This is the offset at which to start the results. Using the timestamp of the last result as the offset will give you the next page of results.

Limit the size of the response, max 10000.

https://api.polygon.io/v1/historic/forex/{from}/{to}/{date}?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


daystring

The date that was evaluated from the request.


mapobject

A map for shortened result keys.

msLatencyinteger

The milliseconds of latency for the query results.


pairstring

The currency pair that was evaluated from the request.


ticksarray
anumber

The ask price.


bnumber

The bid price.


xinteger

The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


Response Object

{
 "day": "2020-10-14",
 "map": {
  "ap": "ask",
  "bp": "bid",
  "t": "timestamp"
 },
 "msLatency": "0",
 "pair": "AUD/USD",
 "status": "success",
 "ticks": [
  {
   "x": 48,
   "ap": 0.71703,
   "bp": 0.71701,
   "t": 1602633600000
  },
  {
   "x": 48,
   "ap": 0.71703,
   "bp": 0.717,
   "t": 1602633600000
  },
  {
   "x": 48,
   "ap": 0.71702,
   "bp": 0.717,
   "t": 1602633600000
  }
 ],
 "type": "forex"
}

Real-time Currency Conversion

get
/v1/conversion/{from}/{to}

Get currency conversions using the latest market conversion rates. Note than you can convert in both directions. For example USD to CAD or CAD to USD.

Parameters

The "from" symbol of the pair.

The "to" symbol of the pair.

The amount to convert, with a decimal.

The decimal precision of the conversion. Defaults to 2 which is 2 decimal places accuracy.

https://api.polygon.io/v1/conversion/{from}/{to}?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


lastobject
asknumber

The ask price.


bidnumber

The bid price.


exchangeinteger

The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.


timestampinteger

The Unix Msec timestamp for the start of the aggregate window.


fromstring

The "from" currency symbol.


tostring

The "to" currency symbol.


initialAmountnumber

The amount to convert.


convertednumber

The result of the conversion.


Response Object

{
 "status": "success",
 "last": {
  "bid": 1.3672596,
  "ask": 1.3673344,
  "exchange": 48,
  "timestamp": 1605555313000
 },
 "from": "AUD",
 "to": "USD",
 "initialAmount": 100,
 "converted": 73.14
}

Last Quote for a Currency Pair

get
/v1/last_quote/currencies/{from}/{to}

Get the last quote tick for a forex currency pair.

Parameters

The "from" symbol of the pair.

The "to" symbol of the pair.

https://api.polygon.io/v1/last_quote/currencies/{from}/{to}?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


request_idstring

A request id assigned by the server.


lastobject
asknumber

The ask price.


bidnumber

The bid price.


exchangeinteger

The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.


timestampinteger

The Unix Msec timestamp for the start of the aggregate window.


symbolstring

The symbol pair that was evaluated from the request.


Response Object

{
 "last": {
  "ask": 0.73124,
  "bid": 0.73122,
  "exchange": 48,
  "timestamp": 1605557756000
 },
 "request_id": "a73a29dbcab4613eeaf48583d3baacf0",
 "status": "success",
 "symbol": "AUD/USD"
}

Grouped Daily (Bars)

get
/v2/aggs/grouped/locale/global/market/fx/{date}

Get the daily open, high, low, and close (OHLC) for the entire forex markets.

Parameters

The beginning date for the aggregate window.

Whether or not the results are adjusted for splits. By default, results are adjusted. Set this to true to get results that are NOT adjusted for splits.

https://api.polygon.io/v2/aggs/grouped/locale/global/market/fx/{date}?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


adjustedboolean

Whether or not this response was adjusted for splits.


queryCountinteger

The number of aggregates (minute or day) used to generate the response.


resultsCountinteger

The total number of results for this request.


request_idstring

A request id assigned by the server.


resultsarray
Tstring

The exchange symbol that this item is traded under.


onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


Response Object

{
 "status": "OK",
 "queryCount": 3,
 "resultsCount": 3,
 "adjusted": true,
 "results": [
  {
   "T": "C:CZKMXN",
   "v": 29035,
   "o": 0.98688,
   "c": 0.97531,
   "h": 0.9884522,
   "l": 0.97468,
   "t": 1599019200000
  },
  {
   "T": "C:GBPCAD",
   "v": 174749,
   "o": 1.74807,
   "c": 1.74102,
   "h": 1.748579,
   "l": 1.73482,
   "t": 1599019200000
  },
  {
   "T": "C:DKKAUD",
   "v": 97005,
   "o": 0.217479,
   "c": 0.217072,
   "h": 0.2176943,
   "l": 0.2166342,
   "t": 1599019200000
  }
 ]
}

Previous Close

get
/v2/aggs/ticker/{forexTicker}/prev

Get the previous day's open, high, low, and close (OHLC) for the specified forex pair.

Parameters

The ticker symbol of the currency pair.

Whether or not the results are adjusted for splits. By default, results are adjusted. Set this to true to get results that are NOT adjusted for splits.

https://api.polygon.io/v2/aggs/ticker/{forexTicker}/prev?&apiKey=*

Response Attributes
tickerstring

The exchange symbol that this item is traded under.


statusstring

The status of this request's response.


adjustedboolean

Whether or not this response was adjusted for splits.


queryCountinteger

The number of aggregates (minute or day) used to generate the response.


resultsCountinteger

The total number of results for this request.


request_idstring

A request id assigned by the server.


resultsarray
Tstring

The exchange symbol that this item is traded under.


vnumber

The trading volume of the symbol in the given time period.


onumber

The open price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


Response Object

{
 "ticker": "C:EURUSD",
 "status": "OK",
 "queryCount": 1,
 "resultsCount": 1,
 "adjusted": true,
 "results": [
  {
   "T": "C:EURUSD",
   "v": 14500,
   "o": 1.18421,
   "c": 1.18522,
   "h": 1.18545,
   "l": 1.18341,
   "t": 1605416400000
  }
 ]
}

Aggregates (Bars)

get
/v2/aggs/ticker/{forexTicker}/range/{multiplier}/{timespan}/{from}/{to}

Get aggregate bars for a forex pair over a given date range in custom time window sizes.

For example, if timespan = ‘minute’ and multiplier = ‘5’ then 5-minute bars will be returned.

Parameters

The ticker symbol of the currency pair.

The size of the timespan multiplier.

The size of the time window.

The start of the aggregate time window.

The end of the aggregate time window.

Whether or not the results are adjusted for splits. By default, results are adjusted. Set this to true to get results that are NOT adjusted for splits.

Sort the results by timestamp. asc will return results in ascending order (oldest at the top), desc will return results in descending order (newest at the top).

Limits the number of base aggregates queried to create the aggregate results. Max 50000 and Default 5000. Read more about how limit is used to calculate aggregate results in our article on Aggregate Data API Improvements.

https://api.polygon.io/v2/aggs/ticker/{forexTicker}/range/{multiplier}/{timespan}/{from}/{to}?&apiKey=*

Response Attributes
tickerstring

The exchange symbol that this item is traded under.


statusstring

The status of this request's response.


adjustedboolean

Whether or not this response was adjusted for splits.


queryCountinteger

The number of aggregates (minute or day) used to generate the response.


resultsCountinteger

The total number of results for this request.


request_idstring

A request id assigned by the server.


resultsarray
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


nnumber

The number of transactions in the aggregate window.


Response Object

{
 "ticker": "C:EURUSD",
 "status": "OK",
 "queryCount": 2,
 "resultsCount": 2,
 "adjusted": true,
 "results": [
  {
   "v": 126690,
   "o": 1.11327,
   "c": 1.1126,
   "h": 1.11536,
   "l": 1.1099,
   "t": 1590984000000,
   "n": 1
  },
  {
   "v": 155844,
   "o": 1.11269,
   "c": 1.12084,
   "h": 1.12111,
   "l": 1.1114,
   "t": 1591070400000,
   "n": 1
  }
 ],
 "request_id": "bb8fedcdc2e6237fc61f32024602593b"
}

Snapshot - Ticker

get
/v2/snapshot/locale/global/markets/forex/tickers/{ticker}

Get the current minute, day, and previous day’s aggregate, as well as the last trade and quote for a single traded currency symbol.

Note: Snapshot data is cleared at 12am EST and gets populated as data is received from the exchanges.

Parameters

The forex ticker.

https://api.polygon.io/v2/snapshot/locale/global/markets/forex/tickers/{ticker}?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


request_idstring

A request id assigned by the server.


tickerobject
dayobject
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


lastQuoteobject
anumber

The ask price.


bnumber

The bid price.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


xinteger

The exchange ID on which this quote happened.


minobject

The last available minute bar.

onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


prevDayobject
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


tickerstring

The exchange symbol that this item is traded under.


todaysChangenumber

The value of the change the from previous day.


todaysChangePercnumber

The percentage change since the previous day.


updatedinteger

The last updated timestamp.


Response Object

{
 "request_id": "ad76e76ce183002c5937a7f02dfebde4",
 "status": "OK",
 "ticker": {
  "day": {
   "c": 1.18403,
   "h": 1.1906,
   "l": 1.18001,
   "o": 1.18725,
   "v": 83578
  },
  "lastQuote": {
   "a": 1.18403,
   "b": 1.18398,
   "i": 0,
   "t": 1606163759000,
   "x": 48
  },
  "min": {
   "c": 1.18396,
   "h": 1.18423,
   "l": 1.1838,
   "o": 1.18404,
   "v": 41
  },
  "prevDay": {
   "c": 1.18724,
   "h": 1.18727,
   "l": 1.18725,
   "o": 1.18725,
   "v": 5,
   "vw": 0
  },
  "ticker": "C:EURUSD",
  "todaysChange": -0.00316,
  "todaysChangePerc": -0.27458312,
  "updated": 1606163759000
 }
}

Snapshot - All Tickers

get
/v2/snapshot/locale/global/markets/forex/tickers

Get the current minute, day, and previous day’s aggregate, as well as the last trade and quote for all traded forex symbols.

Note: Snapshot data is cleared at 12am EST and gets populated as data is received from the exchanges. This can happen as early as 4am EST.

Parameters

A comma separated list of tickers to get snapshots for.

https://api.polygon.io/v2/snapshot/locale/global/markets/forex/tickers?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


tickersarray
dayobject
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


lastQuoteobject
anumber

The ask price.


bnumber

The bid price.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


xinteger

The exchange ID on which this quote happened.


minobject

The last available minute bar.

onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


prevDayobject
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


tickerstring

The exchange symbol that this item is traded under.


todaysChangenumber

The value of the change the from previous day.


todaysChangePercnumber

The percentage change since the previous day.


updatedinteger

The last updated timestamp.


Response Object

{
 "status": "OK",
 "tickers": [
  {
   "day": {
    "c": 0.11778221,
    "h": 0.11812263,
    "l": 0.11766631,
    "o": 0.11797149,
    "v": 77794
   },
   "lastQuote": {
    "a": 0.11780678,
    "b": 0.11777952,
    "t": 1605280919000,
    "x": 48
   },
   "min": {
    "c": 0.117769,
    "h": 0.11779633,
    "l": 0.11773698,
    "o": 0.11778,
    "v": 202
   },
   "prevDay": {
    "c": 0.11797258,
    "h": 0.11797258,
    "l": 0.11797149,
    "o": 0.11797149,
    "v": 2,
    "vw": 0
   },
   "ticker": "C:HKDCHF",
   "todaysChange": -0.00019306,
   "todaysChangePerc": -0.1636482,
   "updated": 1605280919000
  }
 ]
}

Snapshot - Gainers/Losers

get
/v2/snapshot/locale/global/markets/forex/{direction}

Get the current top 20 gainers or losers of the day in forex markets.

Top gainers are those tickers whose price has increased by the highest percentage since the previous day's close. Top losers are those tickers whose price has decreased by the highest percentage since the previous day's close.

Note: Snapshot data is cleared at 12am EST and gets populated as data is received from the exchanges.

Parameters

The direction of the snapshot results to return.

https://api.polygon.io/v2/snapshot/locale/global/markets/forex/{direction}?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


tickersarray
dayobject
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


lastQuoteobject
anumber

The ask price.


bnumber

The bid price.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


xinteger

The exchange ID on which this quote happened.


minobject

The last available minute bar.

onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


prevDayobject
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


tickerstring

The exchange symbol that this item is traded under.


todaysChangenumber

The value of the change the from previous day.


todaysChangePercnumber

The percentage change since the previous day.


updatedinteger

The last updated timestamp.


Response Object

{
 "status": "OK",
 "tickers": [
  {
   "day": {
    "c": 0.886156,
    "h": 0.887111,
    "l": 0.8825327,
    "o": 0.8844732,
    "v": 1041
   },
   "lastQuote": {
    "a": 0.8879606,
    "b": 0.886156,
    "t": 1605283204000,
    "x": 48
   },
   "min": {
    "c": 0.886156,
    "h": 0.886156,
    "l": 0.886156,
    "o": 0.886156,
    "v": 1
   },
   "prevDay": {
    "c": 0.8428527,
    "h": 0.889773,
    "l": 0.8428527,
    "o": 0.8848539,
    "v": 1078,
    "vw": 0
   },
   "ticker": "C:PLNILS",
   "todaysChange": 0.0433033,
   "todaysChangePerc": 5.13770674,
   "updated": 1605330008999
  }
 ]
}

Last Trade for a Crypto Pair

get
/v1/last/crypto/{from}/{to}

Get the last trade tick for a cryptocurrency pair.

Parameters

The "from" symbol of the pair.

The "to" symbol of the pair.

https://api.polygon.io/v1/last/crypto/{from}/{to}?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


request_idstring

A request id assigned by the server.


lastobject
conditionsarray [integer]

A list of condition codes.


exchangeinteger

The exchange that this crypto trade happened on.
See Crypto Exchanges for a mapping of exchanges to IDs.


pricenumber

The price of the trade. This is the actual dollar value per whole share of this trade. A trade of 100 shares with a price of $2.00 would be worth a total dollar value of $200.00.


sizenumber

The size of a trade (also known as volume).


timestampinteger

The Unix Msec timestamp for the start of the aggregate window.


symbolstring

The symbol pair that was evaluated from the request.


Response Object

{
 "last": {
  "conditions": [
   1
  ],
  "exchange": 4,
  "price": 16835.42,
  "size": 0.006909,
  "timestamp": 1605560885027
 },
 "request_id": "d2d779df015fe2b7fbb8e58366610ef7",
 "status": "success",
 "symbol": "BTC-USD"
}

Daily Open/Close

get
/v1/open-close/crypto/{from}/{to}/{date}

Get the open, close prices of a cryptocurrency symbol on a certain day.

Parameters

The "from" symbol of the pair.

The "to" symbol of the pair.

The date of the requested open/close in the format YYYY-MM-DD.

Whether or not the results are adjusted for splits. By default, results are adjusted. Set this to true to get results that are NOT adjusted for splits.

https://api.polygon.io/v1/open-close/crypto/{from}/{to}/{date}?&apiKey=*

Response Attributes
symbolstring

The symbol pair that was evaluated from the request.


isUTCboolean

Whether or not the timestamps are in UTC timezone.


daystring

The date requested.


opennumber

The open price for the symbol in the given time period.


closenumber

The close price for the symbol in the given time period.


openTradesarray
pnumber

The price of the trade. This is the actual dollar value per whole share of this trade. A trade of 100 shares with a price of $2.00 would be worth a total dollar value of $200.00.


snumber

The size of a trade (also known as volume).


xinteger

The exchange that this crypto trade happened on.
See Crypto Exchanges for a mapping of exchanges to IDs.


carray [integer]

A list of condition codes.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


closingTradesarray
pnumber

The price of the trade. This is the actual dollar value per whole share of this trade. A trade of 100 shares with a price of $2.00 would be worth a total dollar value of $200.00.


snumber

The size of a trade (also known as volume).


xinteger

The exchange that this crypto trade happened on.
See Crypto Exchanges for a mapping of exchanges to IDs.


carray [integer]

A list of condition codes.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


Response Object

{
 "symbol": "BTC-USD",
 "isUTC": true,
 "day": "2020-10-09T00:00:00.000Z",
 "open": 10932.44,
 "close": 11050.64,
 "openTrades": [
  {
   "s": 0.002,
   "p": 10932.44,
   "x": 1,
   "t": 1602201600056,
   "c": [
    2
   ]
  },
  {
   "s": 0.02,
   "p": 10923.76,
   "x": 4,
   "t": 1602201600141,
   "c": [
    2
   ]
  }
 ],
 "closingTrades": [
  {
   "s": 0.006128,
   "p": 11050.64,
   "x": 4,
   "t": 1602287999795,
   "c": [
    2
   ]
  },
  {
   "s": 0.014,
   "p": 11049.4,
   "x": 17,
   "t": 1602287999659,
   "c": [
    1
   ]
  }
 ]
}

Historic Crypto Trades

get
/v1/historic/crypto/{from}/{to}/{date}

Get historic trade ticks for a cryptocurrency pair.

Parameters

The "from" symbol of the crypto pair.

The "to" symbol of the crypto pair.

The date/day of the historic ticks to retrieve.

The timestamp offset, used for pagination. This is the offset at which to start the results. Using the timestamp of the last result as the offset will give you the next page of results.

Limit the size of the response, max 10000.

https://api.polygon.io/v1/historic/crypto/{from}/{to}/{date}?&apiKey=*

Response Attributes
daystring

The date that was evaluated from the request.


mapobject

A map for shortened result keys.

msLatencyinteger

The milliseconds of latency for the query results.


symbolstring

The symbol pair that was evaluated from the request.


ticksarray
pnumber

The price of the trade. This is the actual dollar value per whole share of this trade. A trade of 100 shares with a price of $2.00 would be worth a total dollar value of $200.00.


snumber

The size of a trade (also known as volume).


xinteger

The exchange that this crypto trade happened on.
See Crypto Exchanges for a mapping of exchanges to IDs.


carray [integer]

A list of condition codes.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


Response Object

{
 "day": "2020-10-14T00:00:00.000Z",
 "map": {
  "c": "conditions",
  "p": "price",
  "s": "size",
  "t": "timestamp",
  "x": "exchange"
 },
 "msLatency": 1,
 "status": "success",
 "symbol": "BTC-USD",
 "ticks": [
  {
   "s": 0.00188217,
   "p": 15482.89,
   "x": 1,
   "t": 1604880000067,
   "c": [
    2
   ]
  },
  {
   "s": 0.00161739,
   "p": 15482.11,
   "x": 1,
   "t": 1604880000167,
   "c": [
    2
   ]
  }
 ],
 "type": "crypto"
}

Grouped Daily (Bars)

get
/v2/aggs/grouped/locale/global/market/crypto/{date}

Get the daily open, high, low, and close (OHLC) for the entire cryptocurrency markets.

Parameters

The beginning date for the aggregate window.

Whether or not the results are adjusted for splits. By default, results are adjusted. Set this to true to get results that are NOT adjusted for splits.

https://api.polygon.io/v2/aggs/grouped/locale/global/market/crypto/{date}?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


adjustedboolean

Whether or not this response was adjusted for splits.


queryCountinteger

The number of aggregates (minute or day) used to generate the response.


resultsCountinteger

The total number of results for this request.


request_idstring

A request id assigned by the server.


resultsarray
Tstring

The exchange symbol that this item is traded under.


onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


Response Object

{
 "status": "OK",
 "queryCount": 3,
 "resultsCount": 3,
 "adjusted": true,
 "results": [
  {
   "T": "X:ARDRUSD",
   "v": 2,
   "vw": 0.0551,
   "o": 0.0550762,
   "c": 0.0550762,
   "h": 0.0550762,
   "l": 0.0550762,
   "t": 1580676480000
  },
  {
   "T": "X:NGCUSD",
   "v": 4734,
   "vw": 0.0273,
   "o": 0.0273733,
   "c": 0.0272983,
   "h": 0.0273733,
   "l": 0.0272983,
   "t": 1580674080000
  },
  {
   "T": "X:ZSCUSD",
   "v": 390,
   "vw": 0.0003,
   "o": 0.00028531,
   "c": 0.00028531,
   "h": 0.00028531,
   "l": 0.00028531,
   "t": 1580671080000
  }
 ]
}

Previous Close

get
/v2/aggs/ticker/{cryptoTicker}/prev

Get the previous day's open, high, low, and close (OHLC) for the specified cryptocurrency pair.

Parameters

The ticker symbol of the currency pair.

Whether or not the results are adjusted for splits. By default, results are adjusted. Set this to true to get results that are NOT adjusted for splits.

https://api.polygon.io/v2/aggs/ticker/{cryptoTicker}/prev?&apiKey=*

Response Attributes
tickerstring

The exchange symbol that this item is traded under.


statusstring

The status of this request's response.


adjustedboolean

Whether or not this response was adjusted for splits.


queryCountinteger

The number of aggregates (minute or day) used to generate the response.


resultsCountinteger

The total number of results for this request.


request_idstring

A request id assigned by the server.


resultsarray
Tstring

The exchange symbol that this item is traded under.


onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


Response Object

{
 "ticker": "X:BTCUSD",
 "status": "OK",
 "queryCount": 1,
 "resultsCount": 1,
 "adjusted": true,
 "results": [
  {
   "T": "X:BTCUSD",
   "v": 95045.16897951,
   "vw": 15954.2111,
   "o": 15937.1,
   "c": 16035.9,
   "h": 16180,
   "l": 15639.2,
   "t": 1605416400000
  }
 ]
}

Aggregates (Bars)

get
/v2/aggs/ticker/{cryptoTicker}/range/{multiplier}/{timespan}/{from}/{to}

Get aggregate bars for a cryptocurrency pair over a given date range in custom time window sizes.

For example, if timespan = ‘minute’ and multiplier = ‘5’ then 5-minute bars will be returned.

Parameters

The ticker symbol of the currency pair.

The size of the timespan multiplier.

The size of the time window.

The start of the aggregate time window.

The end of the aggregate time window.

Whether or not the results are adjusted for splits. By default, results are adjusted. Set this to true to get results that are NOT adjusted for splits.

Sort the results by timestamp. asc will return results in ascending order (oldest at the top), desc will return results in descending order (newest at the top).

Limits the number of base aggregates queried to create the aggregate results. Max 50000 and Default 5000. Read more about how limit is used to calculate aggregate results in our article on Aggregate Data API Improvements.

https://api.polygon.io/v2/aggs/ticker/{cryptoTicker}/range/{multiplier}/{timespan}/{from}/{to}?&apiKey=*

Response Attributes
tickerstring

The exchange symbol that this item is traded under.


statusstring

The status of this request's response.


adjustedboolean

Whether or not this response was adjusted for splits.


queryCountinteger

The number of aggregates (minute or day) used to generate the response.


resultsCountinteger

The total number of results for this request.


request_idstring

A request id assigned by the server.


resultsarray
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


nnumber

The number of transactions in the aggregate window.


Response Object

{
 "ticker": "X:BTCUSD",
 "status": "OK",
 "queryCount": 2,
 "resultsCount": 2,
 "adjusted": true,
 "results": [
  {
   "v": 303067.6562332156,
   "vw": 9874.5529,
   "o": 9557.9,
   "c": 10094.75,
   "h": 10429.26,
   "l": 9490,
   "t": 1590984000000,
   "n": 1
  },
  {
   "v": 323339.6922892879,
   "vw": 9729.5701,
   "o": 10096.87,
   "c": 9492.62,
   "h": 10222.72,
   "l": 9135.68,
   "t": 1591070400000,
   "n": 1
  }
 ],
 "request_id": "0cf72b6da685bcd386548ffe2895904a"
}

Snapshot - All Tickers

get
/v2/snapshot/locale/global/markets/crypto/tickers

Get the current minute, day, and previous day’s aggregate, as well as the last trade and quote for all traded cryptocurrency symbols.

Note: Snapshot data is cleared at 12am EST and gets populated as data is received from the exchanges. This can happen as early as 4am EST.

Parameters

A comma separated list of tickers to get snapshots for.

https://api.polygon.io/v2/snapshot/locale/global/markets/crypto/tickers?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


tickersarray
dayobject
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


lastTradeobject
carray [string]

The trade conditions.


iinteger

The Trade ID which uniquely identifies a trade. These are unique per combination of ticker, exchange, and TRF. For example: A trade for AAPL executed on NYSE and a trade for AAPL executed on NASDAQ could potentially have the same Trade ID.


pnumber

The price of the trade. This is the actual dollar value per whole share of this trade. A trade of 100 shares with a price of $2.00 would be worth a total dollar value of $200.00.


sinteger

The size (volume) of the trade.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


xinteger

The exchange that this crypto trade happened on.
See Crypto Exchanges for a mapping of exchanges to IDs.


minobject

The last available minute bar.

onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


prevDayobject
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


tickerstring

The exchange symbol that this item is traded under.


todaysChangenumber

The value of the change the from previous day.


todaysChangePercnumber

The percentage change since the previous day.


updatedinteger

The last updated timestamp.


Response Object

{
 "status": "OK",
 "tickers": [
  {
   "day": {
    "c": 0.296,
    "h": 0.59714,
    "l": 0.23706,
    "o": 0.28,
    "v": 4097699.5691991993,
    "vw": 0
   },
   "lastTrade": {
    "c": [
     1
    ],
    "i": 413131,
    "p": 0.293,
    "s": 13.6191,
    "t": 1605292686010,
    "x": 17
   },
   "min": {
    "c": 0.296,
    "h": 0.296,
    "l": 0.294,
    "o": 0.296,
    "v": 123.4866,
    "vw": 0
   },
   "prevDay": {
    "c": 0.281,
    "h": 0.59714,
    "l": 0.23706,
    "o": 0.27,
    "v": 6070178.786154971,
    "vw": 0.4076
   },
   "ticker": "X:FSNUSD",
   "todaysChange": 0.012,
   "todaysChangePerc": 4.270463,
   "updated": 1605330008999
  }
 ]
}

Snapshot - Ticker

get
/v2/snapshot/locale/global/markets/crypto/tickers/{ticker}

Get the current minute, day, and previous day’s aggregate, as well as the last trade and quote for a single traded cryptocurrency symbol.

Note: Snapshot data is cleared at 12am EST and gets populated as data is received from the exchanges.

Parameters

Ticker of the snapshot

https://api.polygon.io/v2/snapshot/locale/global/markets/crypto/tickers/{ticker}?&apiKey=*

Response Attributes
statusstring

The status of this request's response.


request_idstring

A request id assigned by the server.


tickerobject
dayobject
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


lastTradeobject
carray [string]

The trade conditions.


iinteger

The Trade ID which uniquely identifies a trade. These are unique per combination of ticker, exchange, and TRF. For example: A trade for AAPL executed on NYSE and a trade for AAPL executed on NASDAQ could potentially have the same Trade ID.


pnumber

The price of the trade. This is the actual dollar value per whole share of this trade. A trade of 100 shares with a price of $2.00 would be worth a total dollar value of $200.00.


sinteger

The size (volume) of the trade.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


xinteger

The exchange that this crypto trade happened on.
See Crypto Exchanges for a mapping of exchanges to IDs.


minobject

The last available minute bar.

onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


prevDayobject
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


tickerstring

The exchange symbol that this item is traded under.


todaysChangenumber

The value of the change the from previous day.


todaysChangePercnumber

The percentage change since the previous day.


updatedinteger

The last updated timestamp.


Response Object

{
 "request_id": "ad92e92ce183112c593717f00dfebd2c",
 "status": "OK",
 "ticker": {
  "day": {
   "c": 16260.85,
   "h": 16428.4,
   "l": 15830.4,
   "o": 16418.07,
   "v": 105008.84231068,
   "vw": 0
  },
  "lastTrade": {
   "c": [
    2
   ],
   "i": "464569520",
   "p": 16242.31,
   "s": 0.001933,
   "t": 1605294230780,
   "x": 4
  },
  "min": {
   "c": 16235.1,
   "h": 16264.29,
   "l": 16129.3,
   "o": 16257.51,
   "v": 19.30791925,
   "vw": 0
  },
  "prevDay": {
   "c": 16399.24,
   "h": 16418.07,
   "l": 16399.24,
   "o": 16418.07,
   "v": 0.99167108,
   "vw": 16402.6893
  },
  "ticker": "X:BTCUSD",
  "todaysChange": -156.93,
  "todaysChangePerc": -0.956935,
  "updated": 1605330008999
 }
}

Snapshot - Ticker Full Book (L2)

get
/v2/snapshot/locale/global/markets/crypto/tickers/{ticker}/book

Get the current level 2 book of a single ticker. This is the combined book from all of the exchanges.

Note: Snapshot data is cleared at 12am EST and gets populated as data is received from the exchanges.

Parameters

The cryptocurrency ticker.

https://api.polygon.io/v2/snapshot/locale/global/markets/crypto/tickers/{ticker}/book?&apiKey=*

Response Attributes
tickerstring

The exchange symbol that this item is traded under.


bidsarray
pnumber

The price of this book level.


xobject

A map of the exchange ID to number of shares at this price level.

Example:
{ "p": 16302.94, "x": { "1": 0.02859424, "6": 0.023455 } }

In this example, exchange ID 1 has 0.02859424 shares available at $16,302.94, and exchange ID 6 has 0.023455 shares at the same price level.

asksarray
pnumber

The price of this book level.


xobject

A map of the exchange ID to number of shares at this price level.

Example:
{ "p": 16302.94, "x": { "1": 0.02859424, "6": 0.023455 } }

In this example, exchange ID 1 has 0.02859424 shares available at $16,302.94, and exchange ID 6 has 0.023455 shares at the same price level.

bidCountnumber

The combined total number of bids in the book.


askCountnumber

The combined total number of asks in the book.


spreadnumber

The difference between the best bid and the best ask price accross exchanges.


updatedinteger

The last updated timestamp.


Response Object

{
 "status": "OK",
 "data": {
  "ticker": "X:BTCUSD",
  "bids": [
   {
    "p": 16303.17,
    "x": {
     "1": 2
    }
   },
   {
    "p": 16302.94,
    "x": {
     "1": 0.02859424,
     "6": 0.023455
    }
   }
  ],
  "asks": [
   {
    "p": 11454,
    "x": {
     "2": 1
    }
   },
   {
    "p": 11455,
    "x": {
     "2": 1
    }
   }
  ],
  "bidCount": 694.951789670001,
  "askCount": 593.1412981600005,
  "spread": -4849.17,
  "updated": 1605295074162
 }
}

Snapshot - Gainers/Losers

get
/v2/snapshot/locale/global/markets/crypto/{direction}

Get the current top 20 gainers or losers of the day in cryptocurrency markets.

Top gainers are those tickers whose price has increased by the highest percentage since the previous day's close. Top losers are those tickers whose price has decreased by the highest percentage since the previous day's close.

Note: Snapshot data is cleared at 12am EST and gets populated as data is received from the exchanges.

Parameters

The direction of the snapshot results to return.

https://api.polygon.io/v2/snapshot/locale/global/markets/crypto/{direction}?&apiKey=*

Response Attributes
tickersarray
dayobject
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


lastTradeobject
carray [string]

The trade conditions.


iinteger

The Trade ID which uniquely identifies a trade. These are unique per combination of ticker, exchange, and TRF. For example: A trade for AAPL executed on NYSE and a trade for AAPL executed on NASDAQ could potentially have the same Trade ID.


pnumber

The price of the trade. This is the actual dollar value per whole share of this trade. A trade of 100 shares with a price of $2.00 would be worth a total dollar value of $200.00.


sinteger

The size (volume) of the trade.


tinteger

The Unix Msec timestamp for the start of the aggregate window.


xinteger

The exchange that this crypto trade happened on.
See Crypto Exchanges for a mapping of exchanges to IDs.


minobject

The last available minute bar.

onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


prevDayobject
onumber

The open price for the symbol in the given time period.


hnumber

The highest price for the symbol in the given time period.


lnumber

The lowest price for the symbol in the given time period.


cnumber

The close price for the symbol in the given time period.


vnumber

The trading volume of the symbol in the given time period.


vwnumber

The volume weighted average price.


tickerstring

The exchange symbol that this item is traded under.


todaysChangenumber

The value of the change the from previous day.


todaysChangePercnumber

The percentage change since the previous day.


updatedinteger

The last updated timestamp.


Response Object

{
 "status": "OK",
 "tickers": [
  {
   "day": {
    "c": 0.0374,
    "h": 0.062377,
    "l": 0.01162,
    "o": 0.044834,
    "v": 27313165.159427017,
    "vw": 0
   },
   "lastTrade": {
    "c": [
     2
    ],
    "i": "517478762",
    "p": 0.0374,
    "s": 499,
    "t": 1604409649544,
    "x": 2
   },
   "min": {
    "c": 0.062377,
    "h": 0.062377,
    "l": 0.062377,
    "o": 0.062377,
    "v": 35420,
    "vw": 0
   },
   "prevDay": {
    "c": 0.01162,
    "h": 0.044834,
    "l": 0.01162,
    "o": 0.044834,
    "v": 53616273.36827199,
    "vw": 0.0296
   },
   "ticker": "X:DRNUSD",
   "todaysChange": 0.02578,
   "todaysChangePerc": 221.858864,
   "updated": 1605330008999
  }
 ]
}