Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaFinanceAvailable now

Benzinga · Analyst ratings

benzinga/calendar/ratings

Get 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

FieldKindDefaultDescription
pagenumber
… to 100000
0

Page offset, 0 to 100000.

fieldstext—

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.

pagesizenumber
… to 1000
—

Records to return. Limit 1000.

simplifytrue 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.