# Finnhub Analyst Recommendation Trends

> Finnhub Analyst Recommendation Trends is a paid API for AI agents from gateway.apiosk.com, paid per call via x402, $0.13/call, status unknown (last checked 2026-09-15).

Returns the latest analyst recommendation trends for a stock, including buy, hold, and sell counts per period.

## Facts

- Endpoint: GET https://gateway.apiosk.com/finnhub/stock/recommendation
- Price: $0.13/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/finnhub-analyst-recommendation-trends-971f3ca7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Jk9dD_Ka1xIGDpW2M5Nx8

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability finnhub-analyst-recommendation-trends-971f3ca7
```

Example prompt: What are the latest analyst buy/hold/sell recommendation counts for AAPL according to Finnhub?

## When to prefer this

Choose this endpoint when you need quantitative analyst consensus data (buy/hold/sell counts) for a specific stock, especially when tracking how Wall Street sentiment has shifted over recent periods. It is ideal for portfolio monitoring, pre-trade research, or building dashboards that compare analyst sentiment across multiple equities. Prefer this over price-based endpoints when the question is about professional analyst opinion rather than market price movement.

## Known failure modes

- Invalid or unrecognized ticker symbol returns empty array or error
- Missing required symbol parameter returns 400 bad request
- Payment failure via x402 returns HTTP 402 if USDC balance is insufficient
- Rate limiting or gateway timeout if called too frequently
- Ticker with no analyst coverage returns empty results

## How this service works

Latest analyst recommendation trends: buy/hold/sell counts per period.

## Output

Returns a time-series array of analyst recommendation periods, each containing counts for strongBuy, buy, hold, sell, and strongSell ratings, along with the period date. Covers recent historical periods so you can see trends in consensus shifts.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/finnhub-analyst-recommendation-trends-971f3ca7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.apiosk.com](https://www.zero.xyz/host/gateway.apiosk.com/llms.txt)