# Kronos Perpetual Futures Decision Engine

> Kronos Perpetual Futures Decision Engine is a paid API for AI agents from kronos.forgemesh.io, paid per call via x402, $0.15/call, status unknown (last checked 2026-10-11).

Returns a complete perpetual-futures trading decision package (LONG/SHORT/FLAT direction, stop-loss, take-profit, leverage cap, liquidation price, position size, and funding cost) for BTC, ETH, SOL, XRP, or ADA.

## Facts

- Endpoint: GET https://kronos.forgemesh.io/api/kronos/futures/decision?utm_source=zero.xyz
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kronos-perpetual-futures-decision-engine-635401e5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5Io6HaeU9trDk7vhNxsfb

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability kronos-perpetual-futures-decision-engine-635401e5
```

Example prompt: Give me the Kronos futures decision for BTC — I have $5,000 in equity, max leverage of 3x, and I'm willing to risk 1% of my account per trade.

## When to prefer this

Choose this endpoint when you need a fully integrated perpetual-futures decision package — not just a raw signal — including direction, calibrated stop/take-profit levels, leverage cap, liquidation price, and risk-sized position size in one call. Prefer this over raw signal endpoints when you need to act on a bearish signal with a sized short rather than staying flat, or when you need funding-cost awareness before committing capital. It is not an execution endpoint and does not place orders.

## Known failure modes

- Unsupported symbol provided — only BTC, ETH, SOL, XRP, ADA are accepted
- max_leverage outside 1–5 range returns a validation error
- equity not provided results in position sizing fields being absent or defaulted
- Payment not completed (x402) — endpoint returns 402 Payment Required
- Signal data temporarily unavailable — may return FLAT direction as a conservative fallback
- Network timeout if underlying market data feed is delayed

## How this service works

Returns a perpetual-futures decision package for BTC, ETH, SOL, XRP, or ADA: direction LONG / SHORT / FLAT from the Kronos signal, stop-loss and take-profit on the calibrated 80% range, a leverage cap that keeps liquidation outside 2x the stop, liquidation price, risk-based position size for your equity and max loss, and live perp funding cost over the horizon — turns a bearish signal into a sized short instead of staying out. No exchange execution; market intelligence only.

## Output

A JSON package containing: direction (LONG/SHORT/FLAT), calibrated 80% range stop-loss and take-profit price levels, leverage recommendation capped so liquidation stays outside 2x the stop distance, liquidation price, risk-based position size calculated from account equity and max-loss fraction, live perpetual funding cost over the holding horizon, and an array of warnings plus a risk disclosure object.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "equity": {
       "type": "number",
       "description": "Account equity in USD used for position sizing (optional)"
      },
      "symbol": {
       "type": "string",
       "description": "BTC, ETH, SOL, XRP, or ADA"
      },
      "max_leverage": {
       "type": "number",
       "description": "Your own leverage ceiling, 1–5 (default 5)"
      },
      "max_loss_pct": {
       "type": "number",
       "description": "Max loss per position as a fraction of equity, e.g. 0.01 (default 0.01)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "levels": {
       "type": "object"
      },
      "symbol": {
       "type": "string"
      },
      "funding": {
       "type": "object"
      },
      "leverage": {
       "type": "object"
      },
      "position": {
       "type": "object"
      },
      "warnings": {
       "type": "array"
      },
      "direction": {
       "enum": [
        "LONG",
        "SHORT",
        "FLAT"
       ],
       "type": "string"
      },
      "funding_impact": {
       "type": "object"
      },
      "risk_disclosure": {
       "type": "object"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kronos-perpetual-futures-decision-engine-635401e5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kronos.forgemesh.io](https://www.zero.xyz/host/kronos.forgemesh.io/llms.txt)