Financial Analysis x402 offerings

Trading Signal — one ticker in, one decision out. Which way, how sure, how much, and where to get out — with the historical record, market backdrop and current news behind it, so you can weigh the call. HOW TO CALL: POST /trading/signal?ticker=BTC POST /trading/signal?ticker=AAPL&timeframe=1d&lookback_days=30 PARAMETERS: ticker — asset symbol, e.g. BTC, ETH, AAPL, SPY (required) timeframe — '1d' (default) lookback_days — pattern window in days (default 20) RESPONSE: direction — 'long' | 'short' | 'flat' confidence — 0.0–1.0, how strong the case is kelly_half — suggested position size as a fraction of capital (0.0–1.0) narrative — plain-language summary of why, and whether the call was suppressed forward_stats — what happened after comparable setups: win rate, median, tails PRICING: $0.10 per call.

Earnings surprise history — EPS beat/miss magnitude and immediate stock price reaction. Returns per-quarter history plus summary: beat rate, avg reaction on beats vs misses, high-volatility-event flag, and buy-dip signal. PARAMS: ticker — stock symbol (e.g. AAPL, NVDA, MSFT) last_n — number of past quarters to analyze (default 8) POST /earnings_surprise?ticker=AAPL&last_n=8 PRICING: $0.05 per call.

Options Chain — full calls and puts for a ticker and expiration date. HOW TO CALL: POST /get_options_chain?ticker=AAPL POST /get_options_chain?ticker=AAPL&expiration=2026-07-18 PARAMETERS: ticker — stock symbol (required) expiration — expiration date 'YYYY-MM-DD' (default: nearest available) RESPONSE FIELDS: available_expirations — all available expiry dates spot_price — current underlying price atm_implied_volatility — avg IV of contracts within 5% of spot put_call_ratio — total put OI / total call OI calls / puts — arrays of: strike, bid, ask, lastPrice, volume, openInterest, impliedVolatility, inTheMoney Cached 1 hour. PRICING: $0.05 per call.

Earnings Surprise — beat/miss history, price reaction, consistency signals. HOW TO CALL: GET /api/earnings-surprise?ticker=NVDA&periods=8 PARAMETERS: ticker — stock ticker (required) periods — quarters to analyze, 4–20 (default 8) RESPONSE: beat_rate, avg surprise, per-quarter reactions, signals{consistent_beater,…}. PRICING: $0.02 per call.

Backtest — "this has happened before; what happened next?" Finds every prior stretch of history that looked like the ticker's recent shape and reports where those went. HOW TO CALL: GET /api/backtest?ticker=BTC&lookback_days=20&forward_days=30 PARAMETERS: ticker — asset symbol (required) lookback_days — pattern window, 5–60 (default 20) forward_days — forward horizon, 7–90 (default 30) min_return / max_return — optional analog filters (fraction) RESPONSE: win rate, median, tails, sample size over the forward horizon. PRICING: $0.10 per call.

Playbook — cross-asset signal propagation. When a primary ticker's pattern historically matched your query window, what did the peer tickers do in the subsequent N days? Answers: 'when NVDA looked like this, what did MSFT / AMD / QQQ do?' HOW TO CALL: POST /playbook?ticker=NVDA&start_date=2025-11-01&end_date=2026-01-15&peers=MSFT,AMD,QQQ PARAMETERS: ticker — primary ticker (required) start_date — pattern window start (YYYY-MM-DD) end_date — pattern window end (YYYY-MM-DD) peers — comma-separated peer tickers, max 10 (required) k — number of analogs to average (default 10) forward_days — forward horizon in trading days (default 30) RESPONSE: peer_playbook — per-peer: avg_return_pct, pct_positive, count, returns_per_analog. PRICING: $0.50 per call.

Pattern Machine — vectorized time series motif search. Given a query window (ticker + date range), finds the top-k closest historical price patterns using normalized L1/L2 distance. Returns matched pattern dates, closes, similarity scores, and aggregated 7-day and 30-day forward return statistics. HOW TO CALL: POST /get_patterns?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 summary — avg 7-day and 30-day forward returns across all matches PRICING: $0.25 per call.

Pattern Machine OHLC — same vectorized motif search as /get_patterns, but returns full Open/High/Low/Close candlestick data for each matched pattern. Use this endpoint when you need to render candlestick charts of historical analogs. HOW TO CALL: POST /get_patterns_ohlc?ticker=AAPL&start_date=2024-01-02&end_date=2024-03-01&k=5&metric=l2&wrap=true&timeframe=1d PARAMETERS: identical to /get_patterns (ticker, start_date, end_date, k, metric, wrap, timeframe). RESPONSE FIELDS (per match): pattern_id — rank of this analog (1 = closest) dates — list of bar dates for the analog window opens — list of open prices highs — list of high prices lows — list of low prices closes — list of closing prices similarity — normalized distance score (lower = closer match) query_return — total return of your query window (%) description — human-readable label TOP-LEVEL RESPONSE FIELDS: ticker, start_date, end_date, timeframe, query_return, patterns[]

Portfolio Optimizer — Markowitz mean-variance optimization for a basket of assets. HOW TO CALL: POST /optimize_portfolio?tickers=AAPL,MSFT,NVDA,SPY&period=1y&objective=max_sharpe PARAMETERS: tickers — comma-separated list of 2–30 ticker symbols (required) period — historical window: '6mo' | '1y' (default) | '2y' | '3y' | '5y' objective — 'max_sharpe' (default) | 'min_volatility' | 'max_return' risk_free_rate — annual risk-free rate for Sharpe ratio (default: 0.04) RESPONSE FIELDS: allocation — {ticker: weight} dict, weights sum to 1.0 metrics — expected_annual_return, annual_volatility, sharpe_ratio benchmark_equal_weight — same metrics for a naive equal-weight portfolio correlation_matrix — pairwise return correlations Cached 6 hours per (tickers, period, objective). PRICING: $0.10 per call.

Sector Momentum — which parts of the market are working right now. 11 GICS sectors plus cross-cutting themes, ranked hottest first, each with the names leading it. Leaders are flagged when they are tradable as a perp. HOW TO CALL: GET /api/sectors/momentum?lookback=60 PARAMETERS: lookback — momentum window in trading days, 20–250 (default 60) RESPONSE: sectors[] ranked hottest-first, each with momentum, trend, breadth, leaders[]. PRICING: $0.05 per call.

Pattern Screener — scan up to 50 tickers in a single call and rank them by how closely their current price action matches historical patterns. Returns tickers ranked by similarity (best match first) with the top analog start date and query window return. Ideal for portfolio monitoring agents and quant bots that need to sweep a universe of symbols. HOW TO CALL: POST /screen?tickers=AAPL,MSFT,GOOGL,SPY,QQQ&start_date=2025-03-01&end_date=2025-06-01 PARAMETERS: tickers — comma-separated symbols, max 50 (e.g. AAPL,MSFT,BTC-USD,SPY) start_date — query window start, inclusive (YYYY-MM-DD) end_date — query window end, exclusive (YYYY-MM-DD) timeframe — bar size: '1d' (default), '1h', '30m', '15m' metric — distance metric: 'l1' or 'l2' (default) sort_by — 'similarity' (default, lower = better match) or 'return' RESPONSE: { screened, results: [{ ticker, similarity, query_return, top_match_start, status }] } Results are sorted ascending by similarity. Tickers that fail (bad symbol, no data) appear at the end with status='error'. PRICING: $0.25 flat for up to 50 tickers — vs $2.50 calling /get_patterns_raw individually.

Forward Distribution — full probabilistic return forecast from historical analogs. Finds the top-k closest historical analogs for a pattern window, then computes the P10/P25/P50/P75/P90 percentile distribution of forward returns at 7, 14, 30, 60 days. Answers: 'given that the price behaved this way, what is the distribution of outcomes?' HOW TO CALL: POST /forward_distribution?ticker=SPY&start_date=2026-04-01&end_date=2026-06-01 PARAMETERS: ticker — asset symbol (required) start_date — query window start (YYYY-MM-DD) end_date — query window end (YYYY-MM-DD) k — analogs to sample (default 20; higher = richer distribution) metric — 'l1' or 'l2' (default) RESPONSE: distributions keyed by '7d', '14d', '30d', '60d' each with p10/p25/p50/p75/p90, mean, stdev, min, max, pct_positive, count. PRICING: $0.25 per call.

Trading Scan — the whole universe in one call, best setups first. Crypto and equities scanned together, ranked by strength of edge. Everything that failed the bar is dropped rather than returned as noise. HOW TO CALL: POST /trading/scan?top_n=5 PARAMETERS: top_n — max results to return (default 5, max 10) RESPONSE: signals[] — [{ticker, direction, confidence, kelly_half, score, narrative}] kelly_half = suggested size as a fraction of capital scanned — number of tickers evaluated found — number of setups above threshold PRICING: $0.10 per call.

Reads the liquidation orders OKX publishes for its perpetual swaps, converts every entry into US dollars with the contract size of that instrument and the bankruptcy price of that event, and sums the…

Answers the timing question an agent has before it schedules anything against a regulated exchange: is the main session running, and if not, when does it start. Covers XETR, XFRA, XNYS, XNAS, XLON, X…

Japan retirement income tax: deduction by years of service, half-taxation with short-term/officer exceptions, exact withholding rounding (1-yen floor), resident tax 6+4 percent split. $0.02/call.

Japan net salary calculator for AI agents: annual gross to take-home pay (social insurance + income tax incl. reconstruction surtax + resident tax with adjustment credit). Exact NTA Beppyo-5 table, official Kyokai-Kenpo FY2026 rates, cited primary sources, deterministic. $0.02/call.

Japan crypto-asset tax: realized income under the NTA total-average or moving-average method (sell/spend/exchange as disposals, fees deductible, opening balances). Verified against the official NTA FAQ examples to the yen. Max 300 transactions per call. $0.05/call.

Japan payslip audit: recompute statutory premiums and withholding tax from official tables and diff against the actual amounts. Per-item verdicts (match/explainable/mismatch) that explain grade revisions and combined care-premium notation instead of crying wolf. $0.02/call.

Japan payroll suite in one call: net salary + social insurance detail + income-wall analysis (+bonus withholding when previous-month salary given). Flat $0.05/call.

Invoice field verification for AI agents: arithmetic consistency of invoice fields, line-item totals, JP registration number check-digit + corporate-number existence observation (official NTA registry), accounting JSON. $0.015/call.

Japan bonus net pay: social insurance premiums and withholding tax from the official bonus rate table (needs previous-month salary). Deterministic, cited sources. $0.01/call.

Japan social insurance premiums: monthly remuneration to grade + health/care/pension/employment premiums from the official Kyokai-Kenpo FY2026 grade table, all 47 prefectures, official rounding. $0.01/call.

Mortgage schedules: level-payment/level-principal, total interest, prepayment effect (term-reduction or payment-reduction). Deterministic annuity math. $0.005/call.