Finnhub Company Earnings
0.5 credits/call
ae_finnhub_company_earnings
获取公司历史季度盈利惊喜数据。强制要求:必须先用 symbol 搜索或股票列表工具确认 symbol;该工具不在当前 Finnhub 允许范围内,不要直接调用。用户只要基础行情或公司信息时,必须改用行情查询或公司资料、搜索类工具。 强制服务边界:Finnhub 当前范围仅适合基础美股/美国上市公司、基础行情、公司资料、symbol 搜索和明确支持的公共市场信息。非美股、港股、A股、中文公司名、加密货币、外汇或市场不确定时,不得调用 Finnhub 工具。 强制范围规则:该工具属于当前范围外资源。当前 Finnhub 范围外时,绝对不得调用;必须改用行情查询、公司资料、搜索等基础工具,或说明当前范围不支持。
0.5 credits/call
Pricing
0.5 credits/call
| Condition | Charge |
|---|---|
| Each call | 0.5 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
limit | integer | No | Limit number of period returned. Leave blank to get the full history. | — |
symbol | string | Yes | 必填。只能传 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-KeyRequest 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
[
{
"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.

