NewConnect Claude, Cursor, ChatGPT, and other AI agents to API Ninjas via our MCP server →

Stock Split API

The Stock Split API provides historical and upcoming stock split data for companies listed on the world's largest stock exchanges. Look up a company's full split history by ticker, or query a forward / reverse split calendar by date range and exchange.

(4.5)

From 2,514 users

1,800+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
370ms418ms425ms771ms1261ms

Didn't find what you were looking for? Suggest an improvement

/v1/stocksplit GET

https://api.api-ninjas.com/v1/stocksplit

Returns a list of stock split records matching your filters. With no parameters, returns splits dated between 30 days ago and 30 days from now (recent and upcoming). Up to 50 records are returned per request by default (configurable via limit, max 1000).

Parameters

All parameters are optional.

  • ticker  optional

    Company ticker symbol. For U.S.-listed stocks use the bare symbol (e.g. GOOG); for international listings include the exchange suffix as the symbol trades (e.g. 7203.T for Toyota on Tokyo, RELIANCE.NS for Reliance on NSE India). Returns that company's full split history.

  • exchange  optional

    Filter results to a single exchange by its code — for example US, JPX (Tokyo), LSE (London), HKSE (Hong Kong), or NSE (India).

  • split_type  optional

    Filter by split direction: forward (e.g. 4-for-1) or reverse (a consolidation, e.g. 1-for-10).

  • date  optional

    Single date in YYYY-MM-DD format. Cannot be combined with date_start or date_end.

  • date_start  optional

    Range start in YYYY-MM-DD format. Free-tier users cannot query earlier than 24 months ago.

  • date_end  optional

    Range end in YYYY-MM-DD format.

  • limit  optional

    Maximum results to return. Default 50, max 1000.

  • offset  optional

    Number of results to skip for pagination. Default 0.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON array of stock split records, each containing the following fields, or an error if the request is unsuccessful.

  • ticker

    Company ticker symbol, including the exchange suffix for international listings.

  • name

    Company name.

  • short_name

    Company name with the trailing legal form (Inc., Ltd., Corp., etc.) removed.

  • exchange

    Exchange code for the listing — e.g. US, JPX, HKSE, LSE, or NSE.

  • date

    Effective (ex-) date of the split (YYYY-MM-DD).

  • numerator

    Shares held after the split (the 4 in a 4-for-1 split).

  • denominator

    Shares held before the split (the 1 in a 4-for-1 split).

  • ratio

    Human-readable split ratio, e.g. 4:1 or 1:10.

  • split_factor

    Numeric multiplier (numerator ÷ denominator) — e.g. 4 for a 4-for-1 split, 0.1 for a 1-for-10 reverse split. Use it to back-adjust historical prices and share counts.

  • split_type

    forward when numerator ≥ denominator; reverse for a consolidation.

  • currency

    Trading currency of the listing (e.g. USD, JPY, HKD).

Sample Request Live Demo!

ticker
exchange
split_type
date_start
date_end
limit

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/stocksplit?ticker=GOOG

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
[
    {
      ticker:"GOOG",
      name:"Alphabet Inc.",
      short_name:"Alphabet",
      exchange:"NASDAQ",
      date:"2022-07-18",
      numerator:20,
      denominator:1,
      ratio:"20:1",
      split_factor:20,
      split_type:"forward",
      currency:"USD"
    },
    {
      ticker:"GOOG",
      name:"Alphabet Inc.",
      short_name:"Alphabet",
      exchange:"NASDAQ",
      date:"2014-03-27",
      numerator:1001,
      denominator:500,
      ratio:"1001:500",
      split_factor:2.002,
      split_type:"forward",
      currency:"USD"
    }
]

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/stocksplit?ticker=GOOG" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.