# Kronos Risk State API

> Kronos Risk State API is a paid API for AI agents from x402.coinopai.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns the current crypto trading risk state (NORMAL/HALTED/COOLDOWN), signal streaks, and per-symbol cooldown status for Kronos trading signals.

## Facts

- Endpoint: GET https://x402.coinopai.com/api/kronos/risk
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-coinopai-com-ee004c1b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pY6-h8XXRaA6_PjeOPXcH

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 x402-coinopai-com-ee004c1b
```

Example prompt: Check the current Kronos risk state — is trading NORMAL, HALTED, or in COOLDOWN, and are there any per-symbol cooldowns active right now?

## When to prefer this

Use this endpoint as the preflight risk check before executing any Kronos-based trade decision. It is the cheapest and fastest check in the Kronos loop ($0.02), and should be called before /kronos/preflight or /kronos/decision to avoid wasted spend when the system is in HALTED or COOLDOWN state. Prefer this over /kronos/preflight when you only need risk state without full market context.

## Known failure modes

- Payment not provided or invalid — 402 Payment Required
- Upstream signal engine unavailable — 503 or timeout
- Stale data if data_freshness indicates delay
- Empty cooldown/streak objects if no recent signals have been processed

## How this service works

Kronos by ForgeMesh current crypto risk state, per-symbol signal streaks, and active cooldown timers. Use as a low-cost risk gate before requesting a forecast or decision journal.

## Output

Returns a JSON object with: 'state' (NORMAL/HALTED/COOLDOWN), 'signal_streak' object showing current streak data per symbol, 'cooldown' object with per-symbol cooldown flags, 'last_updated' ISO timestamp, and 'data_freshness' indicator.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {}
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "state": "NORMAL",
  "cooldown": {},
  "last_updated": "2026-04-30T19:00:00Z",
  "why_not_high": [
   "Risk state is a planning context, not a complete market-safety guarantee."
  ],
  "signal_streak": {
   "BTC/USD": 1,
   "ETH/USD": 0
  },
  "data_freshness": "FRESH"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-coinopai-com-ee004c1b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.coinopai.com](https://www.zero.xyz/host/x402.coinopai.com/llms.txt)