Finnhub Company Earnings

0.5 credits/call
ae_finnhub_company_earnings

获取公司历史季度盈利惊喜数据。强制要求:必须先用 symbol 搜索或股票列表工具确认 symbol;该工具不在当前 Finnhub 允许范围内,不要直接调用。用户只要基础行情或公司信息时,必须改用行情查询或公司资料、搜索类工具。 强制服务边界:Finnhub 当前范围仅适合基础美股/美国上市公司、基础行情、公司资料、symbol 搜索和明确支持的公共市场信息。非美股、港股、A股、中文公司名、加密货币、外汇或市场不确定时,不得调用 Finnhub 工具。 强制范围规则:该工具属于当前范围外资源。当前 Finnhub 范围外时,绝对不得调用;必须改用行情查询、公司资料、搜索等基础工具,或说明当前范围不支持。

Productivity
0.5 credits/call

Pricing

0.5 credits/call
ConditionCharge
Each call0.5 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
limitintegerNoLimit number of period returned. Leave blank to get the full history.—
symbolstringYes必填。只能传 Finnhub 返回并确认可用的美股/美国上市公司 symbol。用户请求港股、A股、非美国市场、中文公司名、加密货币、外汇或不确定市场时,绝对不得调用 Finnhub 股票类工具,也不得用 symbol 搜索试探非美股。只有用户明确请求美股/美国上市公司,或已经提供确定的 Finnhub 美股 symbol 时,才允许调用本工具。如果用户只提供美国公司英文名但没有 symbol,必须先用 symbol 搜索或股票列表工具确认 symbol;确认后才允许调用。禁止传公司中文名、港股/A股代码、URL、test、乱码、占位符或猜测值。—

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_finnhub_company_earnings' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "symbol": "AAPL"
  }
}'
Response exampleresponse.json
JSONPartial content
[
  {
    "actual": 1.91,
    "estimate": 1.9271,
    "period": "2026-06-30",
    "quarter": 3,
    "surprise": -0.0171,
    "surprisePercent": -0.8873
  }
]

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