Agentic Intelligence API

Orrery for AI agents

Paid per-call probability intelligence over public Polymarket data. No accounts, no API keys — agents pay USDC per request via the x402 protocol on Base. v1 launches in preview mode (free) so you can wire it up before settlement is enforced.

What this is

A second namespace on the Orrery domain — /api/x402/v1/... — built specifically for autonomous AI agents. Each endpoint returns small, deterministic JSON with a uniform envelope. Settle each call in USDC on Base (or replay during preview); no accounts, no rate cards, no rate-limit negotiations.

Discovery

  • /.well-known/x402-services.json — service catalog for marketplace listings (price, networks, latency, freshness targets).
  • /x402-openapi.yaml — full OpenAPI 3.1 spec.
  • /.well-known/ai-plugin-x402.json — agent plugin manifest variant for the paid surface.
  • /llms.txt — single-file overview that lists this surface alongside the public read-only API.

Endpoints (v1)

18
GET/api/x402/v1/brief/today$0.010 USDC

Daily prediction-market brief: biggest moves, unusual volume, research signals, resolution watch — machine-readable.

cache 300s · target latency 800ms

GET/api/x402/v1/markets/movers$0.005 USDC

Top biggest 24h probability movers across live Polymarket markets, with category, volume and source-risk hints.

cache 120s · target latency 600ms

GET/api/x402/v1/markets/{id}/snapshot$0.005 USDC

Compact snapshot for one market: probability, deltas, volume, liquidity, status, resolution source, active signals, related markets.

cache 90s · target latency 600ms

GET/api/x402/v1/markets/{id}/why$0.020 USDC

Interpreted explanation of why a market moved: factors with evidence, confidence, sources, and what to verify next.

cache 180s · target latency 1500ms

GET/api/x402/v1/markets/{id}/resolution-risk$0.010 USDC

Resolution-risk analysis: extracted source type, confidence, UMA dispute status, ambiguities, what-to-verify hints.

cache 240s · target latency 600ms

GET/api/x402/v1/events/{slug}/cluster$0.030 USDC

Cluster of all related markets around a single event: aggregate volume, top movers, resolution risks, signals.

cache 240s · target latency 900ms

GET/api/x402/v1/signals$0.010 USDC

Live signals feed across top markets, each with kind, evidence tier, backtest verdict, and recommended action.

cache 180s · target latency 800ms

POST/api/x402/v1/watchlist/summary$0.050 USDC

Summarise a custom watchlist (markets + themes + wallets) with movers, new signals, resolution risk, and whale flow.

cache 60s · target latency 1200ms

POST/api/x402/v1/portfolio/risk$0.050 USDC

Portfolio risk cockpit for a list of Polymarket addresses: open notional, PnL, category exposure, upcoming resolutions, ambiguous-source exposure.

cache 30s · target latency 1500ms

GET/api/x402/v1/share-card/{slug}$0.030 USDC

Pre-formatted share artefact for a market move: OG image URL plus ready-to-publish copy variants for X (post + thread), Telegram, Discord, and newsletter.

cache 180s · target latency 700ms

GET/api/x402/v1/wallets/{address}$0.020 USDC

Per-wallet intelligence: open notional, PnL, win rate, and the five-dimensional profile score (activity, performance confidence, specialization, early-entry, copy-risk).

cache 120s · target latency 900ms

GET/api/x402/v1/category/{slug}/intelligence$0.020 USDC

Category dashboard data: total volume, average volatility, top movers, source-risk count, whale flow, resolving-soon count, and a one-line summary.

cache 240s · target latency 1000ms

GET/api/x402/v1/backtest/{kind}$0.020 USDC

Backtest verdict for a single signal kind (momentum / divergence / flow / resolution_risk / news_lag): win rate, sample size, expected 24h move, and the strong/mixed/weak/forward-only label.

cache 600s · target latency 600ms

GET/api/x402/v1/search$0.005 USDC

Free-text market search — find a Polymarket market by question text. Returns up to 20 matches with slug, question, category, probability, and 24h delta.

cache 60s · target latency 500ms

GET/api/x402/v1/events$0.005 USDC

Top events by volume — discover event slugs to fan out to /events/{slug}/cluster. Useful as the first call when an agent doesn't know which events are alive.

cache 240s · target latency 500ms

GET/api/x402/v1/signals/{kind}$0.010 USDC

Live signals filtered to one kind (momentum / divergence / flow / resolution_risk / news_lag). Faster than the generic /signals endpoint when an agent is monitoring a specific signal type.

cache 180s · target latency 700ms

GET/api/x402/v1/trades/recent$0.005 USDC

Raw recent whale trades feed — last N $5k+ trades with side, size, wallet, market slug. Designed for trading bots and Discord/Telegram bots that re-broadcast significant flow.

cache 60s · target latency 600ms

GET/api/x402/v1/health$0.000 USDC

Free health-check + endpoint inventory. Returns the full catalog with current pricing, payment-enforcement state, build version, and last-checked upstream Polymarket health. Always free — agents can ping before deciding which paid endpoints to call.

cache 30s · target latency 100ms

How payments work

  1. 1. Discover. Read the service catalog at /.well-known/x402-services.json. Each entry quotes usdc_per_call on Base.
  2. 2. Call. Fire the endpoint normally. During v1 preview you receive 200 OK with the envelope tagged payment_status: "preview".
  3. 3. Settle (when enforced). Once enforcement flips on, calls without an X-PAYMENT header receive HTTP 402 with a JSON challenge:
    {
  "error": "payment_required",
  "accepts": [{
    "scheme": "x402-onchain",
    "network": "base",
    "asset": "USDC",
    "amount": 0.01,
    "endpoint": "/api/x402/v1/brief/today"
  }],
  "docs": "https://orrery.me/docs/agents"
}
  4. 4. Replay. Compose the on-chain payment, attach proof in the X-PAYMENT header, replay the same request → 200 with payment_status: "settled".

Response envelope

Every x402 endpoint returns the same wrapper. The data shape is endpoint-specific;meta is uniform so prompt-engineering against the surface is cheap.

{
  "data": { /* endpoint-specific payload */ },
  "meta": {
    "endpoint": "/api/x402/v1/brief/today",
    "fetched_at": "2026-04-30T12:00:00.000Z",
    "cache_seconds": 300,
    "payment_status": "preview",
    "usdc_per_call": 0.01,
    "sources": ["Polymarket Gamma", "Polymarket Data"],
    "not_trade_advice": true
  }
}

Quickstart — autonomous agent

Most agents start with three calls. Today's brief → why-it-moved on the top mover → resolution-risk before treating it as news.

# 1. Get today's brief
curl https://orrery.me/api/x402/v1/brief/today

# 2. Pick the top mover, ask why
curl https://orrery.me/api/x402/v1/markets/<slug>/why

# 3. Verify the resolution source before acting
curl https://orrery.me/api/x402/v1/markets/<slug>/resolution-risk
Python quickstartTypeScript quickstartcURL / shellFree /health

What we don't do

  • • No trading recommendations.
  • • No predicted outcomes — public data interpretation only.
  • • No insider or non-public data sources.
  • • No copy-trading directives or "follow the whale" signals.
  • • Refuse any prompt that asks the API to fabricate alpha; the response policy is published in the catalog.

Listing

Orrery is listed (or being listed) on Agentic Market under Orrery Probability Intelligence. For partnerships, custom endpoints, or enterprise data access, email hello@orrery.me.

OpenAPI specService catalogllms.txtHuman docs
Orrery for AI agents — x402 intelligence API | Orrery