NythosX Market Data

Arm a price trigger with webhook delivery. Arms a single-fire price trigger. NythosX checks the price every minute and POSTs a JSON event to your HTTPS webhook on the first crossing: {event:"trigger.fired", id, symbol, direction, price, fired_price, fired_at}, signed with HMAC-SHA256 (header X-NythosX-Signature: sha256=<hex> over the raw body, key = returned secret). Retries up to 5 times (8s timeout per attempt, until your endpoint returns 2xx); after 5 failed attempts delivery is marked failed — check status free with get_trigger_status (REST: GET /api/v1/triggers/status?id=) to see delivery_attempts/last_error. Expires after ttl_hours (default 168, max 720); cancel any time before it fires, free, with disarm_price_trigger (REST: POST /api/v1/triggers/cancel with {id, secret}) — the arm fee is not refunded, it paid for the monitoring already done. Costs $0.02 USDC per call (x402).

Cancel a trigger armed with arm_price_trigger, before it fires (free). Requires both id and secret — the same token returned once at arm time and used to verify the webhook's HMAC signature — as proof of ownership. The $0.02 arm fee is not refunded; it paid for the monitoring already done. Returns 404 for an unknown id/secret pair, 409 if the trigger already fired or was already cancelled.

Market regime (trend, volatility, RSI, ATR%) and nearest support/resistance for BTC and ETH only, refreshed every 15 minutes (free). Returns {price, regime, nearestSupport, nearestResistance}. Pick this over the paid siblings when you just need a quick read on BTC/ETH; use get_signal_bias ($0.01) for a trade direction, get_trade_plan ($0.03) for full setup levels and odds, or get_market_regime/get_support_resistance ($0.005 each) for other symbols or deeper history.

Trend and volatility regime. Market regime from the last 24 hours of hourly candles (cached 5 minutes): trend (up / down / range, EMA50 vs EMA200), volatility bucket (low / normal / high / extreme by ATR%), RSI, EMAs. Use this for risk sizing or entry timing (e.g. avoid new entries while volatility is 'extreme') alongside get_signal_bias for direction and get_support_resistance for levels — on its own it gives context, not a trade direction. symbol uses the same trend/volatility thresholds for every instrument, so regime readings are directly comparable across symbols (e.g. BTC 'high' and SOL 'high' mean the same ATR% bucket). Costs $0.005 USDC per call (x402).

Signal bias with setup levels and invalidation. Rules-based bias (bullish/lean_bullish/neutral/lean_bearish/bearish) with score, confidence, setup, weighted factors, invalidation. tf sets candle size and lookback (5m=1H to 1w=1Y): shorter is faster but noisier, longer is slower but higher-conviction. Accuracy free at /api/v1/track-record. Quick direction + one setup; get_trade_plan ($0.03) adds target-before-stop odds, get_market_regime ($0.005) is trend/volatility only. Costs $0.01 USDC per call (x402).

Support and resistance map. Up to five support and five resistance levels from clustered daily swing pivots, high-volume nodes and round numbers, each with kind, strength (1-5) and touch count, plus the nearest level on each side. Computed from the last 30 daily candles (cached 15 minutes). Use nearestSupport/nearestResistance as stop-loss/take-profit anchors for a position already open; higher strength and touch count mean a more reliable level. Costs $0.005 USDC per call (x402).

Probability of reaching a target price. Probability that the price closes beyond a target within 1, 7 and 30 days, and the approximate probability of touching it, from 14-day ATR volatility (normal approximation; touch ~ 2x close-beyond by the reflection principle). symbol must be one of the supported list (see list_symbols) and target must be a positive number, or the call returns 400 and is not charged; if volatility can't be computed from recent candles it returns 502 and is not charged. Costs $0.005 USDC per call (x402).

Graded accuracy of every published signal bias: hit rate by confidence, bias and symbol, Wilson intervals, Brier score, independent samples (free, cached 15 min, one full report per call — no pagination). Omit symbol for the all-symbols report; pass it to filter to one instrument. Check this before paying for get_signal_bias, to see whether its track record supports trusting the call. Returns 404 if nothing has been graded yet for that filter.

Complete trade setup in one call. Bundles signal bias, regime, levels, setup (entry, stop, target, R:R), odds of target-before-stop and of touching target within 7 days, time-to-target, invalidation, and track record. tf sets candle size and lookback (5m=1H to 1w=1Y); shorter is faster but noisier. Neutral bias returns odds of hitting resistance before support. For one piece only, call get_signal_bias ($0.01) or get_market_regime ($0.005) — cheaper. Costs $0.03 USDC per call (x402).

Status of a trigger armed with arm_price_trigger (free). Returns {id, status, symbol, direction, price, created_at, expires_at, fired_at, fired_price, delivered_at, cancelled_at, delivery_attempts, last_error}, where status is one of armed, fired_delivering, delivered, delivery_failed (after 5 webhook attempts), expired or cancelled (via disarm_price_trigger). Returns 404 if id is unknown or its payment never settled.

List supported symbols, timeframes, the per-call USDC price of each paid tool (not asset prices — call get_signal_bias etc. for those), and the payment network (free, read-only, no auth required, no extra rate limit). Returns {symbols, timeframes, network, networks, asset, free: [tool names], tools: [{name, price}], docs}.