Twelve Data Get Earnings
5 credits/call
ae_twelvedata_get_earnings
Get a company’s historical, latest, or upcoming earnings data from Twelve Data, including estimated and actual earnings per share (EPS).
5 credits/call
Pricing
5 credits/call
| Condition | Charge |
|---|---|
| Each call | 5 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
dp | integer | No | The number of decimal places in the response data. Should be in range [0,11] inclusive | 2 |
isin | string | Conditional | ISIN of the instrument. Use a real non-empty identifier; if this instrument is unavailable by ISIN, resolve its ticker symbol first. | — |
type | enum (American Depositary Receipt | Bond | Bond Fund | Closed-end Fund | Common Stock | Depositary Receipt | Digital Currency | ETF | Exchange-Traded Note | Global Depositary Receipt | Limited Partnership | Mutual Fund | Physical Currency | Preferred Stock | REIT | Right | Structured Product | Trust | Unit | Warrant) | No | The asset class to which the instrument belongs | — |
cusip | string | Conditional | CUSIP of the instrument. Use a real non-empty identifier; if this instrument is unavailable by CUSIP, resolve its ticker symbol first. | — |
format | enum (JSON | CSV) | No | The format of the response data | JSON |
period | enum (latest | next) | No | Type of earning, returns only 1 record. When is not empty, dates and outputsize parameters are ignored | — |
symbol | string | Conditional | Ticker 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. | — |
country | string | No | Country where instrument is traded, e.g., `United States` or `US` | — |
end_date | string | No | The date to which the data is requested. The date format is `YYYY-MM-DD`. | — |
exchange | string | No | Exchange where instrument is traded | — |
mic_code | string | No | Market Identifier Code (MIC) under ISO 10383 standard | — |
delimiter | string | No | The separator used in the CSV response data | ; |
outputsize | integer | No | Number of data points to retrieve. Supports values in the range from `1` to `1000`. Default `10` when no date parameters are set, otherwise set to maximum | 10 |
start_date | string | No | The date from which the data is requested. The date format is `YYYY-MM-DD`. | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_twelvedata_get_earnings' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"exchange": "NASDAQ",
"symbol": "AAPL"
}
}'Response exampleresponse.json
{
"earnings": [
{
"date": "2026-07-30",
"difference": 0.13,
"eps_actual": 2.02,
"eps_estimate": 1.89,
"surprise_prc": 6.88,
"time": "After Hours"
}
],
"meta": {
"currency": "USD",
"exchange": "NASDAQ",
"exchange_timezone": "America/New_York",
"mic_code": "XNGS",
"name": "Apple Inc.",
"symbol": "AAPL"
},
"status": "ok"
}This example shows part of the response. Copied content is valid JSON.

