Finnhub Recommendation Trends
0.5 credits/call
ae_finnhub_recommendation_trends
Get latest analyst recommendation trends for a company. Results include the reporting period, company symbol, and counts of Strong Buy, Buy, Hold, Sell, and Strong Sell recommendations. 强制服务边界: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 |
|---|---|---|---|---|
symbol | string | Yes | 必填。填写已通过 Finnhub 确认可用的美股/美国上市公司股票代码。只有用户明确请求美股/美国上市公司,或已提供确定的 Finnhub 美股股票代码时,才可使用此参数。仅有美国公司英文名时,先通过股票代码查询确认,不得猜测。不要填写中文公司名、港股或 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_recommendation_trends' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"symbol": "TSLA"
}
}'Response exampleresponse.json
[
{
"buy": 19,
"hold": 23,
"period": "2026-11-01",
"sell": 2,
"strongBuy": 10,
"strongSell": 0
}
]This example shows part of the response. Copied content is valid JSON.

