Stock Splits by Ticker
GET/v1/splits/{ticker}
Retrieve historical stock split events for a ticker, including split date and numerator/denominator ratio (e.g. 4-for-1). Splits are ordered most recent first. Use this to adjust share counts, explain sudden price discontinuities or align corporate-action timelines with price history.
Use cases
- Corporate actions research and timeline displays
- Adjusting historical share counts for models
- Explaining price gaps on charts after split events
- Compliance and audit trails for position history
Input parameters
Required
| Parameter | Type | Description |
|---|---|---|
| ticker(*) | string | Ticker. |
| limit | integer | Max results (default 500). |
Output parameters
| Field | Type | Description |
|---|---|---|
| results | array | Split events, most recent first. |
| results[].ticker | string | Ticker. |
| results[].split_date | string | Effective split date (YYYY-MM-DD). |
| results[].numerator | integer | Split numerator (e.g. 4 in a 4-for-1 split). |
| results[].denominator | integer | Split denominator (e.g. 1 in a 4-for-1 split). |
| count | integer | Number of split events returned. |
from vantafin import RESTClient
client = RESTClient("vf-live-your_api_key")
result = client.get_splits("AAPL")
print(result){
"results": [
{
"ticker": "AAPL",
"split_date": "2020-08-31",
"numerator": 4,
"denominator": 1
}
],
"count": 1
}