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

AlexandriaFinanceAvailable now

Benzinga · Why Is It Moving

benzinga/news/wiims

Get market and financial data with Benzinga · Why Is It Moving from Alexandria through one Spiral API key. Use this to answer why a stock moved: WIIMs are the short attributed explanations Benzinga files against a ticker's price action. For the underlying coverage use news/search, and for the company's own announcement use news/press-releases. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

Pricing

$0.078566 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
datetext—

A single day to query, yyyy-mm-dd. Use it when the caller asks why a stock moved on a specific date.

isintext—

Comma-separated ISINs, maximum 50. Use when the caller identifies companies by ISIN.

pagenumber0

Page offset, limited to 0-100000. Increase it to page further back rather than widening the date range.

sortone of
id:asc, id:desc, created:asc, created:desc, updated:asc, updated:desc
—

Sort order as field:direction. Use created:asc to read a session forwards.

cusipstext—

Comma-separated CUSIPs, maximum 50; requires a license agreement.

dateTotext—

Latest publication date, yyyy-mm-dd. Pair it with dateFrom to bound a period.

formatone of
text
—

Desired response format. Set text only when you want plain text rather than JSON structures.

regiontext—

Region filter, for example 'ca' or 'canada' for Canadian content.

topicstext—

Comma-separated words or phrases matched against title, tags and body in that order of priority.

authorstext—

Comma-separated authors. Set it to restrict to a particular desk.

tickerstext—

Comma-separated ticker symbols, maximum 50. Set this whenever the caller names a company.

dateFromtext—

Earliest publication date, yyyy-mm-dd. Set it when the caller asks about a period.

pageSizenumber
… to 100
15

Number of WIIM items returned, maximum 100. Raise it when scanning a whole session's movers.

importancetext—

Importance level filter. Set it when the caller wants only the more significant move explanations.

updatedSincenumber—

Unix timestamp in UTC; set it to your last sync time to pull only items updated since then.

content_typestext—

Comma-separated content types. Set it when you need to keep the feed to a specific content type.

displayOutputone of
full, abstract, headline
headline

How much of each item to return: headline only, abstract (headline plus teaser) or full body. WIIMs are short, so abstract is usually enough.

importanceRanknumber—

Importance rank from 1 to 5. Set a low number to keep only the highest-ranked items.

primaryTickerstext—

Comma-separated primary ticker symbols; use it to keep only items whose primary subject is that company.

publishedSincenumber—

Unix timestamp in UTC; set it to pull and sort by items published since that moment, which suits intraday polling.

topic_group_byone of
and, or
or

Logical operator for the topics query. Set and when every topic must appear.

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/news/wiims",
    "input": {
      "date": "<date>"
    }
  }'

Frequently asked questions

How much does Benzinga · Why Is It Moving cost?

$0.078566 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 · Why Is It Moving through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "benzinga/news/wiims"` 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 · Why Is It Moving?

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

Can my AI agent use Benzinga · Why Is It Moving?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.