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).

Research
5 credits/call

Pricing

5 credits/call
ConditionCharge
Each call5 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
dpintegerNoThe number of decimal places in the response data. Should be in range [0,11] inclusive2
isinstringConditionalISIN of the instrument. Use a real non-empty identifier; if this instrument is unavailable by ISIN, resolve its ticker symbol first.—
typeenum (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)NoThe asset class to which the instrument belongs—
cusipstringConditionalCUSIP of the instrument. Use a real non-empty identifier; if this instrument is unavailable by CUSIP, resolve its ticker symbol first.—
formatenum (JSON | CSV)NoThe format of the response dataJSON
periodenum (latest | next)NoType of earning, returns only 1 record. When is not empty, dates and outputsize parameters are ignored—
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 date to which the data is requested. The date format is `YYYY-MM-DD`.—
exchangestringNoExchange where instrument is traded—
mic_codestringNoMarket Identifier Code (MIC) under ISO 10383 standard—
delimiterstringNoThe separator used in the CSV response data;
outputsizeintegerNoNumber 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 maximum10
start_datestringNoThe 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-Key
Request 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
JSONPartial content
{
  "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.