# Kronos by ForgeMesh — Crypto Risk State API

> Kronos by ForgeMesh — Crypto Risk State API is a paid API for AI agents from kronos.forgemesh.io, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns the current crypto market risk state, signal streaks, cooldown info, and data freshness for autonomous agent decision-making, paid via x402 micropayments.

## Facts

- Endpoint: GET https://kronos.forgemesh.io/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/kronos-by-forgemesh-crypto-risk-state-api-7eb6a10c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_A1hsV7FIGkRHfO0gGPQrz

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-by-forgemesh-crypto-risk-state-api-7eb6a10c
```

Example prompt: Check the current Kronos market risk state — I want to know if conditions are NORMAL or elevated before my agent executes any crypto trades, and whether the BTC/USD signal streak is active.

## When to prefer this

Choose this endpoint when an autonomous agent needs a structured, pre-computed risk classification signal before executing crypto trades, rather than raw price feeds. It is specifically optimized for agentic workflows that require concise risk-state verdicts (NORMAL vs elevated), signal streaks, and cooldown context in a single low-cost call via x402 micropayments on Base — ideal for decision-gating, journaling, and audit trails.

## Known failure modes

- Payment not included or insufficient USDC — returns HTTP 402 requiring x402 micropayment
- Stale data — 'data_freshness' field returns STALE if upstream market data is delayed
- Network or provider downtime — endpoint may return 5xx errors
- Malformed request — unexpected query parameters may be ignored or return 400
- Rate limiting if payment flow is not correctly handled by agent

## How this service works

Returns current market risk state, per-symbol signal streaks, and active cooldown timers — use it as a pre-trade risk gate before acting on any signal. Typical agent tasks: check if BTC or ETH is in cooldown before a trading agent acts, confirm signal streak length for momentum context, gate an autonomous workflow on risk state, or add a safety check ahead of a decision call. Fresh continuously, USDC on Base mainnet via x402.

## Output

Returns a JSON object with: 'state' (e.g. NORMAL or elevated), 'cooldown' object describing any active cooldown periods, 'last_updated' ISO timestamp, 'why_not_high' array of explanatory strings contextualizing the risk state, 'signal_streak' object with per-pair streak counts (e.g. BTC/USD, ETH/USD), and 'data_freshness' indicator (FRESH or STALE).

## 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/kronos-by-forgemesh-crypto-risk-state-api-7eb6a10c/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)