{"name":"NythosX Market Data","description":"Derived market analytics for AI agents, paid per request in USDC via x402: complete trade setups, signal bias with invalidation, support/resistance, regime, target-hit probabilities and webhook price triggers, with a free, publicly graded track record. Crypto (BTC, ETH, SOL, BNB, XRP, ADA, LTC, XDC), US stocks (NVDA, MSFT, AMZN, AAPL) and USD/PHP.","protocol":"x402","x402Version":2,"network":"eip155:8453","networks":["eip155:8453"],"testnet":false,"asset":"USDC","payTo":"0x803522D25f7B6f2E6Df006650CDc032e644057a2","docs":"https://market.nythosx.com/docs/api","openapi":"https://market.nythosx.com/openapi.json","mcp":{"url":"https://market.nythosx.com/mcp","transport":"streamable-http","payment":"x402 via _meta[\"x402/payment\"]"},"symbols":["BTC","SOL","ETH","BNB","LTC","ADA","XRP","XDC","NVDA","MSFT","AMZN","AAPL","USDPHP"],"timeframes":["5m","1h","4h","1d","1w"],"endpoints":[{"method":"GET","url":"https://market.nythosx.com/api/v1/advisor","price":"$0.01","summary":"Signal bias with setup levels and invalidation","description":"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.","params":{"symbol":{"type":"string","description":"Instrument symbol, case-insensitive. Must be one of the enum values below; an unsupported symbol returns 400 before any payment is charged.","enum":["BTC","SOL","ETH","BNB","LTC","ADA","XRP","XDC","NVDA","MSFT","AMZN","AAPL","USDPHP"],"required":true},"tf":{"type":"string","description":"Candle timeframe. Sets both the candle size and the lookback window analyzed: 5m=1H, 1h=24H, 4h=7D, 1d=30D, 1w=1Y.","enum":["5m","1h","4h","1d","1w"],"default":"4h"}},"body":null,"example":{"symbol":"BTC","tf":"4h"},"sample":"https://market.nythosx.com/api/v1/sample?endpoint=advisor"},{"method":"GET","url":"https://market.nythosx.com/api/v1/trade-plan","price":"$0.03","summary":"Complete trade setup in one call","description":"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.","params":{"symbol":{"type":"string","description":"Instrument symbol, case-insensitive. Must be one of the enum values below; an unsupported symbol returns 400 before any payment is charged.","enum":["BTC","SOL","ETH","BNB","LTC","ADA","XRP","XDC","NVDA","MSFT","AMZN","AAPL","USDPHP"],"required":true},"tf":{"type":"string","description":"Candle timeframe. Sets both the candle size and the lookback window analyzed: 5m=1H, 1h=24H, 4h=7D, 1d=30D, 1w=1Y.","enum":["5m","1h","4h","1d","1w"],"default":"4h"}},"body":null,"example":{"symbol":"ETH","tf":"4h"},"sample":"https://market.nythosx.com/api/v1/sample?endpoint=trade-plan"},{"method":"GET","url":"https://market.nythosx.com/api/v1/levels","price":"$0.005","summary":"Support and resistance map","description":"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.","params":{"symbol":{"type":"string","description":"Instrument symbol, case-insensitive. Must be one of the enum values below; an unsupported symbol returns 400 before any payment is charged.","enum":["BTC","SOL","ETH","BNB","LTC","ADA","XRP","XDC","NVDA","MSFT","AMZN","AAPL","USDPHP"],"required":true}},"body":null,"example":{"symbol":"ETH"},"sample":"https://market.nythosx.com/api/v1/sample?endpoint=levels"},{"method":"GET","url":"https://market.nythosx.com/api/v1/regime","price":"$0.005","summary":"Trend and volatility regime","description":"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).","params":{"symbol":{"type":"string","description":"Instrument symbol, case-insensitive. Must be one of the enum values below; an unsupported symbol returns 400 before any payment is charged.","enum":["BTC","SOL","ETH","BNB","LTC","ADA","XRP","XDC","NVDA","MSFT","AMZN","AAPL","USDPHP"],"required":true}},"body":null,"example":{"symbol":"SOL"},"sample":"https://market.nythosx.com/api/v1/sample?endpoint=regime"},{"method":"GET","url":"https://market.nythosx.com/api/v1/probability","price":"$0.005","summary":"Probability of reaching a target price","description":"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.","params":{"symbol":{"type":"string","description":"Instrument symbol, case-insensitive. Must be one of the enum values below; an unsupported symbol returns 400 before any payment is charged.","enum":["BTC","SOL","ETH","BNB","LTC","ADA","XRP","XDC","NVDA","MSFT","AMZN","AAPL","USDPHP"],"required":true},"target":{"type":"number","description":"Target price in the instrument's quote currency","required":true}},"body":null,"example":{"symbol":"BTC","target":"90000"},"sample":"https://market.nythosx.com/api/v1/sample?endpoint=probability"},{"method":"POST","url":"https://market.nythosx.com/api/v1/triggers","price":"$0.02","summary":"Arm a price trigger with webhook delivery","description":"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.","params":null,"body":{"type":"object","required":["symbol","direction","price","webhook_url"],"properties":{"symbol":{"type":"string","enum":["BTC","SOL","ETH","BNB","LTC","ADA","XRP","XDC","NVDA","MSFT","AMZN","AAPL","USDPHP"]},"direction":{"type":"string","enum":["above","below"]},"price":{"type":"number","exclusiveMinimum":0},"webhook_url":{"type":"string","format":"uri","description":"Public HTTPS URL"},"ttl_hours":{"type":"integer","minimum":1,"maximum":720,"default":168}}},"example":{"symbol":"BTC","direction":"below","price":78000,"webhook_url":"https://example.com/hooks/nythosx","ttl_hours":168},"sample":null}],"free":[{"method":"GET","url":"https://market.nythosx.com/api/v1/track-record?symbol={symbol}","summary":"Graded accuracy of every published bias (symbol optional)"},{"method":"GET","url":"https://market.nythosx.com/api/v1/snapshot?symbol={BTC|ETH}","summary":"Regime and nearest support/resistance for BTC and ETH, refreshed every 15 minutes"},{"method":"GET","url":"https://market.nythosx.com/api/v1/triggers/status?id={id}","summary":"Trigger status"},{"method":"POST","url":"https://market.nythosx.com/api/v1/triggers/cancel","summary":"Cancel an armed trigger before it fires (body: {id, secret})"},{"method":"GET","url":"https://market.nythosx.com/api/public/market-pulse","summary":"Crypto tape, macro and USD/PHP (raw, rate-limited)"},{"method":"GET","url":"https://market.nythosx.com/api/public/candles?symbol=BTCUSDT&tf=24H","summary":"Raw candles (rate-limited)"}],"disclaimer":"Informational analytics generated by rules and statistics, not investment advice. Past accuracy does not guarantee future results. You are responsible for your own decisions."}