@orrery-labs/client

Typed read-only client for the Orrery x402 prediction-market intelligence API.

The client calls Orrery only. It does not connect to Polymarket or Kalshi accounts, submit orders, read positions, or provide trade recommendations.

import { OrreryClient, OrreryPaymentRequired } from "@orrery-labs/client";

const client = new OrreryClient({
  apiKey: process.env.ORRERY_API_KEY,
  payment: process.env.ORRERY_X_PAYMENT,
});

try {
  const queue = await client.attention({ limit: 5 });
  console.log(queue.data);
} catch (err) {
  if (err instanceof OrreryPaymentRequired) {
    console.log(err.challenge);
  }
}

apiKey spends monthly Orrery API credits first. payment is the x402 fallback for per-call settlement when credits are unavailable or exhausted. When omitted, the client reads ORRERY_BASE_URL, ORRERY_API_KEY, and ORRERY_X_PAYMENT from the Node environment.

Covered helpers:

• health / venues / brief
• search / markets / movers / events / event cluster
• attention queue / market Decision Card
• market snapshot / why / resolution risk
• signals / signal-kind drilldown / backtest
• category intelligence / trades / wallet profile / share card
• watchlist summary / portfolio risk

Local verification:

npm install
npm run check
npm run build