Financial analysis
Quick company snapshot: latest close, 9 key financial metrics (revenue through cash flow), and upcoming earnings - one call, one payment.
3 tools run server-side in one request. You pay once, settle once, and get a single response - no orchestration, no per-step payments, and a partial-success envelope if any step fails. USDC over x402 on any supported chain.
When to use this pack
An agent needs to answer 'how is this company doing?' without knowing XBRL tags or juggling 3 separate API calls. The $0.04 bundle is cheaper than calling the tools individually ($0.045).
Tools in this pack
All 3 run inside the single $0.024 call above. Each is also callable on its own if you only need one part.
- Stock quote GET /api/stock-quote End-of-day US equity quote: last close, day range, previous close and the change between them. US equities only; indices, FX and crypto are not covered (crypto-price serves those). Built from a three-venue consolidation (Databento DBEQ.BASIC), so the prices track the wider market but the volume counts those three venues only and is returned as venueVolume rather than as a total. No 52-week range and no intraday print: for a date range call stock-history.
- Company financials summary GET /api/company-financials Key financial metrics (Revenue, Net Income, Operating Income, Total Assets, Liabilities, Equity, EPS, Operating Cash Flow) for a US public company in one call. Returns the latest annual and quarterly values from SEC XBRL filings. No XBRL knowledge needed - just pass a ticker. ?ticker=AAPL
- Stock historical bars GET /api/stock-history Daily OHLCV bars for a US equity: the last `days` sessions, 1 to 250, default 30. Daily only, no intraday. Built from a three-venue consolidation (Databento DBEQ.BASIC), so each bar's high and low are the extremes across those venues, open and close come from the venue that traded the most that session, and venueVolume sums those three venues rather than the consolidated tape. A flat ascending array ready for charting or backtests. Set indicators to also get technical analysis computed from the same bars: RSI(14), MACD(12,26,9), EMA 20/50/200, SMA 20/50, Bollinger(20,2) and ATR(14), with a plain summary (close vs EMA50, RSI zone, MACD cross). Indicators need enough sessions (EMA200 needs days >= 200) and are descriptive, not a trading recommendation.
Bought one at a time, these 3 tools cost $0.026 together; the pack is that sum less a 10% bundle discount, rounded up to the $0.001 settlement floor, which is $0.024.
Workflow
- Get the latest close from stock-quote - price, day range, change vs the previous close, and venue volume (three venues, not the market total).
- Pull key financials from company-financials - revenue, net income, operating income, total assets, liabilities, equity, EPS, and operating cash flow from the latest annual and quarterly SEC filings.
- Pull the price history from stock-history - how the quote sits against recent trading rather than on its own.
Arguments
| Name | Required | Description | Example |
|---|---|---|---|
ticker | yes | Stock ticker symbol (e.g. AAPL, MSFT, NVDA) | AAPL |
What one call returns
A JSON object with pack, args, steps, summary; steps holds one entry per tool (stock-quote, company-financials, stock-history), each with its own result or error. Full example on the API page.
Call it directly
Any x402 client pays the 402 and gets the whole workflow back in one response:
npx agent402-client call financial-analysis {"ticker":"AAPL"}
Run it in Claude
claude mcp add agent402 -s user -- npx -y agent402-mcp@latest
Then paste this prompt into Claude:
Give me a quick financial snapshot of AAPL. Use Agent402's financial-analysis skill pack to get the current quote, key financial metrics (revenue, net income, EPS, cash flow), and any upcoming earnings. Summarize in a few bullet points.