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. Paid in USDC over x402 or MPP; this pack has no proof-of-work tier.
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.
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, consolidated volume, previous close and the change between them. US equities only; indices, FX and crypto are not covered (crypto-price serves those). Built from the official consolidated end-of-day summary across all US exchanges and ATSs, so price, range and volume are market totals. If that dataset is unavailable for a read, the answer comes from a consolidation of three U.S. exchange venues instead and says so: coverage reads three-venue, venueVolume counts those venues only and volume is null. No 52-week range and no intraday print: for a date range call stock-history. Each answer names its dataset and coverage, and says whether its bars came from this session's cache (cached, fetchedAt).
- 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 the official consolidated end-of-day summary across all US exchanges and ATSs, so price, range and volume are market totals. If that dataset is unavailable for a read, the answer comes from a consolidation of three U.S. exchange venues instead and says so: coverage reads three-venue, venueVolume counts those venues only and volume is null. On that fallback each bar's high and low are the extremes across the three venues and open and close come from the venue that traded the most that session. 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 consolidated volume (the answer's coverage field says when a read fell back to three venues).
- 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. With the agent402-client SDK (npm i agent402-client, an ES module):
import { Agent402 } from "agent402-client";
// payFetch: an x402-wrapped fetch your wallet signs (@x402/fetch).
// Tools on the free tier need no options: new Agent402() pays them by proof-of-work.
// an existing prepaid credits key also works: new Agent402({ creditsKey })
const client = new Agent402({ fetch: payFetch });
const result = await client.call("skill-financial-analysis", {"ticker":"AAPL"});Run it in Claude
claude mcp add agent402 -s user -- npx -y agent402-mcp@0.13.32
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.