Build a stock asset page

Introduction

This guide will show you how to build your own stock asset page using Atom's platform APIs. Your stock page may be as simple or complex as you'd like, and you can customize the layout to match your desired UX and design language. For inspiration, check out Atom's consumer app. The same data, content, and tools that we used to build our apps are available to you via our API. Here's a screenshot of how we laid out our asset page on our web app:

12461246

Add trade metadata to your stock page

First, add trade metadata like current price, bid, ask, and volume to the stock page. This can be accomplished in two ways:

  1. Using streaming prices: This allows your app to update trade metadata in real time as new trades come in throughout the day. To do this, please refer to the Streaming prices endpoint.
  2. Polling for price as needed: If you don't need real-time trade updates and would like to poll trades at your own cadence (e.g., on page load or every minute), please refer to the Price snapshot endpoint.
21282128

Add a historical price chart

Stock price charts can be built using the Price history endpoint. For the most "live" effect, consider combining this with Streaming prices to create a chart that always shows the latest data point in real time.

13481348

Add stock metadata and overview statistics

Next, consider adding company overview data to the page to give users high-level statistics, such as descriptive data, information about dividends and costs, basic financial and valuation data, and maybe a company logo to add personality to the page. This can all be done using the Equity overview endpoint.

11401140

Add news to a stock page

News provides constantly updated content and can keep users coming back to your app. To add news to a stock page, use the News feed endpoint, making sure to pass in the asset's identifier as a parameter. The endpoint will then return a feed of news tailored to that stock.

Add financial statements

More sophisticated users may want to dig into the fundamentals of a company, and a great place to start is with as-reported financial statements. You can retrieve this data from the Equity financials endpoint.

12481248

Add analyst estimates and company guidance

Stocks tend to move based on recommendations from equity research analysts in the market, so power users may find it useful to dig into these estimates.

Atom provides aggregated consensus estimates from analysts across Wall Street, as well as the company's own financial forward guidance (when applicable). We also show an aggregated view of analyst buy/sell/hold recommendations, in addition to a running list of analyst actions (recommendation changes). You can retrieve all of this data from the Equity estimates endpoint.

12461246

Add events

The outcome of events, such as earnings releases, can have a large effect on a stock's price, so it's useful for investors to know when these events occur. You can add an event calendar tailored to any equity asset using the Equity events endpoint. Some events have documents associated with them, such as earnings transcripts, presentations, or SEC filings. In these cases, the endpoint will provide a reference to the document for inclusion in your product.

786786

Add documents

Provide documents to enable your users to do a deep-dive on company financials. The documents endpoint returns of list of documents for a given asset, including earnings transcripts, 10-Ks, 10-Qs, 8-Ks, company presentations, and more.

Each response object includes document metadata (e.g. title, timestamp, etc.) as well as the document contents. In the case of an HTML document, we provide both a link to the HTML document as well as the raw text in the response object.

Add asset peers

Peers provide a point of comparison as well as a mechanism for further investment idea discovery. You can allow users to view a company's peers using the Asset peers endpoint.

Ready to get started? Get your free trial API key ➔

Did this page help you?