{"uid":"cap_5yiTx8vyGveqrUhJyCCMN","slug":"kronos-signals-forecast-ledger-2efde7c8","name":"Kronos Signals Forecast Ledger","description":"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.","url":"https://kronossignals.com/api/v1/forecast-ledger","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"queryParams":{"type":"string"}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_s1oTxwmc8rv_9KXXprWl_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a paginated list of resolved ML forecast predictions with their actual real-world outcomes, filterable by asset, horizon, date range, and source.","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:49:24.024Z","isFirstParty":false}