Twelve Data Get Splits

5 credits/call
ae_twelvedata_get_splits

View a security’s historical stock splits, including split dates and factors.

Productivity
5 credits/call

Pricing

5 credits/call
ConditionCharge
Each call5 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
isinstringConditionalISIN of the instrument. Use a real non-empty identifier; if this instrument is unavailable by ISIN, resolve its ticker symbol first.—
cusipstringConditionalCUSIP of the instrument. Use a real non-empty identifier; if this instrument is unavailable by CUSIP, resolve its ticker symbol first.—
rangeenum (last | 1m | 3m | 6m | ytd | 1y | 2y | 5y | full)NoRange of data to be returnedlast
symbolstringConditionalTicker symbol of the instrument, for example AAPL, EUR/USD or ETH/BTC. Use a real non-empty symbol; a supported ISIN or CUSIP may be used instead when this endpoint accepts it.—
countrystringNoCountry where instrument is traded, e.g., `United States` or `US`—
end_datestringNoThe ending date for data selection. Format `2006-01-02`—
exchangestringNoExchange where instrument is traded—
mic_codestringNoMarket Identifier Code (MIC) under ISO 10383 standard—
start_datestringNoThe starting date for data selection. Format `2006-01-02`—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_twelvedata_get_splits' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "end_date": "2026-12-31",
    "start_date": "2024-01-01",
    "symbol": "FFAI"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "meta": {
    "currency": "USD",
    "exchange": "NASDAQ",
    "exchange_timezone": "America/New_York",
    "mic_code": "XNCM",
    "name": "Faraday Future Intelligent Electric Inc.",
    "symbol": "FFAI"
  },
  "splits": [
    {
      "date": "2026-07-24",
      "description": "1-for-150 split",
      "from_factor": 1,
      "ratio": 150,
      "to_factor": 150
    }
  ]
}

This example shows part of the response. Copied content is valid JSON.