Can agents use Orrery without a custom integration?

Yes. Agents can call the x402 HTTP API directly, use SDK examples, or connect through Orrery MCP tools.

Does Orrery return trading recommendations?

No. Orrery returns read-only prediction-market evidence, including source context, freshness, source health, and not_trade_advice flags.

How does payment work for agents?

Orrery supports x402 paid calls and account credit packs. The API can return HTTP 402 challenges for paid endpoints.

Prediction-market evidence API for AI agents

Agent distribution layer

Let agents ask Orrery whether a market move can be trusted.

Orrery turns public prediction-market data into compact, source-aware evidence packets. Every workflow keeps the product boundary clear: research, verification, and monitoring only.

Envelope contract

snapshot_id and freshness

source_status and degraded_sources

sources and endpoint metadata

not_trade_advice=true

x402 or credit-backed paid calls

Start here

developer path

Agent docs Free starter API Free market search First paid call B2B API onboarding MCP setup Service manifest

No-login discovery

Start with /api/free/v1 health, catalog, brief preview, movers, search, and snapshot-lite endpoints.

Paid per call

Use x402 for direct HTTP 402 settlement or account credits for managed usage.

MCP access

Expose Orrery tools inside Claude, Cursor, ChatGPT-style workflows, and internal agents.

B2B API readiness

platform contract

API keys

Account keys spend monthly credits before the same endpoint falls back to x402.

Usage and receipts

Admin telemetry tracks settled or API-credit calls; public receipts stay redacted.

SLA and rate limits

B2B pilots pin expected freshness, caps, 429 behavior, and schema-change notice.

Open B2B API onboarding

High-value tools

copy into agents

attention queue

/api/x402/v1/decision/attention

Rank what changed and what deserves inspection.

market decision

/api/x402/v1/decision/market/{id}

Get a compact market snapshot with source and confidence context.

resolution risk

/api/x402/v1/markets/{id}/resolution-risk

Separate live, expired, pending, pinned, disputed, and resolved states.

share card

/api/x402/v1/share-card/{slug}

Generate copy-ready social, Discord, Telegram, or newsletter artifacts.

Safety boundary

required

Orrery tools do not execute trades, predict outcomes, recommend positions, or label wallets as copy targets. Agents should present Orrery output as verification context, not as instructions to trade.