--- name: x402.coinopai.com description: x402.coinopai.com exposes two distinct capability sets: the Kronos crypto trading signal system (covering BTC, ETH, SOL, XRP, and ADA on 15-minute timeframes) and a CoinOp AI automation category directory. Kronos provides current signals, historical signal snapshots, pre-trade condition checks, and probabilistic trade decisions. The automation category skill returns a static directory of 35 topic categories with slugs and counts. host: x402.coinopai.com --- # x402.coinopai.com This host is operated by CoinOp AI and serves agents that need structured, discrete crypto trading signals and pre-trade analysis for a fixed set of five major assets. The Kronos subsystem is the primary offering, providing layered signal intelligence from raw directional scores through to actionable trade decisions with confidence and regime context. The automation category endpoint is a utility resource for navigating CoinOp AI's broader automation catalog and is unrelated to the trading functionality. ## When to use this host Use this host when an agent needs discrete, structured crypto trading signals or pre-trade condition checks for BTC, ETH, SOL, XRP, or ADA on a 15-minute timeframe. The Kronos stack is well-suited for agents that gate trade recommendations behind condition checks before committing to a decision call. Do not use this host for real-time tick-level price feeds, live order book data, or trade execution — it provides signals and decisions only, not quotes or order routing. Do not use it for assets outside the five supported symbols. The automation category skill is only relevant if the agent is navigating CoinOp AI's automation catalog; it has no relation to trading. For live price data or execution, route to a dedicated exchange or market-data host instead. ## Capabilities ### Automation Directory Provides a static enumeration of all 35 CoinOp AI automation categories, enabling agents to browse or filter available automations by topic slug and count. - **`fetch-automation-categories`** — Returns all 35 CoinOp AI automation categories, each with a display name, URL slug, and automation count. ### Kronos Signal Feed Delivers current and historical 15-minute directional trading signals for BTC, ETH, SOL, XRP, and ADA, including market regime classification and per-asset signal scores. - **`fetch-kronos-trading-signals`** — Returns directional trading signals for BTC, ETH, SOL, XRP, and ADA on a 15-minute timeframe, along with market regime classification and signal freshness metadata. - **`fetch-kronos-signal-history`** — Returns up to 168 hours of 15-minute crypto trading signals for BTC, ETH, SOL, XRP, and ADA, including per-asset signal scores, market regime, and top-ranked assets per interval. ### Kronos Pre-Trade Analysis Checks whether trading conditions are favorable for a given asset and produces a probabilistic directional trade decision with confidence, regime context, and position sizing guidance. - **`fetch-kronos-preflight`** — Returns pre-trade conditions for a crypto symbol including market state, signal strength, cooldown status, and trade allowance, costing $0.05 USDC per call. - **`fetch-kronos-trade-decision`** — Returns a probabilistic trade decision (CONSIDER_LONG, CONSIDER_SHORT, or NO_ACTION) with confidence score, market regime, and risk guidance for a given crypto symbol. ## Workflows ### Gated Trade Decision *Use when an agent needs to obtain a trade recommendation for a crypto asset while avoiding signals during cooldowns or unfavorable market states.* 1. **`fetch-kronos-preflight`** — Check whether the target symbol is in cooldown, has a signal available, and is in an allowed market state before spending on a full decision call. 2. **`fetch-kronos-trade-decision`** — If preflight returns allowed=true and signal_available=true, fetch the probabilistic trade decision including suggested action, confidence, and risk guidance. ### Signal Context + Decision *Use when an agent needs to understand the current market regime and asset signal landscape before requesting a specific trade decision, to add context to the recommendation.* 1. **`fetch-kronos-trading-signals`** — Retrieve the current regime classification and directional signal scores for all five assets to establish market context. 2. **`fetch-kronos-preflight`** — Confirm pre-trade conditions are met for the target symbol given the observed regime. 3. **`fetch-kronos-trade-decision`** — Obtain the probabilistic trade decision with confidence and position sizing guidance for the target symbol. ### Historical Regime Review + Current Signal *Use when an agent needs to compare current signals against recent historical signal patterns to assess consistency or detect regime shifts.* 1. **`fetch-kronos-signal-history`** — Retrieve up to 168 hours of 15-minute signal snapshots to review past regime classifications and per-asset scores. 2. **`fetch-kronos-trading-signals`** — Fetch the latest signal snapshot and regime to compare against the historical baseline. ## Skill reference ### `fetch-automation-categories` **CoinOp AI Automation Categories** — Returns all 35 CoinOp AI automation categories, each with a display name, URL slug, and automation count. *Use when:* Use when an agent needs to enumerate available automation categories on CoinOp AI, such as to filter automations by topic, display a category menu, or determine which categories exist before querying category-specific automations. *Not for:* Do not use to retrieve individual automations or automation details; use a category-specific or automation-detail endpoint instead. **Returns:** Returns a categories array of 35 objects, each with a name (e.g. "AI"), slug (e.g. "ai"), and integer count of automations (e.g. 603). **Example:** `GET https://x402.coinopai.com/api/categories` --- ### `fetch-kronos-signal-history` **Kronos Signal History** — Returns up to 168 hours of 15-minute crypto trading signals for BTC, ETH, SOL, XRP, and ADA, including per-asset signal scores, market regime, and top-ranked assets per interval. *Use when:* Use when an agent needs historical 15-minute crypto signal data to analyze past market regimes, review per-asset signal scores, or identify which assets ranked highest (top_k) over a specified lookback window up to 7 days. *Not for:* Do not use for real-time streaming price feeds or live order book data; this endpoint returns discrete historical signal snapshots at 15-minute intervals, not tick-level or continuous price data. **Inputs:** - `hours` (integer) — Number of hours of signal history to return. Defaults to 24, maximum is 168 (7 days). **Returns:** Returns a JSON object with count (e.g. 96), hours (24), and a signals array of 15-minute interval records each containing a timestamp, regime label, per-asset signal scores, and top_k ranked assets. **Example:** `GET https://x402.coinopai.com/api/kronos/history?hours=24` --- ### `fetch-kronos-preflight` **Kronos Preflight Check** — Returns pre-trade conditions for a crypto symbol including market state, signal strength, cooldown status, and trade allowance, costing $0.05 USDC per call. *Use when:* Use when an agent needs to verify whether trading conditions are favorable for a given symbol (BTC, ETH, SOL, XRP, ADA) before executing or recommending a trade, including checking for active cooldowns, signal availability, and market state. *Not for:* Do not use for real-time price feeds or order execution; this is a pre-trade conditions check only, not a live quote or trade trigger. **Inputs:** - `symbol` (string) — Ticker symbol to check pre-trade conditions for. Supported values: BTC, ETH, SOL, XRP, ADA. Defaults to BTC. **Returns:** Returns a JSON object with symbol, allowed flag, market_state, cooldown status, signal availability and strength, signal age, warnings array, checked_at timestamp, and a risk_disclosure object. **Example:** `GET https://x402.coinopai.com/api/kronos/preflight?symbol=BTC` --- ### `fetch-kronos-trade-decision` **Kronos Trade Decision** — Returns a probabilistic trade decision (CONSIDER_LONG, CONSIDER_SHORT, or NO_ACTION) with confidence score, market regime, and risk guidance for a given crypto symbol. *Use when:* Use when an agent needs a single-shot directional trade signal for BTC, ETH, SOL, XRP, or ADA, including confidence level, regime context, and position sizing guidance before executing or evaluating a trade. *Not for:* Do not use for real-time streaming price feeds or as a definitive financial recommendation; use the /api/kronos/audit endpoint to verify decision outcomes after the evaluation window. **Inputs:** - `symbol` (string) — Crypto symbol to evaluate. Accepted values: BTC, ETH, SOL, XRP, ADA. Defaults to BTC. **Returns:** Returns a decision object with a UUID decision_id, suggested_action (e.g. CONSIDER_SHORT), confidence score, regime, raw_signal, position_guidance, signal timestamp, and a next_step audit endpoint reference. **Example:** `GET https://x402.coinopai.com/api/kronos/decision?symbol=BTC` --- ### `fetch-kronos-trading-signals` **Kronos Trading Signals** — Returns directional trading signals for BTC, ETH, SOL, XRP, and ADA on a 15-minute timeframe, along with market regime classification and signal freshness metadata. *Use when:* Use when an agent needs current short-term directional signals (bullish/bearish strength as a float) for major crypto pairs, or needs to know the current market regime (e.g. chop, trend) before placing or evaluating trades. *Not for:* Do not use for historical signal data or backtesting; this endpoint returns only the latest snapshot. Not suitable for assets outside BTC, ETH, SOL, XRP, and ADA. **Returns:** Returns a JSON object with a timestamp, 15m timeframe, regime label, per-pair directional signal floats for BTC/ETH/SOL/XRP/ADA, signal age in hours, and a data freshness string. **Example:** `GET https://x402.coinopai.com/api/kronos/signals` ---