Quickstart · cURL

Probe Orrery from the shell

Useful for debugging, shell pipelines, language-agnostic integrations, and answering 'is the API alive?' Every endpoint accepts cURL and returns the same envelope shape as the SDK quickstarts.

Health check (free)

no payment required

curl -s https://orrery.me/api/x402/v1/health | jq

# Response shows the full endpoint catalog with prices,
# whether payment enforcement is on, and live upstream
# Polymarket health.

Today's brief

$0.01 USDC

PAYMENT="<x402-payment-proof>"
ORRERY_API_KEY="orrery_live_..."

curl -s https://orrery.me/api/x402/v1/brief/today \
  -H "X-Orrery-API-Key: $ORRERY_API_KEY" | jq '.data.headline'

curl -s https://orrery.me/api/x402/v1/brief/today \
  -H "X-PAYMENT: $PAYMENT" | jq '.data.headline'
# "Bitcoin above $80k moved -12.4pp in 24h to 14¢."

curl -s https://orrery.me/api/x402/v1/brief/today \
  -H "X-PAYMENT: $PAYMENT" | jq '.data.biggest_moves[0]'
# { "slug": "...", "question": "...", "delta_24h": -0.124, ... }

Find a market by free text

$0.005 USDC

PAYMENT="<x402-payment-proof>"

curl -s "https://orrery.me/api/x402/v1/search?q=bitcoin&limit=5" \
  -H "X-PAYMENT: $PAYMENT" | jq '.data.results'

Why did a market move? + resolution-risk

$0.02 + $0.01

PAYMENT="<x402-payment-proof>"
SLUG="bitcoin-above-80k-on-april-2026"

curl -s "https://orrery.me/api/x402/v1/markets/$SLUG/why" \
  -H "X-PAYMENT: $PAYMENT" \
  | jq '.data.factors'

curl -s "https://orrery.me/api/x402/v1/markets/$SLUG/resolution-risk" \
  -H "X-PAYMENT: $PAYMENT" \
  | jq '.data | {risk_level, primary_source, what_to_verify}'

Replay with X-PAYMENT

Paid endpoints first accept Orrery API keys that spend monthly credits. Without a valid key or payment proof, they return HTTP 402 with a JSON challenge. Settle on Base via your wallet, then attach the proof:

# 1. Probe the price.
curl -i https://orrery.me/api/x402/v1/brief/today | head -20
# HTTP/1.1 402 Payment Required
# PAYMENT-REQUIRED: {"scheme":"exact","network":"eip155:8453",...}

# 2. Settle on Base via your x402-compliant wallet, then replay:
curl -s https://orrery.me/api/x402/v1/brief/today \
  -H "X-PAYMENT: <on-chain settlement proof>" | jq '.meta.payment_status'
# "settled"

See the Coinbase x402 docs for the settlement format. Orrery is wallet-agnostic.

Tips

• All endpoints set permissive CORS — you can call them from a browser script too.
• jq is your friend for the envelope: .data is the payload, .meta has the price, source, and freshness.
• The HTTP rate-limit is 60 req/min/IP across all paid endpoints. The 429 response carries Retry-After.
• Python quickstart · TypeScript quickstart