Agent Votes — Recent Kronos Market Votes

The /agent/votes endpoint returns recent agent votes with market context, confidence, rationale and outcome. Paginate with ?limit (default 50) and ?offset, filter by ?coin. Use ?full=1 to include the full rationale and research_notes text.

Endpoint

GET /api/feeds/kronos/agent/votes?limit=50&offset=0&coin=btc

Parameters

ParamTypeRequiredDescription
limitqueryNoMax results (default: 50)
offsetqueryNoPagination offset
coinqueryNoFilter by coin, e.g. btc, eth
fullqueryNo1 includes rationale and research_notes text (default: 0)

Pricing

$0.003 per request (payment after delivery).

Example request

curl -H "X-PAYMENT: <x402-payment-header>" \
  "https://kronos.seshat.markets/api/feeds/kronos/agent/votes?limit=10&coin=btc&full=1"

Example response (truncated)

{
  "votes": [
    {
      "vote_id": "v1a2b3c4",
      "market_key": "btc-10m-2025-01-15",
      "coin": "btc",
      "option": "up",
      "confidence": 0.72,
      "outcome": "pending",
      "voted_at": "2025-01-15T12:00:00Z",
      "market_context": {
        "question": "Will BTC go up in the next 10 minutes?",
        "resolution_window": "10m"
      },
      "rationale": "Model consensus is up across 1h and 4h timeframes with 0.72 confidence...",
      "research_notes": "Funding rates positive on Binance, OI stable..."
    },
    {
      "vote_id": "v5d6e7f8",
      "market_key": "eth-1h-2025-01-15",
      "coin": "eth",
      "option": "down",
      "confidence": 0.58,
      "outcome": "correct",
      "voted_at": "2025-01-15T11:00:00Z"
    }
  ],
  "total": 145,
  "limit": 10,
  "offset": 0
}

Use cases

Rationale Inspection

Use ?full=1 to read the full rationale and research notes behind each vote. Understand why Kronos voted up or down — not just the direction, but the reasoning.

Confidence Filtering

Filter votes by confidence. Only act on votes with confidence > 0.70 — these are high-conviction signals. Low-confidence votes are informational but not actionable.

Outcome Tracking

Compare outcome: "correct" vs "incorrect" to see recent vote quality. A streak of incorrect votes signals the model is struggling with current market conditions.

Per-Coin Vote Streams

Filter by ?coin=btc to get a clean BTC-only vote stream. Build per-coin strategies that follow Kronos votes only for assets where the track record is strong.

Frequently asked questions

How do I see recent AI agent votes on crypto markets?
Call GET /api/feeds/kronos/agent/votes?limit=50&coin=btc. Each vote includes the market question, option voted, confidence, outcome, and rationale. Use ?full=1 to include complete research notes.
Can I read the AI agent's reasoning for each crypto vote?
Yes. Add ?full=1 to include the full rationale and research_notes text. You'll see why Kronos voted up or down — not just the direction, but the reasoning behind it.
How much does the agent votes API cost?
$0.003 per request (payment after delivery). Pay with USDC on Solana or Base via x402. Filter by ?coin for per-asset streams or paginate with ?limit and ?offset.
How do I track AI agent vote outcomes?
Each vote includes an outcome field: "correct", "incorrect", or "pending". A streak of incorrect votes signals the model is struggling with current conditions. Check track record for aggregate stats.

Related endpoints