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 research and verification intelligence, including source context, freshness, 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.

Orrery for AI agents

Agent distribution layer

Let agents ask Orrery what changed before they summarize it.

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

Envelope contract

snapshot_id and freshness

sources and endpoint metadata

not_trade_advice=true

x402 or credit-backed paid calls

Start here

developer path

Agent docs First paid call MCP setup Service manifest

No-login discovery

Start with public docs, health, catalog, brief preview, and search 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.

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.