The Orrery Decision API

Flagship endpoints

Four sharp endpoints. The full catalog of 18 endpoints (per-wallet, per-category, per-event, etc) is at /api/v1/manifest.

The Decision Card envelope

Stable shape — every paid endpoint returns this. Header is identical (action + scores + evidence + risks + sources + next_calls); the `payload` field carries endpoint-specific data.

{
  "data": {
    "schema_version": "orrery.decision.v1",
    "decision_type": "attention_queue",
    "generated_at": "2026-05-02T18:30:00Z",
    "valid_until":  "2026-05-02T18:31:00Z",
    "recommended_agent_action": "investigate_now",
    "scores": { "attention": 87.4, "confidence": 0.72, "risk": 0.41 },
    "one_line_reason": "Top market \"X\" scored 87.4/100 — investigate_now.",
    "why_this_matters": [ "..." ],
    "evidence": [ { "type": "price_move", "summary": "...", "weight": 0.31, "data": { ... } } ],
    "risks":   [ { "type": "resolution_ambiguity", "severity": "medium", "summary": "..." } ],
    "sources": [ { "source_type": "market", "name": "Polymarket", "url": "..." } ],
    "suggested_next_calls": [
      {
        "endpoint": "/api/x402/v1/markets/{id}/why",
        "method": "GET",
        "reason": "Get the deterministic factor breakdown.",
        "estimated_price_usdc": 0.02,
        "priority": "high"
      }
    ],
    "payload": { "items": [ ... ] },
    "disclaimer": "Decision-support data only. ..."
  },
  "meta": {
    "endpoint": "/api/x402/v1/decision/attention",
    "fetched_at": "2026-05-02T18:30:00Z",
    "payment_status": "preview",
    "usdc_per_call": 0.05,
    "sources": ["Polymarket Gamma", "Polymarket Data", "Orrery Decision Engine"],
    "not_trade_advice": true
  }
}

Quickstart

1. 1
   Read the manifest

   GET https://orrery.me/api/v1/manifest — the free index of every paid endpoint with prices, schemas, decision types, and example URLs.

   curl https://orrery.me/api/v1/manifest

2. 2
   Call the Attention Queue

   GET /api/x402/v1/decision/attention?limit=5&risk_tolerance=medium — flagship endpoint, $0.05. Returns the ranked list of markets that deserve attention right now, with a Decision Card per market.

   curl 'https://orrery.me/api/x402/v1/decision/attention?preview=1&limit=5'

3. 3
   Walk suggested_next_calls

   Each Decision Card includes `suggested_next_calls[]` — the next paid endpoints the agent should hit for the top results. Walk these as a tree, not a list.

4. 4
   Verify before acting

   If `recommended_agent_action` is `check_resolution_risk` or `check_sources`, hit /markets/{id}/resolution-risk before treating the move as actionable. UMA disputes and ambiguous wording are real and frequent.

   curl 'https://orrery.me/api/x402/v1/markets/{slug}/resolution-risk?preview=1'

5. 5
   Cite the markdown variant

   Every market and the daily brief have a Markdown twin (`/markets/{slug}/markdown`, `/brief/markdown`) with timestamps and a Cite-this stanza. Use these when handing analysis back to a human.

recommended_agent_action enum

Frequently asked