Pulse Tools
These tools answer questions like:
- "How is NVIDIA doing right now?"
- "What's happening with gold / oil / copper?"
- "How are US interest rates? Is the yield curve inverted?"
- "How are semiconductors doing as a sector?"
- "Show me prices for my watchlist: NVDA, TSLA, AAPL"
- "How is my portfolio doing?"
Tools at a glanceโ
| Tool | What it does | Use for |
|---|---|---|
asset_pulse โญ | Price + news + options + peers + fundamentals for one ticker | Any company, ETF, or crypto |
commodity_pulse | Price + supply/demand news + COT positioning for a commodity | Gold, oil, copper, carbon, agri |
bond_pulse | Yield curve + macro news for a country's rates | US rates, JGBs, Bunds, yield curve |
theme_pulse | Multi-cohort read for a sector/theme concept | Semiconductors, banks, AI, energy |
stock_prices | Price context only for one ticker | Price-only questions |
stock_prices_batch | Price context for up to 50 tickers | Watchlist snapshot |
portfolio_pulse | News-driven pulse for your portfolio holdings | "How is my portfolio doing?" |
asset_pulse โ The full read on any company โญโ
The central tool. Call this whenever someone asks "how is X doing?" for a company, ETF, or crypto. It fans out to five sub-calls in parallel server-side and returns everything in one response:
- Price โ current level, 1wโ1y changes, distance from 52-week high (drawdown), realized vol percentile, volume conviction โ all with plain-language
*_readlabels - Impact โ recent news that moved the ticker: direction, impact channel (aspect), plain-language why
- Options โ what the US options market is pricing in: put/call lean, IV percentile, dealer gamma, max-pain level, notable expiries (~547 US-optionable names only)
- Relationships โ direct competitors and theme-based peers, to see if a move is sector-wide or company-specific
- Fundamentals โ revenue, margins, free cash flow, and auto-detected financial anomaly flags (common stocks only)
The key insight is synthesizing where these lenses agree or diverge โ strong news but options paying up for downside? That's the story.
Key params:
| Param | Description |
|---|---|
ticker | MarketIV format; use find_stock first if unsure. For a market index, use its liquid ETF proxy: S&P 500 โ SPY, Nasdaq 100 โ QQQ, Dow โ DIA, Russell 2000 โ IWM |
window | Scopes the news recency: 7d, 30d, 90d, 180d, 1y, mtd, qtd, ytd |
style | plain (default, layperson-friendly options narration) or technical |
:::info Cost
asset_pulse costs 5 credits โ 5 sub-calls bundled server-side.
:::
:::caution Not for commodities or bonds
- Gold, oil, copper, carbon โ use
commodity_pulse - US rates, JGBs, yield curve โ use
bond_pulse - Sectors/themes โ use
theme_pulse:::
commodity_pulse โ Gold, oil, copper, and moreโ
Same multi-lens structure as asset_pulse but tuned for commodities: price context, supply/demand news drivers, onshore vs offshore price divergence where relevant, and COT futures positioning.
The q parameter takes natural-language commodity names in any language:
| Input | What it resolves to |
|---|---|
"gold" / "เธเธญเธเธเธณ" / "้ป้" | GOLD.COMM |
"oil" / "crude" / "เธเนเธณเธกเธฑเธ" | WTI.COMM / BRENT.COMM |
"copper" / "เธเธญเธเนเธเธ" | COPPER.COMM / COPPER_CN.COMM |
"natural gas" | NATGAS.COMM |
"carbon" | CARBON_EU.COMM |
Some metals have both an LME (USD) and an onshore-China (CNY) contract โ returned separately when both are relevant.
:::info Cost
commodity_pulse costs 5 credits.
:::
bond_pulse โ Interest rates and yield curvesโ
For any question about government bond yields, interest rates, or the yield curve. Returns the full curve (2Y, 5Y, 10Y, 30Y), the 2s10s slope (negative = inverted = recession signal), rate-sensitive macro news, and options positioning on relevant bond ETFs.
Example inputs for q:
"US rates"/"US yield curve"/"US 10Y""JGB"/"Japan bonds"/"10-year JGB""Bund"/"German rates"/"ECB""UK gilts"/"SOFR"/"Fed funds rate"
Rate moves are narrated in basis points (not percentages) โ the correct convention for yield changes.
For rate forecasts, the tool also includes positioning on bond ETFs (TLT, IEF) showing what the options market is pricing in for future moves.
:::info Cost
bond_pulse costs 5 credits.
:::
theme_pulse โ Sector and theme concept readsโ
When the question is about a sector or theme concept rather than a specific company. Resolves the concept across three independent taxonomies and returns each cohort separately:
- MarketIV megatrend โ the curated thematic cohort
- GICS sector โ the official sector classification cohort
- ETF options โ options positioning on the most liquid sector/theme ETF (e.g. SMH for semiconductors)
Example q values: "semiconductors", "AI", "banks", "energy", "biotech", "clean energy", "EV".
Optional country scopes to one market (e.g. country="JP" for Japanese banks only).
:::info Cost
theme_pulse costs 5 credits.
:::
stock_prices โ Price context onlyโ
Returns the price picture for one ticker: current level, windowed returns (1w/1m/3m/6m/1y), 52-week range, drawdown from the peak, realized volatility percentile, and volume conviction โ all with pre-computed read labels. Also works for bonds (.GB), rates (.MM), and commodities (.COMM).
Use this when the question is purely about price โ not news or positioning.
stock_prices_batch โ Watchlist snapshotโ
Same as stock_prices but accepts up to 50 tickers at once. Returns results in input order plus an unresolved list for any tickers not found.
Useful for: "Show me prices for my tech watchlist" or "How are AAPL, MSFT, GOOGL, META doing today?"
portfolio_pulse โ Your portfolio in the newsโ
A news-driven read on your portfolio's holdings as a group โ which positions are in the news, direction of impact, and how the overall book looks from a sentiment angle.
Requires a portfolio_id โ use list_portfolios first if you don't have it. For a deeper numerical analysis (returns, attribution, drawdown, composition), use portfolio_context instead.
Routing guideโ
| Question | Tool |
|---|---|
| "How is NVDA / Apple / TSMC doing?" | asset_pulse |
| "How is gold / oil / copper looking?" | commodity_pulse |
| "What are US interest rates doing?" | bond_pulse |
| "How are semiconductors / banks as a sector?" | theme_pulse |
| "Price of AAPL / near its 52-week high?" | stock_prices |
| "Prices for my watchlist" | stock_prices_batch |
| "How is my portfolio doing?" | portfolio_pulse |