# Kronos Signals Forecast Ledger

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

Returns a paginated list of resolved ML forecast predictions with their actual real-world outcomes, filterable by asset, horizon, date range, and source.

## Facts

- Endpoint: GET https://kronossignals.com/api/v1/forecast-ledger
- 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-signals-forecast-ledger-2efde7c8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5yiTx8vyGveqrUhJyCCMN

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-signals-forecast-ledger-2efde7c8
```

Example prompt: Pull up the Kronos forecast ledger for BTC with a 24h horizon from January 1 to March 31, 2025, limited to 100 rows, and show me the hit rate for paid-source signals only.

## When to prefer this

Use this endpoint when you need to audit or backtest the accuracy of Kronos ML forecast signals — specifically to see how predictions resolved against real outcomes and to compute hit rates. Prefer this over the /api/stats endpoint when you need granular row-level data rather than aggregate statistics, or when filtering by specific assets, horizons, date windows, or source types.

## Known failure modes

- Invalid date format for 'from' or 'to' returns 400 bad request
- Unsupported horizon value (outside 1h/4h/24h) returns 400 validation error
- Unsupported source value (outside cache/paid) returns 400 validation error
- Limit exceeding 500 returns 400 bad request
- No forecasts found for the specified filters returns empty result set with count 0
- Payment not processed (x402) returns 402 Payment Required
- Rate limiting or quota exceeded returns 429 Too Many Requests

## How this service works

Paginated list of resolved forecasts with actual outcomes. Each row shows the original ML prediction and its real-world result. Summary includes total count and hit_rate (cache-source rows, matching /api/stats methodology). Filterable by asset, horizon, date range, and source. — $0.02/call. Live track record at /api/stats: ~54% directional hit, ~70% in-range over 15k+ scored forecasts — measured on served predictions, not a backtest.

## Output

A paginated list of resolved forecast rows, each showing the original ML prediction alongside the real-world outcome for the specified asset and horizon. The summary includes total count of resolved forecasts and the hit_rate percentage (filtered to cache-source rows to match /api/stats methodology).

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "rows": [
   {
    "hit": true,
    "asset": "BTC-USD",
    "horizon": "1h",
    "made_at": "2024-01-01T00:00:00.000Z",
    "up_prob": 0.83,
    "confidence": 0.83,
    "return_pct": 0.00624,
    "forecast_id": "uuid-here",
    "resolved_at": "2024-01-01T01:00:00.000Z",
    "actual_direction": "up",
    "price_at_forecast": 60136.29,
    "predicted_direction": "up",
    "price_at_resolution": 60511.99
   }
  ],
  "summary": {
   "total": 211,
   "hit_rate": 0.5328,
   "sample_note": "Illustrative example only — not live accuracy. Call GET /api/stats for current figures computed from the database."
  },
  "disclaimer": "Resolved forecasts from Kronos cache-served rows. Headline hit_rate uses cache-source rows only, matching /api/stats methodology. Not financial advice.",
  "pagination": {
   "limit": 100,
   "total": 211,
   "offset": 0
  },
  "generated_at": "2024-01-01T00:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kronos-signals-forecast-ledger-2efde7c8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kronossignals.com](https://www.zero.xyz/host/kronossignals.com/llms.txt)