---
title: "Paginated resolved-forecast ledger — $0.02/call"
method: GET
path: "/api/v1/forecast-ledger"
tags: ["ledger", "paid"]
---

# Paginated resolved-forecast ledger — $0.02/call

`GET /api/v1/forecast-ledger`

## Request

- Base URL: `https://kronossignals.com` (the document declares no server; this is the origin it was published from)
- URL: `https://kronossignals.com/api/v1/forecast-ledger`
- Auth: none declared

Returns a paginated list of resolved forecasts (outcomes joined with forecasts). 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. Costs $0.02 USDC on Base via x402.

## Query parameters

- `asset` string
- `horizon` '1h' | '4h' | '24h'
- `from` string, date-time
- `to` string, date-time
- `source` 'cache' | 'paid'
- `limit` integer
- `offset` integer

## Response `200`

Resolved forecast ledger (payment verified)

- object
  - `summary` object
    - `total` integer
    - `hit_rate` number, nullable: Cache-source hit rate, matching /api/stats methodology.
    - `sample_note` string
  - `rows` object[]
    - `forecast_id` string, uuid
    - `made_at` string, date-time
    - `asset` string
    - `horizon` '1h' | '4h' | '24h'
    - `predicted_direction` 'up' | 'down'
    - `up_prob` number
    - `confidence` number, nullable
    - `resolved_at` string, date-time, nullable
    - `actual_direction` 'up' | 'down', nullable
    - `hit` boolean, nullable
    - `price_at_forecast` number, nullable
    - `price_at_resolution` number, nullable
    - `return_pct` number, nullable
  - `pagination` object
    - `limit` integer
    - `offset` integer
    - `total` integer
  - `disclaimer` string
  - `generated_at` string, date-time

## Other responses

- `402`: Payment Required — x402 micropayment instructions in response body

---

[API](https://skmtc.dev/kronossignals/apis/kronos-crypto-data-api.md) · [All operations](https://skmtc.dev/kronossignals/apis/kronos-crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kronossignals/apis/kronos-crypto-data-api/revisions/bfdcf7230e93?raw)