arm_price_trigger

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 — poll status free at GET /api/v1/triggers/status?id= to see delivery_attempts/last_error. Expires after ttl_hours (default 168, max 720). Costs $0.02 USDC per call (x402).

Argument	Type	Description
price*	number
symbol*	string	Instrument symbol
direction*	string
ttl_hours	integer
webhook_url*	string	Public HTTPS URL that receives the signed trigger.fired event

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "symbol",
    "direction",
    "price",
    "webhook_url"
  ],
  "properties": {
    "price": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "symbol": {
      "enum": [
        "BTC",
        "SOL",
        "ETH",
        "BNB",
        "LTC",
        "ADA",
        "XRP",
        "XDC",
        "NVDA",
        "MSFT",
        "AMZN",
        "AAPL",
        "USDPHP"
      ],
      "type": "string",
      "description": "Instrument symbol"
    },
    "direction": {
      "enum": [
        "above",
        "below"
      ],
      "type": "string"
    },
    "ttl_hours": {
      "type": "integer",
      "maximum": 720,
      "minimum": 1
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "description": "Public HTTPS URL that receives the signed trigger.fired event"
    }
  },
  "additionalProperties": false
}

get_free_snapshot

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.

Argument	Type	Description
symbol*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "symbol"
  ],
  "properties": {
    "symbol": {
      "enum": [
        "BTC",
        "ETH"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_market_regime

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. Costs $0.005 USDC per call (x402).

Argument	Type	Description
symbol*	string	Instrument symbol

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "symbol"
  ],
  "properties": {
    "symbol": {
      "enum": [
        "BTC",
        "SOL",
        "ETH",
        "BNB",
        "LTC",
        "ADA",
        "XRP",
        "XDC",
        "NVDA",
        "MSFT",
        "AMZN",
        "AAPL",
        "USDPHP"
      ],
      "type": "string",
      "description": "Instrument symbol"
    }
  },
  "additionalProperties": false
}

get_signal_bias

Signal bias with setup levels and invalidation. Rules-based signal bias (bullish / lean_bullish / neutral / lean_bearish / bearish) with score, confidence, setup levels (entry, stop, target, risk-reward), weighted factors (trend, RSI, ATR, ADX, divergences, candle patterns, macro regime) and explicit invalidation conditions. Same output for every caller; accuracy is published free at /api/v1/track-record. Costs $0.01 USDC per call (x402).

Argument	Type	Description
tf	string	Candle timeframe
symbol*	string	Instrument symbol

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "symbol"
  ],
  "properties": {
    "tf": {
      "enum": [
        "5m",
        "1h",
        "4h",
        "1d",
        "1w"
      ],
      "type": "string",
      "default": "4h",
      "description": "Candle timeframe"
    },
    "symbol": {
      "enum": [
        "BTC",
        "SOL",
        "ETH",
        "BNB",
        "LTC",
        "ADA",
        "XRP",
        "XDC",
        "NVDA",
        "MSFT",
        "AMZN",
        "AAPL",
        "USDPHP"
      ],
      "type": "string",
      "description": "Instrument symbol"
    }
  },
  "additionalProperties": false
}

get_support_resistance

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).

Argument	Type	Description
symbol*	string	Instrument symbol

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "symbol"
  ],
  "properties": {
    "symbol": {
      "enum": [
        "BTC",
        "SOL",
        "ETH",
        "BNB",
        "LTC",
        "ADA",
        "XRP",
        "XDC",
        "NVDA",
        "MSFT",
        "AMZN",
        "AAPL",
        "USDPHP"
      ],
      "type": "string",
      "description": "Instrument symbol"
    }
  },
  "additionalProperties": false
}

get_target_probability

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).

Argument	Type	Description
symbol*	string	Instrument symbol
target*	number	Target price in the quote currency

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "symbol",
    "target"
  ],
  "properties": {
    "symbol": {
      "enum": [
        "BTC",
        "SOL",
        "ETH",
        "BNB",
        "LTC",
        "ADA",
        "XRP",
        "XDC",
        "NVDA",
        "MSFT",
        "AMZN",
        "AAPL",
        "USDPHP"
      ],
      "type": "string",
      "description": "Instrument symbol"
    },
    "target": {
      "type": "number",
      "description": "Target price in the quote currency",
      "exclusiveMinimum": 0
    }
  },
  "additionalProperties": false
}

get_track_record

Graded accuracy of every published signal bias: hit rate by confidence, bias and symbol, Wilson intervals, Brier score, independent samples (free). Omit symbol for the all-symbols report; pass it to filter to one instrument. Returns 404 if nothing has been graded yet for that filter.

Argument	Type	Description
symbol	string	Instrument symbol

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "symbol": {
      "enum": [
        "BTC",
        "SOL",
        "ETH",
        "BNB",
        "LTC",
        "ADA",
        "XRP",
        "XDC",
        "NVDA",
        "MSFT",
        "AMZN",
        "AAPL",
        "USDPHP"
      ],
      "type": "string",
      "description": "Instrument symbol"
    }
  },
  "additionalProperties": false
}

get_trade_plan

Complete trade setup in one call. One call instead of four: signal bias, market regime, nearest support/resistance, setup levels (entry, stop, target, R:R), probability of reaching the target before the stop, odds of touching the target within 7 days, an estimated time to target, invalidation conditions, and this symbol's graded track record. Neutral bias returns the odds of hitting resistance before support. Costs $0.03 USDC per call (x402).

Argument	Type	Description
tf	string	Candle timeframe
symbol*	string	Instrument symbol

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "symbol"
  ],
  "properties": {
    "tf": {
      "enum": [
        "5m",
        "1h",
        "4h",
        "1d",
        "1w"
      ],
      "type": "string",
      "default": "4h",
      "description": "Candle timeframe"
    },
    "symbol": {
      "enum": [
        "BTC",
        "SOL",
        "ETH",
        "BNB",
        "LTC",
        "ADA",
        "XRP",
        "XDC",
        "NVDA",
        "MSFT",
        "AMZN",
        "AAPL",
        "USDPHP"
      ],
      "type": "string",
      "description": "Instrument symbol"
    }
  },
  "additionalProperties": false
}

get_trigger_status

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, delivery_attempts, last_error}, where status is one of armed, fired_delivering, delivered, delivery_failed (after 5 webhook attempts) or expired. Returns 404 if id is unknown or its payment never settled.

Argument	Type	Description
id*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

list_symbols

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).

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

NythosX Market Data

Try it

arm_price_trigger

NythosX Market Data

Try it

arm_price_trigger

Tools (10)