Orcatrace

OrcaTrace — Polymarket Intelligence for AI Agents

API at https://api.orcatrace.dev (website https://orcatrace.dev). Track smart money, see what others miss. OrcaTrace serves real-time Polymarket signals across 42K markets in one unified, index-polled feed: quality-gated movers (genuine repricings, noise-filtered, vol >= $10k & depth >= $2.5k, with order-book microstructure), tracked-whale entries (each annotated with that wallet's hold-to-resolution calibration — a follow/fade/neutral label from resolved, on-chain-auditable positions), and AI-detected predetermined markets (outcome already exists in definitive form). On top of the feed it produces the 4-hourly Intelligence Digest, lists markets resolving soon, publishes a whale calibration table, and runs on-demand $1 single-market deep research. Strictly pay-per-call via x402 — no accounts, no API keys, no bundles.

OrcaTrace is the Polymarket-intelligence product spun out of moltalyzer. The old paths /api/polymarket/* on api.moltalyzer.xyz 308-redirect here — point new integrations at api.orcatrace.dev.

Free endpoints (no auth, no payment)

Poll the free feeds to detect new items and learn every paid response shape before paying. /v1/sample returns static samples of every paid shape, explicitly labelled, so it is safe for shape-testing without implying live data. /v1/track-record is the verifiable free proof behind paid /v1/whales — it publishes full public wallet addresses so you can cross-check every claim on Polymarket before paying. All free endpoints are rate-limited 5/min per IP.

curl https://api.orcatrace.dev/v1/track-record

Paid endpoints (x402 V2, USDC on Base only, per-call)

Each paid call is a flat price per call, settled per call via x402. Networks: Base Mainnet only (eip155:8453). Two settlement patterns apply (see notes below the table).

Params. /v1/signal: index (integer, omit for latest). /v1/signals: since (integer, poll cursor), count (integer 1-20, default 10), type (mover, whale_entry, or predetermined). /v1/resolving: withinHours (integer 1-72, default 24), minLiquidity (number >=1000, default 5000), includeNoise (set to 1 to include mechanical short-interval markets). /v1/digest/history: hours (integer 1-168, default 24), limit (integer 1-42, default 6). /v1/research: market (Polymarket market slug, required — from polymarket.com/market/ or our feed items). All prices are USD, settled as USDC (6 decimals) on Base.

Settlement patterns — never charged for nothing

• Compute-first / settle-after (DB reads: latest, signal, signals, digest, digest/history) — computed first, settled after; you are never charged for an error.
• /v1/digest never serves stale data — a digest older than 6 hours is not sold: the route returns 503 (no charge) rather than serving stale paid intelligence.
• Settle-early with a GUARANTEED refund (proxied compute: resolving, whales, research) — these settle early to dispatch the compute, but are guaranteed: if OrcaTrace charges you and cannot deliver a 2xx result, the payment is automatically refunded (a rail-tagged RefundRequest is queued and issued off the public edge).

Paying (x402)

Paid routes settle per call via x402 V2. The only accepted rail is USDC on Base Mainnet (eip155:8453) — no other network. No account, no signup, no API key.

Pay flow:

1. Call the paid route with no payment → receive HTTP 402. The x402 V2 PaymentRequirements ride in the base64 PAYMENT-REQUIRED header; the JSON body mirrors the price + accepts.
2. Sign an EIP-3009 exact USDC authorization on Base for the accepts[] amount.
3. Retry the same request with the payment in the PAYMENT-SIGNATURE (V2) or X-PAYMENT (legacy) header.

# 1. Probe for the 402 challenge (price + accepts):
curl -i "https://api.orcatrace.dev/v1/whales"
# → HTTP/1.1 402 Payment Required, PAYMENT-REQUIRED header (base64 requirements)

# 2. Sign + retry with a stock x402 client (handles the whole flow):

import { wrapFetchWithPayment } from "@x402/fetch";
import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";

const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);
const wallet = createWalletClient({ account, chain: base, transport: http() });
const fetchWithPay = wrapFetchWithPayment(fetch, wallet); // signs EIP-3009 on 402, retries

// $0.05 — whale calibration table (free proof: /v1/track-record):
const whales = await fetchWithPay(
  "https://api.orcatrace.dev/v1/whales",
).then((r) => r.json());
// whales.data.wallets[] (pseudonym, wallet, resolved, winRate, fadeRoi, label)

// $1.00 — single-market deep research (guaranteed refund on non-delivery):
const research = await fetchWithPay(
  "https://api.orcatrace.dev/v1/research?market=next-us-iran-meeting-switzerland",
).then((r) => r.json());

Stock x402 clients (@x402/fetch, @x402/axios, python x402) do the 402 → sign → retry automatically. Discover the machine-readable route + price catalog at /.well-known/x402.

Free funnel

Try the whole product for free before you pay. Poll /v1/index (5/min) to detect new feed items on their ~10min cadence; read /v1/pulse (5/min) for the top-3 24h movers + digest teaser, /v1/digest/brief (5/min) for the digest title + summary; hit /v1/sample (5/min) for static samples of every paid response shape to learn the exact contract before spending. /v1/track-record (5/min) is the verifiable whale scorecard with full public wallet addresses — the free proof behind paid /v1/whales, so you can audit every calibration claim on Polymarket before paying a cent. Feed items and digests carry createdAt provenance so you always know how fresh the data is.

Machine discovery

Terms: https://api.orcatrace.dev/terms.txt

Disclaimer: Polymarket intelligence aggregated from public prediction-market data and LLM-synthesized; informational only, provided as-is without warranty. Whale calibration measures entries held to resolution, not trader P&L (exits are not tracked) — not financial advice. Digest and research analysis is model-generated and may be imperfect — every response carries createdAt provenance so you can judge freshness.