NewConnect Claude, Gemini, 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
415ms438ms472ms876ms1335ms

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 our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

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.

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the Stock Split API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • It provides historical and upcoming stock splits for companies listed on the world's largest stock exchanges, spanning the major U.S., European, and Asian markets. Both forward splits and reverse splits (consolidations) are covered, each with its exact ratio and effective date. To pair splits with prices, see the Stock Price API.
  • Pass the ticker parameter to /v1/stocksplit. For U.S.-listed stocks use the bare symbol (e.g. AAPL); for international listings include the exchange suffix exactly as the symbol trades (e.g. 7203.T for Toyota on Tokyo, or RELIANCE.NS for Reliance on NSE India). The endpoint returns that company's full split history, most recent first. Look up or resolve symbols with the Ticker API.
  • Use date_start and date_end (both YYYY-MM-DD) to define a window, optionally narrowing by exchange or split_type (forward or reverse); with no parameters the endpoint returns splits dated from 30 days ago through 30 days ahead, covering both recent and upcoming splits. Free-tier requests cannot query a date_start earlier than 24 months ago, so deeper history requires a paid plan, and you can page through large result sets with limit (default 50, max 1000) and offset.
  • Each record includes the ticker, company name and short_name, exchange, the split date, the raw numerator and denominator, a human-readable ratio (e.g. 4:1), a numeric split_factor (e.g. 4 for a 4-for-1 split or 0.1 for a 1-for-10 reverse split), the split_type (forward or reverse), and the trading currency. Use split_factor to back-adjust historical prices and share counts.