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.

• 

  katie

  Katie Adams

  Read More