Twelve Data Get Dividends Calendar

10 credits/call
ae_twelvedata_get_dividends_calendar

Browse Twelve Data's past and upcoming dividend events by date range, including companies, ex-dividend dates, and amounts.

Productivity
10 credits/call

Pricing

10 credits/call
ConditionCharge
Each call10 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
isinstringNoISIN of the instrument. Use a real non-empty identifier; if this instrument is unavailable by ISIN, resolve its ticker symbol first.—
pageintegerNoPage number1
cusipstringNoCUSIP of the instrument. Use a real non-empty identifier; if this instrument is unavailable by CUSIP, resolve its ticker symbol first.—
symbolstringNoSymbol ticker of instrument. For preferred stocks use dot(.) delimiter. E.g. `BRK.A` or `BRK.B` will be correct—
countrystringNoCountry where instrument is traded, e.g., `United States` or `US`—
end_datestringNoEnd date for the dividends calendar query. Only dividends with ex-dates on or before this date will be returned. Format `2006-01-02`—
exchangestringNoExchange where instrument is traded—
mic_codestringNoMarket Identifier Code (MIC) under ISO 10383 standard—
outputsizeintegerNoNumber of data points to retrieve. Supports values in the range from `1` to `500`. Default `100` when no date parameters are set, otherwise set to maximum100
start_datestringNoStart date for the dividends calendar query. Only dividends with ex-dates on or after this date will be returned. 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_dividends_calendar' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "outputsize": 100,
    "page": 1
  }
}'
Response exampleresponse.json
JSONPartial content
[
  {
    "amount": 0.48975694,
    "ex_date": "2030-12-13",
    "exchange": "NASDAQ",
    "mic_code": "XNMS",
    "symbol": "GECCG"
  }
]

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