Market data skills pull quotes, screens, movers, news, and breadth from the Ithaca archive. Most are backed by the community archive (delayed but free); market.quote uses IBKR for real-time or delayed quotes depending on your tier.
All examples assume you’ve opened a session with session_context. Every result includes the provenance envelope . Skill summary Skill ID Tool name Source Runtime Description market.newsmarket_newsarchive-community interactive News headlines + sentiment for a ticker or topic market.screenermarket_screenerarchive-community scan Multi-filter universe screen market.moversmarket_moversarchive-community interactive Top gainers/losers/most-active by exchange market.quotemarket_quoteibkr interactive Real-time or delayed quote market.tidemarket_tidearchive-community interactive Aggregate market breadth
market.news Pulls recent news headlines for a ticker or topic, with a lightweight sentiment score per item.
Arguments Name Type Required Default Description symbolstring one of symbol/topic — Ticker symbol, e.g. NVDA topicstring one of symbol/topic — Free-text topic, e.g. semiconductors limitint no 20Max headlines (1–100) sinceISO date no now - 7dEarliest article timestamp include_sentimentbool no trueAttach a -1..1 sentiment score per item
Source : archive-communityExample market_news({ "symbol" : "NVDA" , "limit" : 3 })
{ "skill_id" : "market.news" , "data" : { "items" : [ { "ts" : "2025-06-27T14:02:00Z" , "headline" : "Nvidia lifts data-center guidance" , "source" : "Reuters" , "sentiment" : 0.72 , "url" : "..." }, { "ts" : "2025-06-27T11:30:00Z" , "headline" : "Analysts cut NVDA price target" , "source" : "Bloomberg" , "sentiment" : -0.31 , "url" : "..." }, { "ts" : "2025-06-27T09:15:00Z" , "headline" : "NVDA opens higher on AI demand" , "source" : "CNBC" , "sentiment" : 0.45 , "url" : "..." } ] }, "provenance" : { "source" : "archive-community" , "freshness" : { "as_of" : "2025-06-27T14:05:00Z" , "lag_seconds" : 180 }, "coverage" : { "start" : "2025-06-20T00:00:00Z" , "end" : "2025-06-27T14:05:00Z" }, "cost" : { "credits" : 1 , "tier" : "free" }, "warnings" : [] } }
market.screener Runs a multi-filter screen across the supported universe. Runs under the scan profile (900 s).
Arguments Name Type Required Default Description universestring no sp500One of sp500, russell2000, nasdaq100, all min_market_capfloat no — Minimum market cap in USD max_market_capfloat no — Maximum market cap in USD min_pricefloat no — Minimum share price max_pricefloat no — Maximum share price min_avg_volumefloat no — Minimum 30-day average volume sectorstring no — GICS sector, e.g. Technology industrystring no — GICS industry min_pefloat no — Minimum P/E (trailing) max_pefloat no — Maximum P/E (trailing) min_dividend_yieldfloat no — Minimum dividend yield (decimal, e.g. 0.02) min_rs_ratingfloat no — Minimum Relative Strength rating (0–100) sort_bystring no market_capSort field sort_dirstring no descasc or desclimitint no 50Max results (1–500)
Source : archive-communityExample market_screener({ "universe" : "sp500" , "sector" : "Technology" , "min_market_cap" : 100000000000 , "min_avg_volume" : 5000000 , "sort_by" : "rs_rating" , "limit" : 10 })
{ "skill_id" : "market.screener" , "data" : { "matches" : [ { "symbol" : "NVDA" , "name" : "NVIDIA Corp" , "market_cap" : 3150000000000 , "pe" : 68.2 , "rs_rating" : 99 , "price" : 128.42 }, { "symbol" : "AVGO" , "name" : "Broadcom Inc" , "market_cap" : 780000000000 , "pe" : 71.4 , "rs_rating" : 95 , "price" : 172.18 } ], "total" : 2 }, "provenance" : { "source" : "archive-community" , "freshness" : { "as_of" : "2025-06-27T20:00:00Z" , "lag_seconds" : 900 }, "cost" : { "credits" : 5 , "tier" : "basic" }, "warnings" : [] } }
market.movers Returns top gainers, losers, and most-active tickers for an exchange or universe.
Arguments Name Type Required Default Description exchangestring no usus, nasdaq, nyse, amexuniversestring no — Optional universe filter (overrides exchange) directionstring no allgainers, losers, most_active, or allmin_pricefloat no 1.0Exclude sub-dollar names min_volumefloat no — Minimum day volume limitint no 25Per category (1–100) as_ofISO date no latest session Historical movers snapshot
Source : archive-communityExample market_movers({ "direction" : "gainers" , "limit" : 5 })
{ "skill_id" : "market.movers" , "data" : { "as_of" : "2025-06-27" , "gainers" : [ { "symbol" : "SMCI" , "price" : 612.30 , "change_pct" : 12.4 , "volume" : 8900000 }, { "symbol" : "PLTR" , "price" : 138.55 , "change_pct" : 8.1 , "volume" : 51000000 } ] }, "provenance" : { "source" : "archive-community" , "freshness" : { "as_of" : "2025-06-27T20:00:00Z" , "lag_seconds" : 60 }, "cost" : { "credits" : 1 , "tier" : "free" }, "warnings" : [] } }
market.quote Real-time or delayed quote via IBKR. Latency depends on your data tier.
Arguments Name Type Required Default Description symbolstring yes — Ticker symbol fieldsstring[] no ["last","bid","ask","volume"]Extra fields: open, high, low, close, vwap, change_pct realtimebool no falseRequest real-time (requires pro tier + IBKR market data sub)
Source : ibkrIf realtime=true but your tier or IBKR subscription doesn’t include it, the call falls back to delayed (15 min) and adds a realtime_unavailable warning to the envelope.
Example market_quote({ "symbol" : "AAPL" , "fields" : [ "last" , "bid" , "ask" , "volume" , "change_pct" ] })
{ "skill_id" : "market.quote" , "data" : { "symbol" : "AAPL" , "last" : 212.55 , "bid" : 212.54 , "ask" : 212.56 , "volume" : 42100000 , "change_pct" : 0.83 }, "provenance" : { "source" : "ibkr" , "freshness" : { "as_of" : "2025-06-27T16:00:15Z" , "lag_seconds" : 15 }, "cost" : { "credits" : 1 , "tier" : "free" }, "warnings" : [] } }
market.tide Aggregate market breadth — advancers/decliners, new highs/lows, up-volume/down-volume — across an exchange. Useful as a regime filter.
Arguments Name Type Required Default Description exchangestring no usus, nasdaq, nyse, amexas_ofISO date no latest session Historical breadth snapshot lookback_daysint no 1Breadth trend over N sessions
Source : archive-communityExample market_tide({ "exchange" : "nyse" , "lookback_days" : 5 })
{ "skill_id" : "market.tide" , "data" : { "as_of" : "2025-06-27" , "advancers" : 1842 , "decliners" : 1213 , "unchanged" : 102 , "new_highs" : 214 , "new_lows" : 38 , "up_volume" : 3120000000 , "down_volume" : 1980000000 , "breadth_5d" : [ 0.62 , 0.58 , 0.71 , 0.49 , 0.60 ] }, "provenance" : { "source" : "archive-community" , "freshness" : { "as_of" : "2025-06-27T20:00:00Z" , "lag_seconds" : 300 }, "cost" : { "credits" : 1 , "tier" : "free" }, "warnings" : [] } }
Next steps
Fundamentals Skills Fundamentals snapshots, comparisons, point-in-time data, and analyst ratings.
Skills Overview Back to the full catalog and provenance envelope reference.
