Skip to content
sQuil Docs

The agent

Tool reference

Ten resolvers. Each returns a rendered card and a structured payload from a single call, so the figures the model reasons over and the figures you see are the same figures.

Listing and market

ResolverReturnsAsk it when
search_listingsMatching listings from the registry with their session state.You know a company but not its ticker, or want everything matching a theme.
get_quoteLast price, pool quote, change, session open, session range, staleness and standing flags.You want the state of one listing right now.
scan_marketThe registry ranked by session performance — gainers, losers, widest range.You want today's movers. Note: it ranks by move, never by volume.
get_price_historyA price path over a named window, drawn as a chart in the reply, with window change, high, low and first/last.Someone asks to see something. Knowing the shape is not drawing it.

Placing a move

ResolverReturnsAsk it when
get_contextToday's move in standard deviations of the listing's own recent volatility, its percentile among the past year's daily moves, position in the 52-week range, the overnight gap split from the intraday move, and what SPY and QQQ did the same day.Anyone asks whether a move is big, unusual, meaningful, or whether it is the listing moving or the whole market.
get_technicalsRSI, MACD, moving averages at 20/50/200, Bollinger bands, ATR, VWAP and volume against its own average — with a chart carrying a volume band and overlays.Technical analysis, momentum, overbought or oversold, moving averages, volume behaviour.

Company reference

ResolverReturnsAsk it when
get_listing_referenceMarket capitalisation, shares traded today and on a 30-session average, the dollar notional that volume represents, when the share last traded, exchange state, and the token premium.Size, liquidity, tradability, or what the company actually is.
get_earningsThe last reported quarter — EPS, revenue, distance from estimate — and the next scheduled report with a day count.Results, fundamentals, or what is coming up.
get_newsRecent published headlines for the company.Someone asks what is being written about a name. Never returned as a cause of a move.
size_orderA dollar amount converted into units at the last price, with the no-market-impact assumption stated.Someone gives you a notional and wants units.

Derived quantities are resolved, never composed

Where an answer needs a computed figure, the resolver computes it and returns it finished. Composition is never allowed to become calculation — every derived quantity arrives as data, with its semantics carried in the field name itself.

  • session_notional_usd — the dollar value a session’s volume represents, resolved rather than multiplied out in prose.
  • days_until_next_report — the interval to the next scheduled disclosure, counted server-side against the market calendar.
  • todays_move_is_larger_than_this_pct_of_days_this_year — a percentile whose direction is encoded in the field name, so the reading cannot invert.
  • pool_quote_unusable — a resolved boolean on whether a pool quote still functions as a price, so the judgement is delivered rather than inferred.
reference.listing · AMZN
Market cap             $2.86T
Session volume         49,547,444
Average volume         43,229,395      30 sessions
Session notional       $13.2B
Token premium          −3.43%
Share last traded      1d ago
Underlying market      Closed