Introducing

Point-in-time Ticker Details, Directly From the Source

Apr 8, 2021

One of our core tenets at Polygon.io is that we get data directly from the source.  From day one, our pricing data has come from the source (a cable connecting the stock exchanges to our servers), which lets us have confidence that the data we’re passing on to you is the most accurate data available.  Now, to stay true to our beliefs, we’ve set out to do the same thing with reference data by sourcing it directly from the SEC Edgar filings.  Today, we’re excited to launch the first result of that endeavor, an API with ticker details directly from the company’s 10-K and 10-Q filings.

Our Ticker Details API will incorporate point-in-time searching, a concept which we first covered in our new Tickers API announcement.  Point-in-time searching allows you to see the whole picture of how a company has changed over time, and now that includes details about the company like address, market cap, and outstanding shares.

Including a date parameter in the ticker details search will give you the details of a company as it was on that date.  Let’s compare the results of

https://api.polygon.io/vX/reference/tickers/GME?date=2021-01-01&apiKey=*

"results": {
    "ticker": "GME",
    "name": "GameStop Corp. Class A",
    "market": "stocks",
    "locale": "us",
    "primary_exchange": "XNYS",
    "type": "CS",
    "active": true,
    "currency_name": "usd",
    "cik": "0001326380",
    "composite_figi": "BBG000BB5BF6",
    "share_class_figi": "BBG001S5RLR0",
    "last_updated_utc": "2021-03-24T00:00:00Z",
    "outstanding_shares": 69750000,
    "market_cap": 1314090000,        // That's a market cap of ~1.3B
    "phone_number": "(817) 424-2000",
    "address": {
        "address1": "625 Westport Parkway",
        "city": "Grapevine",
        "state": "TX"
     },
     "sic_code": "5734",
     "sic_description": "RETAIL-COMPUTER & COMPUTER SOFTWARE STORES"
}

vs

https://api.polygon.io/vX/reference/tickers/GME?date=2021-03-15&apiKey=*

"results": {
    "ticker": "GME",
    "name": "GameStop Corp. Class A",
    "market": "stocks",
    "locale": "us",
    "primary_exchange": "XNYS",
    "type": "CS",
    "active": true,
    "currency_name": "usd",
    "cik": "0001326380",
    "composite_figi": "BBG000BB5BF6",
    "share_class_figi": "BBG001S5RLR0",
    "last_updated_utc": "2021-03-24T00:00:00Z",
    "outstanding_shares": 69750000,
    "market_cap": 15354765000,          // That's a market cap of ~15.3B
    "phone_number": "(817) 424-2000",
    "address": {
    	"address1": "625 Westport Parkway",
        "city": "Grapevine",
        "state": "TX"
     },
     "sic_code": "5734",
     "sic_description": "RETAIL-COMPUTER & COMPUTER SOFTWARE STORES"
}

You can see that GameStop's market cap increased by about $14B between January and mid-March of this year.  Market Cap is recalculated after each market close to reflect the outstanding shares and the last close price.  Other company details that may have changed are updated nightly as SEC forms are made available.  

Stay tuned for additional data in this endpoint's response in the coming months.  We’ve received a lot of great feedback on our recently released experimental Tickers API, some of which we’ll be incorporating before the final version is released.  We’re opening up the new Ticker Details endpoint for feedback as well, so please check it out in the docs and let us know what you think.

From the blog

See what's happening at polygon.io

polygon plugin for chatgpt Feature Image
announcement

Announcing the Polygon ChatGPT Plugin

Introducing the Polygon plugin for ChatGPT, a powerful tool that simplifies financial research by providing easy access to real-time and historical market data for Stocks, Options, Indices, Forex, and Crypto.

Team Polygon Profile Photo

editor

Team Polygon

indices data has arrived Feature Image
announcement

Indices Data Has Arrived

We are excited to announce the launch of the Indices API endpoints, offering real-time and historical market data for over 11,400+ Indices, including the S&P 500, Dow Jones Industrial Average, Nasdaq-100, and the VIX. With access to comprehensive market data, businesses and individual investors can make informed decisions in today's rapidly evolving financial markets. We have brought the same low-latency and developer-centric API design of our

Team Polygon Profile Photo

editor

Team Polygon