Benzinga · Analyst ratings
benzinga/calendar/ratingsGet market and financial data with Benzinga · Analyst ratings from Alexandria through one Spiral API key. Use for how analysts have moved on a stock: upgrades, downgrades, initiations and target changes. Filter by parameters[analyst_id] or parameters[firm_id] to follow one analyst or firm. It carries the ratings, not the reasoning behind them. It runs in the background and returns structured JSON. Pay as you go, with no subscription.
Pricing
$0.052377 per call.
Limits
- Runs
- In the background
- Returns
- json
- Longest queue wait
- 1 hour
- Run deadline
- 5 minutes
- Longest run, end to end
- 225 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
page | number … to 100000 | 0 | Page offset, 0 to 100000. |
fields | text | — | Comma-separated response fields to return, or * for every field including ratings_accuracy. Available: id, date, time, ticker, exchange, name, currency, action_pt, action_company, rating_current, pt_current, rating_prior, pt_prior, pt_pct_change, url, url_calendar, url_news, analyst, analyst_id, analyst_name, firm_id, ratings_accuracy, importance, notes, updated. Set it to trim the payload when you only need the rating and target. |
pagesize | number … to 1000 | — | Records to return. Limit 1000. |
simplify | true or false | — | Collapse ratings to standardized categories. |
parameters[date] | text | — | A single date, YYYY-MM-DD, as shorthand when date_from and date_to would be the same. Leave unset to get the latest ratings. |
parameters[action] | one of Assumes, Downgrades, Firm Dissolved, Initiates Coverage On, Maintains, Reinstates, Reiterates, Removes, Suspends, Terminates Coverage On, Upgrades | — | Ratings action to filter to, matched against action_company. |
parameters[date_to] | text | — | Latest rating date, YYYY-MM-DD. |
parameters[firm_id] | text | — | Comma-separated firm ids. Take them from the id field of calendar/ratings-firms, or the firm_id on a rating, to keep to one research firm's coverage. |
parameters[tickers] | text | — | Comma-separated ticker symbols, maximum 50. |
parameters[updated] | number | — | Unix timestamp. Returns records updated at or after it, for polling deltas. |
parameters[date_from] | text | — | Earliest rating date, YYYY-MM-DD. |
parameters[analyst_id] | text | — | Comma-separated analyst ids. Take them from the id field of calendar/ratings-analysts, or the analyst_id on a rating, to follow one analyst's calls. |
parameters[importance] | one of 0, 1, 2, 3, 4, 5 | — | Minimum importance level, matched as greater than or equal to the value given. Raise it when the caller only wants the notable calls. |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "alexandria",
"model": "benzinga/calendar/ratings",
"input": {
"page": 0
}
}'Frequently asked questions
How much does Benzinga · Analyst ratings cost?
$0.052377 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use Benzinga · Analyst ratings through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "benzinga/calendar/ratings"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with Alexandria to use Benzinga · Analyst ratings?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use Benzinga · Analyst ratings?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.