Financial Analysis x402 offerings

Provides a market overview snapshot with key market metrics and trends.

Real-time US stock & crypto price snapshots with 24h change, 52-week highs/lows and data source. Use when an agent needs current market prices for a whitelisted symbol such as NVDA, BTC or NEAR. Pay $0.001 USDC per call on Base mainnet.

Delivers a concise recap of current market conditions and key movements.

Market risk sentiment in one call, live from FRED: volatility index (VIX), high-yield and investment-grade credit spreads, financial conditions index, US dollar strength, and WTI crude oil price — the 6 metrics that flag systemic risk and market-wide stress. Replaces 6 separate FRED lookups for traders monitoring macro volatility and risk-off sentiment. Not ticker-specific. $0.01/call.

Market risk sentiment in one call, live from FRED: volatility index (VIX), high-yield and investment-grade credit spreads, financial conditions index, US dollar strength, and WTI crude oil price — the 6 metrics that flag systemic risk and market-wide stress. Replaces 6 separate FRED lookups for traders monitoring macro volatility and risk-off sentiment. Not ticker-specific. $0.01/call.

Trading decision for a crypto asset or stock ($1): every dataset (order flow, technicals, smart money, SEC fundamentals, insiders, perp positioning, market risk, news) aggregated by rules into an action with conviction, evidence per pillar, a volatility-sized trade plan and what would change the view. Free live hit rate at /api/v1/decision/track-record. No symbol = market-wide stance.

Institutional investor SEC Form 13F filings. Look up any institution by CIK or name to get their latest 13F filing date and link.

Recent earnings announcements from SEC EDGAR Form 8-K filings. Search by company or get all earnings in past N days.

Economic event calendar from FRED with sector performance from FMP. Upcoming key economic releases.

Financial news with sentiment analysis from Marketaux. Per-symbol sentiment aggregation.

Real-time arbitrage spreads between tokenized securities and actual stock prices. Identify premium/discount opportunities.

Analyst stock ratings and price targets from Finnhub. Consensus recommendations (Strong Buy, Buy, Hold, Sell) with analyst price target distribution.

Returns historical price data for assets.

Natural Language Query — ask a market question in plain English. HOW TO CALL: POST /analyze?question=what+moved+today POST /analyze?question=is+NVDA+overvalued POST /analyze?question=options+for+SPY POST /analyze?question=give+me+a+daily+brief PARAMETERS: question — natural language query (required) SUPPORTED INTENTS: • Market movers: 'what moved today?', 'top gainers' • Fear & Greed: 'how's market sentiment?', 'fear greed index' • Fundamentals: 'is AAPL overvalued?', 'NVDA margins' • Options: 'options for SPY', 'put/call ratio TSLA' • Calendars: 'earnings today', 'macro events this week' • Daily brief: 'morning summary', 'daily digest' • Price: 'AAPL price', 'what is SPY trading at' RESPONSE: { question, intent, insight (1-sentence summary), data (raw endpoint output) } PRICING: $0.05 per call.

Live Signals — the current call on any asset you name. HOW TO CALL: GET /api/signals/live?assets=BTC,ETH,xyz:NVDA PARAMETERS: assets — comma-separated tickers (required) limit — log rows to scan, 1–200 (default 50) RESPONSE: signals[] — direction, confidence, suggested size (kelly_half), entry/exit price, and how it resolved if the horizon has passed. PRICING: $0.10 per call.

Company Fundamentals — comprehensive financial metrics for any stock ticker. HOW TO CALL: POST /get_fundamentals?ticker=AAPL PARAMETERS: ticker — stock symbol (required, e.g. 'AAPL', 'MSFT', 'NVDA') RESPONSE SECTIONS: valuation — market_cap, P/E, P/B, P/S, EV/EBITDA, PEG profitability — gross/operating/net margin, ROE, ROA, EBITDA growth — revenue_growth, earnings_growth (YoY) per_share — EPS (TTM + forward), book value, revenue per share dividends — yield, rate, payout ratio, ex-date balance_sheet — total cash/debt, D/E ratio, current & quick ratio price_stats — 52-week high/low, 50/200d MA, beta, short interest analyst — recommendation, price target (mean/high/low) revenue_annual_B / net_income_annual_B — last 4 years, in billions Cached 24 hours. PRICING: $0.02 per call.

Economic Calendar — macro events (CPI, Fed meetings, NFP, GDP, PMI, etc.). HOW TO CALL: POST /get_economic_calendar?period=this_week&currencies=USD,EUR&importance=high PARAMETERS: period — 'today' | 'tomorrow' | 'this_week' (default) | 'next_week' | 'this_month' currencies — comma-separated codes: USD, EUR, GBP, JPY, CNY, AUD, CAD, CHF, etc. (default: USD,EUR,GBP,JPY) importance — comma-separated: 'high', 'medium', 'low' (default: all three) RESPONSE FIELDS (per event): date, time (UTC), currency, impact, event, actual, forecast, previous Source: Investing.com AJAX; serves stale cache if live fetch fails. Cached 6 hours. PRICING: $0.02 per call.

Hardware Price Index — daily-refreshed CPU and GPU price data. Returns two data layers: 1. hardware_prices — retail prices scraped from PCPartPicker, bucketed by tier (budget / mid-range / high-end). Null if scraping is unavailable. 2. market_index — live semiconductor stock prices (NVDA, AMD, INTC) as a market-sentiment proxy. Always available via yfinance. HOW TO CALL: POST /get_hardware_prices?category=gpu PARAMETERS: category — 'cpu', 'gpu', or 'all' (returns both) CPU tier thresholds: budget <$150 | mid $150–$350 | high >$350 GPU tier thresholds: budget <$300 | mid $300–$600 | high >$600 RESPONSE: { date, category, fetched_at, cached, market_index, hardware_prices } Data is cached for 24 hours (daily refresh). PRICING: $0.03 per call.

Signal History — full log of every signal fired, with outcomes. Shows internal algo signals and x402 API signals. Pending signals (horizon not yet reached) show actual_return_pct=null. HOW TO CALL: GET /trading/signals/history GET /trading/signals/history?ticker=BTC&source=internal&limit=20 PARAMETERS: ticker — filter to one ticker (optional) limit — max rows (default 50, max 200) source — 'internal' | 'x402' (optional) include_pending — include unresolved signals (default true) PRICING: $0.05 per call.

Rolling return correlation matrix for a list of tickers. Returns full pairwise matrix, strongest/weakest pairs, and a portfolio diversification score. Use before building a playbook to validate peer independence, or to check hedge ratios. PARAMS: tickers — comma-separated symbols (2–20), e.g. NVDA,AMD,MSFT,QQQ period — '30d' | '90d' | '6mo' | '1y' | '2y' | '3y' (default '1y') method — 'pearson' | 'spearman' (default 'pearson') POST /correlation_matrix?tickers=NVDA,AMD,MSFT,QQQ&period=1y PRICING: $0.05 per call.

Narrative — price momentum + live news sentiment + theme tag for one asset. HOW TO CALL: GET /api/narrative?ticker=NVDA PARAMETERS: ticker — asset symbol (required) RESPONSE: price_action{momentum,trend,direction}, news{sentiment,rating,headline}, themes[]. PRICING: $0.05 per call.

Portfolio Factors — what your book is actually exposed to. The momentum and trend you are carrying, and how much of your risk is really just the S&P or really just bitcoin. HOW TO CALL: GET /api/portfolio-factors?holdings=xyz:NVDA:1000,BTC:500 PARAMETERS: holdings — TICKER:weight pairs, HL-format tickers (required) lookback — estimation window in days, 60–250 (default 120) RESPONSE: notional-weighted momentum, trend, book beta to S&P 500 and BTC. PRICING: $0.05 per call.

Pattern Backtest — systematically scan all historical windows matching a return profile. Answers: 'every time {ticker} did X% over {N} days, what happened in the next {M} days?' HOW TO CALL: POST /pattern_backtest?ticker=SPY&lookback_days=20&min_return=-0.05&max_return=0.0&forward_days=30 PARAMETERS: ticker — asset symbol (required) lookback_days — window length to scan (default 20) min_return — minimum window return, decimal (e.g. -0.05 = -5%; default: no bound) max_return — maximum window return, decimal (e.g. 0.10 = +10%; default: no bound) forward_days — forward horizon to measure (default 30) RESPONSE: occurrences (count of matching windows), forward_return_distribution (p10/p25/p50/p75/p90 + mean/stdev/pct_positive), example_windows. PRICING: $0.50 per call.

Pattern Machine Raw — cheapest tier. Same motif search as /get_patterns but returns only the matched dates, closes, and similarity scores. No forward-return statistics are computed. Use this for high-volume scanning or when you only need raw analog windows. HOW TO CALL: POST /get_patterns_raw?ticker=AAPL&start_date=2024-01-02&end_date=2024-03-01&k=5&metric=l2&wrap=true&timeframe=1d PARAMETERS: ticker — asset symbol (e.g. AAPL, BTC-USD, SPY) start_date — query window start, inclusive (YYYY-MM-DD) end_date — query window end, exclusive (YYYY-MM-DD); must be > start_date k — number of analog patterns to return (default 3) metric — distance metric: 'l1' (Manhattan) or 'l2' (Euclidean, default) wrap — allow circular search across the full history (default true) timeframe — bar size: '1d' (default), '1h', '30m', '15m', etc. RESPONSE FIELDS (per match): dates — list of bar dates for the analog window closes — list of closing prices for the analog window similarity — normalized distance score (lower = closer match) query_return — total return of your query window (%) description — human-readable label