Introducing

New Metadata APIs

Apr 17, 2018

We have been working hard to add new meta data APIs. These are APIs around symbols like:

  • Dividends
  • Stock Splits
  • Company Details
  • News
  • Earnings

There are also new APIs to help with mappings. For example there are APIs to list all exchanges and their IDs, stock symbol types, etc.

Here are some examples for AAPL ( Apple Inc )

Company Details:

{
  "_id": "5a77fa94333c4e001174b8a4",
  "listdate": "1990-01-02",
  "cik": "0000320193",
  "bloomberg": "EQ0010169500001000",
  "figi": null,
  "lei": "HWUPKR0MPOU8FGXBT394",
  "sic": 3571,
  "country": "us",
  "industry": "Computer Hardware",
  "sector": "Technology",
  "marketcap": 886582291490,
  "employees": 116000,
  "phone": "(408) 996-1010",
  "ceo": "Tim Cook",
  "url": "http://www.apple.com",
  "description": "Apple Inc. designs, manufactures, and markets mobile communication and media devices, personal computers, and portable digital music players to consumers, small and mid-sized businesses, and education, enterprise, and government customers worldwide. The company also sells related software, services, accessories, networking solutions, and third-party digital content and applications. It offers iPhone, a line of smartphones; iPad, a line of multi-purpose tablets; and Mac, a line of desktop and portable personal computers. The company also provides iLife, a consumer-oriented digital lifestyle software application suite; iWork, an integrated productivity suite that helps users create, present, and publish documents, presentations, and spreadsheets; and other application software, such as Final Cut Pro, Logic Pro X, and FileMaker Pro. In addition, it offers Apple TV that connects to consumers' TV and enables them to access digital content directly for streaming high definition video, playing music and games, and viewing photos; Apple Watch, a personal electronic device; and iPod, a line of portable digital music and media players. Further, the company sells Apple-branded and third-party Mac-compatible, and iOS-compatible accessories, such as headphones, displays, storage devices, Beats products, and other connectivity and computing products and supplies. Additionally, it offers iCloud, a cloud service; AppleCare that offers support options for its customers; and Apple Pay, a mobile payment service. The company sells and delivers digital content and applications through the iTunes Store, App Store, Mac App Store, TV App Store, iBooks Store, and Apple Music. It also sells its products through its retail and online stores, and direct sales force, as well as through third-party cellular network carriers, wholesalers, retailers, and value-added resellers. Apple Inc. was founded in 1977 and is headquartered in Cupertino, California.",
  "exchange": "Nasdaq Global Select",
  "name": "Apple Inc",
  "symbol": "AAPL",
  "logo": "https://s3.polygon.io/logos/aapl/logo.png",
  "similar": [
    "MSFT",
    "NOK",
    "IBM",
    "HPQ",
    "GOOGL",
    "BB",
    "XLK"
  ]
}

Dividends:

[
  {
    "symbol": "AAPL",
    "type": "Dividend income",
    "exDate": "2018-02-09T00:00:00.000Z",
    "paymentDate": "2018-02-15T00:00:00.000Z",
    "recordDate": "2018-02-12T00:00:00.000Z",
    "declaredDate": "2018-02-01T00:00:00.000Z",
    "qualified": "Q",
    "amount": 0.63
  },
  {
    "symbol": "AAPL",
    "type": "Dividend income",
    "exDate": "2017-11-10T00:00:00.000Z",
    "paymentDate": "2017-11-16T00:00:00.000Z",
    "recordDate": "2017-11-13T00:00:00.000Z",
    "declaredDate": "2017-11-02T00:00:00.000Z",
    "qualified": "Q",
    "amount": 0.63
  },
  {
    "symbol": "AAPL",
    "type": "Dividend income",
    "exDate": "2017-08-10T00:00:00.000Z",
    "paymentDate": "2017-08-17T00:00:00.000Z",
    "recordDate": "2017-08-14T00:00:00.000Z",
    "declaredDate": "2017-08-01T00:00:00.000Z",
    "qualified": "Q",
    "amount": 0.63
  }
]

Splits:

[
  {
    "symbol": "AAPL",
    "exDate": "2014-06-09T00:00:00.000Z",
    "paymentDate": "2014-06-06T00:00:00.000Z",
    "recordDate": "2014-06-02T00:00:00.000Z",
    "declaredDate": "2014-04-23T00:00:00.000Z",
    "ratio": 0.142857,
    "tofactor": 7,
    "forfactor": 1
  }
]

We hope these APIs will help provide useful information around symbols. We will be adding more meta APIs in the near future, but these are available immediately.

From the blog

See what's happening at polygon.io

integration quantconnect Feature Image
featured

Integration: QuantConnect

We are excited to announce our integration with QuantConnect! This offering empowers users with state-of-the-art research, backtesting, parameter optimization, and live trading capabilities, all fueled by the robust market data APIs and WebSocket Streams of Polygon.io.