{"@context":"https://schema.org","@type":"Article","headline":"Understanding Nvidia's Stock Split Using the Stocks Splits API","image":"https://massive.com/blog/content/images/2024/06/Stock-Split-API-Graphic.png","description":"The Nvidia stock split just occurred. Splits are not uncommon, and you need to ensure your algotrading systems continue to provide accurate market insights. Here's how you handle stock splits with Massive.com","publisher":{"@type":"Organization","name":"Massive","url":"https://massive.com/blog","logo":{"@type":"ImageObject","url":"https://massive.com$/brands/logo-massive.png"}},"url":"https://massive.com/blog/using-the-split-api-endpoint-to-handle-the-nvidia-stock-split/","keywords":[],"datePublished":"2024-06-11T10:57:06.000-04:00","dateCreated":"2024-06-10T10:16:01.000-04:00","dateModified":"2024-09-05T01:52:22.000-04:00","articleBody":"

In this tutorial, we explore the functionality of the Splits API using Nvidia as a timely example, given its recent 10-for-1 stock split. We will learn how to retrieve information about stock splits and show their effects on aggregate data. By comparing data with and without adjustments for splits, we provide a clear view of how these adjustments influence financial data analysis. This hands-on approach will help you understand the mechanics behind data adjustments and how to apply them in real-world scenarios.

What are Stock Splits?

Stock splits significantly affect financial analysis and require adjustments in how stock information is processed and interpreted. There are two primary types of stock splits: forward and reverse. Forward stock splits increase the number of shares outstanding, distributing additional shares to shareholders and thus reducing the price per share. This method enhances liquidity and makes shares more accessible, as seen with Nvidia's recent 10-for-1 split following strong earnings reports. Conversely, reverse stock splits consolidate existing shares into fewer, more valuable ones, typically to meet stock exchange listing requirements or adjust investor perceptions by reflecting a higher price per share. Both types of splits change the number of shares but do not alter the company's market capitalization or the value of each shareholder's stake.

Exploring the Stock Splits API

To see stock splits in action, you can use the Stock Splits API. You'll need an API key, obtainable by signing up on Massive.com. For this demo, we will use Python along with the Massive client-python library. For example, to view all stock splits for Nvidia, use the following Python code:

from massive import RESTClient\n\nclient = RESTClient("YOUR-API-KEY")\n\nsplits = []\nfor s in client.list_splits("NVDA"):\n    splits.append(s)\nprint(splits)\n

This script lists the latest stock splits for Nvidia and you can see that on 2024-06-10 NVDA went through a 10-for-1 stock split. This effectively changed the price from approximately $1,200 to $120 per share, making the stock more accessible to regular investors, without changing the value of the company.

[\n    Split(execution_date="2024-06-10", split_from=1, split_to=10, ticker="NVDA"),\n    Split(execution_date="2021-07-20", split_from=1, split_to=4, ticker="NVDA"),\n    Split(execution_date="2007-09-11", split_from=2, split_to=3, ticker="NVDA"),\n    Split(execution_date="2006-04-07", split_from=1, split_to=2, ticker="NVDA"),\n]\n

Now that you know a little more about stock splits, let's see how they impact pricing data. We offer data that is split adjusted by default but you can also select split unadjusted data.

Visualizing Stock Splits Using Aggregate Bars

The Stocks Aggregates API from Massive.com is extensively utilized as it provides access to Open, High, Low, and Close prices (OHLC) for any stock listed on US markets. A key feature of this API is the adjusted parameter, which allows you to specify whether the stock data should be adjusted for stock splits. By toggling this parameter between true and false, you can vividly see the impact of stock splits on the visual representation of stock price data.

Retrieving Unadjusted Aggregate Data

Let's first retrieve the unadjusted aggregate data for Nvidia, covering the period from the start of the year to the present. This data will display the raw stock price movements, including distortions caused by stock splits:

from massive import RESTClient\n\nclient = RESTClient('YOUR-API-KEY')\n\naggs = []\nfor a in client.list_aggs(\n    "NVDA",\n    1,\n    "day",\n    "2024-01-10",\n    "2024-06-24",\n    adjusted=False,\n    limit=50000,\n    sort='desc',\n):\n    aggs.append(a)\n\nprint(aggs)\n

In the script above, we query daily aggregate data for Nvidia without adjusting for the stock split. With adjusted=False, the data reflects the share price as originally recorded each day.

This results in significant price changes on the dates when stock splits occurred. For instance, on June 10, 2024, there was a 10-for-1 stock split for Nvidia. In the unadjusted data, you can observe the price appearing to drop dramatically from around $1,200 to $120, which could be misleading without knowledge of the split:

[\n    Agg(timestamp=2024-06-06, open=1240.48, high=1255.87, low=1183.2, close=1209.98, volume=65723115, ...),\n    Agg(timestamp=2024-06-07, open=1197.7, high=1216.9171, low=1180.22, close=1208.88, volume=40552650, ...),\n    Agg(timestamp=2024-06-10, open=120.37, high=123.1, low=117.01, close=121.79, volume=307078688, ...),\n    Agg(timestamp=2024-06-11, open=121.77, high=122.87, low=118.74, close=120.91, volume=218971550, ...),\n]\n

Now, let's compare this with data where adjusted=True, to demonstrate how adjusting for splits provides a smoother, more accurate representation of the stock’s valuation over time. The adjusted data accounts for the split by recalibrating past prices, which is crucial for accurate long-term investment analysis.

Retrieving Adjusted Aggregate Data

Now, let's retrieve the adjusted aggregate data for Nvidia over the same period which is the default mode. Adjusted data accounts for any stock splits by recalibrating the historical prices, ensuring that the analysis reflects a true and consistent valuation of the stock across time. This is crucial for making informed decisions and for accurate long-term trend analysis.

from massive import RESTClient\n\nclient = RESTClient('YOUR-API-KEY')\n\nadjusted_aggs = []\nfor a in client.list_aggs(\n    "NVDA",\n    1,\n    "day",\n    "2024-01-10",\n    "2024-06-24",\n    adjusted=True,\n    limit=50000,\n    sort='desc',\n):\n    adjusted_aggs.append(a)\n\nprint(adjusted_aggs)\n

In the script above, we use the same parameters as before but set adjusted=True to retrieve data that has been adjusted for stock splits.

This means that the dramatic price drop observed in the unadjusted data on the day of the split will be normalized in the adjusted data, showing a more accurate historical price that takes into account the increase in share count.

For example, consider how the adjusted data will display the stock prices around the split:

[\n    Agg(timestamp=2024-06-06, open=124.048, high=125.587, low=118.32, close=120.998, volume=657231150, ...),\n    Agg(timestamp=2024-06-07, open=119.77, high=121.6917, low=118.022, close=120.888, volume=405526500, ...),\n    Agg(timestamp=2024-06-10, open=120.37, high=123.1, low=117.01, close=121.79, volume=307078688, ...),\n    Agg(timestamp=2024-06-11, open=121.77, high=122.87, low=118.74, close=120.91, volume=218971550, ...)\n]\n

With these adjustments, the dramatic fluctuations are smoothed out, providing a clearer and more reliable view of Nvidia's stock performance over time. This data allows analysts and investors to assess the true performance and value of a stock, free from artificial volatility caused by structural changes in stock count.

Next Steps

We hope this tutorial has been informative, demonstrating how to use Massive.com's Stocks Splits API to provide insights into what drives both adjusted and unadjusted Stocks Aggregates API data under the hood. With these tools, you can better analyze the impacts of stock splits on market data, ensuring your financial analyses are both accurate and insightful.

Happy exploring!

\n","author":{"@type":"Person","name":"Justin","image":{"@type":"ImageObject","url":""},"url":"https://massive.com/blog/author/editor/"},"mainEntityOfPage":"https://massive.com/blog/using-the-split-api-endpoint-to-handle-the-nvidia-stock-split/"}