# 2s.io Stock Analyst Recommendation Trends

> 2s.io Stock Analyst Recommendation Trends is a paid API for AI agents from 2s.io, paid per call via x402, $0.0025/call, status unknown (last checked 2026-09-14).

Returns monthly snapshots of analyst rating counts (strong buy, buy, hold, sell, strong sell) for a US-listed stock ticker, newest first.

## Facts

- Endpoint: GET https://2s.io/api/stocks/recommendations
- Price: $0.0025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-stock-analyst-recommendation-trends-1d0d1073
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wDrMUEBJJ_LIbE4UhIXDJ

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 2s-io-stock-analyst-recommendation-trends-1d0d1073
```

Example prompt: What's the current analyst consensus on NVDA — show me how many analysts rate it strong buy, buy, hold, sell, or strong sell, and whether sentiment has been shifting over recent months.

## When to prefer this

Use this endpoint when you need historical analyst rating counts and trend data by month for a US-listed equity. Prefer this over earnings or price endpoints when the user wants to understand Wall Street sentiment, consensus direction, or rating drift over time. It is specifically backed by Finnhub's professional analyst data.

## Known failure modes

- Invalid or unknown ticker returns an empty result or error
- Non-US-listed tickers may not be found in Finnhub data
- Missing required ticker query parameter returns a 400 or validation error
- Payment failure (x402) if USDC balance is insufficient
- Finnhub data may have a lag of days to weeks for the most recent month

## How this service works

Analyst recommendation trend for a US-listed company — the number of analysts rating it strong buy, buy, hold, sell, and strong sell, snapshotted per month (newest first). Pass ticker. Use it to see the consensus and how sentiment is shifting over time. Data by Finnhub.

## Output

An array of monthly snapshots ordered newest first, each containing the count of analysts rating the stock strong buy, buy, hold, sell, and strong sell, along with the month/period identifier.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "required": [
      "ticker"
     ],
     "properties": {
      "ticker": {
       "type": "string",
       "description": "US-listed ticker, e.g. AAPL."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-stock-analyst-recommendation-trends-1d0d1073/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)