TradeBot paper-signal ledger

CEV-OS / Data API / TradeBot paper-signal ledger

CEV-OS Data API · last updated 2026-11-04. Status: live. Version 1.

Use this when you need an auditable, hash-chained track record of cev-os paper-bot signals with percent outcomes (hypothetical; Kalshi and Polymarket bots excluded).

What it is

Each paper signal (bot, time, symbol, side, reason) is SHA-256 hashed when first seen and appended to a hash chain; commit lag and a backfilled flag show how strong the timing proof is. Outcomes are % only. Kalshi and Polymarket bots are excluded. 15-minute delay on the newest signals.

Endpoints

REST: GET /v1/signal-ledger on https://api.cev-os.com
Legacy host (same service): GET /v1/signal-ledger on https://cev-os.com
MCP tool: get_signal_ledger on https://mcp.cev-os.com/mcp
Legacy alias (same handler): GET /v1/preview/signal-ledger

Parameters

Query parameters for `GET /v1/signal-ledger`
Name	Type	Description	Constraints
`bot`	string	Bot id filter.	enum: trend-basket, trend-voltarget, q-style-etf, breakout-etf, buy-the-dip, jev, pair-signal
`limit`	integer	Max entries (1-500, default 200).	min 1; max 500

Example request

No account and no key. Query values below are the examples or defaults from the registry. An optional free key (header x-api-key) raises the limits; create one at https://cev-os.com/#api_keys after signing in with a verified email (Google sign-in is already verified).

curl -s "https://api.cev-os.com/v1/signal-ledger"

Example response

Every /v1 response is a JSON envelope (schema_version, product, timestamps, license, attribution, data). The registry example is the data member:

{
  "chain_verified": true,
  "held_back": 0,
  "entries": [
    {
      "seq": 1,
      "hash": "9f…",
      "signal": {
        "bot": "breakout-etf",
        "t": "2026-10-16T20:22:12.000Z",
        "symbol": "SMH",
        "side": "buy",
        "reason": "breakout"
      },
      "outcome": {
        "return_since_signal_pct": 1.2
      }
    }
  ]
}

Update frequency

Ledger job every 15 minutes.

Public cache: 60 seconds (Cache-Control: public, max-age=60).
Newest records held back 15 minutes for free callers.

Sources, license and usage

License status: cleared with attribution. Computed by cev-os from third-party market data (Yahoo Finance via yfinance; Coinbase crypto bars). Signals and outcomes are cev-os derived; Kalshi and Polymarket bots are excluded. Owner accepts the data-license risk pending a price-feed swap; this does not grant redistribution rights in the underlying vendor prices.

Underlying sources
Source	License	commercialOk	Terms
cev-os TradeBot paper bots (own signals; Kalshi/Polymarket bots excluded)	Own work (Cutting Edge Ventures): signals and outcomes are cev-os derived; inputs are third-party market data (see other sources). Kalshi and Polymarket bots are excluded.	true	—
Yahoo Finance prices (via yfinance / yahoo-finance2)	Terms bar commercial use and redistribution, including derived data. Owner accepts the data-license risk for cev-os-derived signals pending a price-feed swap; this does not grant redistribution rights in the underlying vendor prices.	pending	—
Coinbase market data (crypto bars in the paper bots)	Market-data terms not independently cleared for redistribution. Owner accepts the data-license risk for cev-os-derived signals pending a price-feed swap; this does not grant redistribution rights in the underlying vendor prices.	pending	—

Attribution (show this wherever you display the data):

cev-os TradeBot paper bots.

Privacy class: public-derived. Access: public. Price: free (price is null; pay-per-call is not active).

Disclaimer

PAPER / HYPOTHETICAL results from simulated bots. Not investment advice, not an offer, and not indicative of future results. No real money was traded.

Data API hub (all products, limits, license notes)
MCP Registry listing com.cev-os/data
OpenAPI 3.1
Machine product list: /v1/products

Reference data, not investment advice.