{
  "name": "orcatrace",
  "description": "OrcaTrace — Polymarket intelligence on x402. Track smart money, see what others miss. Real-time prediction-market signals across 42K markets: quality-gated repricings with order-book microstructure, tracked-whale entries annotated with each wallet's hold-to-resolution calibration (follow/fade), and AI-detected predetermined-outcome markets — one unified, index-polled feed. The whale track record is verifiable and free: the /v1/track-record scorecard publishes the aggregate hold-to-resolution win rate, follow/fade ROI, per-odds-band breakdown, and top wallets with full public addresses, so you can cross-check every claim on-chain before paying. Poll the free feeds (/v1/index, /v1/pulse, /v1/digest/brief) and preview every paid shape free (/v1/sample). Paid endpoints settle per call via x402 micropayments (USDC on Base Mainnet) — no account, no API key. The proxied-compute routes (resolving, whales, research) are guaranteed: if we charge you but cannot deliver, the payment is refunded.",
  "url": "https://api.orcatrace.dev",
  "provider": {
    "organization": "OrcaTrace API",
    "url": "https://api.orcatrace.dev"
  },
  "version": "1.0.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "endpoints": [
    {
      "method": "GET",
      "path": "/v1/index",
      "params": [],
      "priceUsd": 0,
      "description": "Free (rate-limited 5/min per IP). Current Polymarket feed index — poll target to detect new items (cadence ~10min)."
    },
    {
      "method": "GET",
      "path": "/v1/pulse",
      "params": [],
      "priceUsd": 0,
      "description": "Free (rate-limited 5/min per IP). Top-3 Polymarket repricings (24h, noise-filtered) plus a digest teaser — the hook."
    },
    {
      "method": "GET",
      "path": "/v1/digest/brief",
      "params": [],
      "priceUsd": 0,
      "description": "Free (rate-limited 5/min per IP). Polymarket Intelligence Digest teaser: title + summary, no analysis. Full digest at GET /v1/digest ($0.10)."
    },
    {
      "method": "GET",
      "path": "/v1/sample",
      "params": [],
      "priceUsd": 0,
      "description": "Free (rate-limited 5/min per IP). Static samples of every paid Polymarket response shape (signal, whales, digest) — explicitly labelled. Use it to learn the contract before paying."
    },
    {
      "method": "GET",
      "path": "/v1/track-record",
      "params": [],
      "priceUsd": 0,
      "description": "Free (rate-limited 5/min per IP), no auth. Verifiable whale-calibration scorecard (the free proof behind paid /v1/whales): aggregate hold-to-resolution win rate, follow/fade ROI, per-odds-band breakdown, and top-10 wallets with full public addresses. Cross-check every wallet on Polymarket. Measures entries held to resolution, not trader P&L — not financial advice."
    },
    {
      "method": "GET",
      "path": "/v1/latest",
      "params": [],
      "priceUsd": 0.01,
      "description": "Paid ($0.01 USDC via x402). Most recent Polymarket feed item — mover, whale entry (with calibration), or predetermined signal. Same shape as /v1/signal without ?index. Free index poll: GET /v1/index; free shape preview: GET /v1/sample. Compute-first / settle-after — you are never charged for an error."
    },
    {
      "method": "GET",
      "path": "/v1/signal",
      "params": [
        "index"
      ],
      "priceUsd": 0.01,
      "description": "Paid ($0.01 USDC via x402). One Polymarket feed item: quality-gated mover (vol>=$10k & depth>=$2.5k, +order-book microstructure), whale entry (named whale, with calibration + microstructure), or predetermined signal. Use ?index=N for a specific item, omit for latest. Compute-first / settle-after — you are never charged for an error."
    },
    {
      "method": "GET",
      "path": "/v1/signals",
      "params": [
        "since",
        "count",
        "type"
      ],
      "priceUsd": 0.03,
      "description": "Paid ($0.03 USDC via x402). Batch Polymarket feed items (up to 20): quality-gated movers + order-book microstructure, whale entries with calibration, predetermined signals. Poll GET /v1/index (free), then ?since=N for new items; filter with &type=mover|whale_entry|predetermined. Compute-first / settle-after — you are never charged for an error."
    },
    {
      "method": "GET",
      "path": "/v1/digest",
      "params": [],
      "priceUsd": 0.1,
      "description": "Paid ($0.10 USDC via x402). Polymarket Intelligence Digest (every 4h): what repriced and why across 42K markets — significant moves, whale positioning interpreted through calibration, predetermined-outcome signals, and international news context. Synthesized analysis, not raw data. Never serves stale: returns 503 if generation falls behind (no charge). Compute-first / settle-after — you are never charged for an error."
    },
    {
      "method": "GET",
      "path": "/v1/digest/history",
      "params": [
        "hours",
        "limit"
      ],
      "priceUsd": 0.05,
      "description": "Paid ($0.05 USDC via x402). Historical Polymarket Intelligence Digests (up to 7 days, 4h cadence) — track how prediction-market narratives evolved: ?hours=24&limit=6. Compute-first / settle-after — you are never charged for an error."
    },
    {
      "method": "GET",
      "path": "/v1/resolving",
      "params": [
        "withinHours",
        "minLiquidity",
        "includeNoise"
      ],
      "priceUsd": 0.02,
      "description": "Paid ($0.02 USDC via x402). Markets resolving within ?withinHours (1-72): odds, contested-vs-converged, liquidity, and order-book microstructure for the nearest expiries. Mechanical short-interval markets excluded by default (?includeNoise=1 to include). Settle-early with a guaranteed refund — if we charge you but cannot deliver, the payment is refunded."
    },
    {
      "method": "GET",
      "path": "/v1/whales",
      "params": [],
      "priceUsd": 0.05,
      "description": "Paid ($0.05 USDC via x402). Whale calibration table: per-wallet hold-to-resolution win rates by odds band, mirror/fade ROI, and follow/fade labels (min 30 resolved entries). The data behind the whale_entry annotations in the signal feed; the free proof is GET /v1/track-record. Settle-early with a guaranteed refund — if we charge you but cannot deliver, the payment is refunded."
    },
    {
      "method": "GET",
      "path": "/v1/research",
      "params": [
        "market"
      ],
      "priceUsd": 1,
      "description": "Paid ($1.00 USDC via x402). Single-market deep-dive: 7-day price action + live order book + tracked-whale positioning with calibration + related international news, synthesized into a thesis with risks and an actionable bottom line. Generated on demand (10-60s); cached 30 minutes. Use ?market=<slug> from polymarket.com/market/<slug> or from our feed items. Settle-early with a guaranteed refund — if we charge you but cannot deliver, the payment is refunded."
    }
  ],
  "x402": {
    "version": 2,
    "networks": [
      "eip155:8453"
    ],
    "assets": [
      "USDC"
    ]
  },
  "skills": [
    {
      "id": "polymarket-latest",
      "name": "Most recent Polymarket feed item",
      "description": "Paid ($0.01 USDC via x402). Most recent Polymarket feed item — mover, whale entry (with calibration), or predetermined signal. Same shape as /v1/signal without ?index. Free index poll: GET /v1/index; free shape preview: GET /v1/sample. Compute-first / settle-after — you are never charged for an error.",
      "priceUsd": 0.01,
      "tags": [
        "orcatrace",
        "polymarket-latest"
      ]
    },
    {
      "id": "polymarket-signal",
      "name": "One Polymarket feed item",
      "description": "Paid ($0.01 USDC via x402). One Polymarket feed item: quality-gated mover (vol>=$10k & depth>=$2.5k, +order-book microstructure), whale entry (named whale, with calibration + microstructure), or predetermined signal. Use ?index=N for a specific item, omit for latest. Compute-first / settle-after — you are never charged for an error.",
      "priceUsd": 0.01,
      "tags": [
        "orcatrace",
        "polymarket-signal"
      ]
    },
    {
      "id": "polymarket-signals",
      "name": "Batch Polymarket feed items",
      "description": "Paid ($0.03 USDC via x402). Batch Polymarket feed items (up to 20): quality-gated movers + order-book microstructure, whale entries with calibration, predetermined signals. Poll GET /v1/index (free), then ?since=N for new items; filter with &type=mover|whale_entry|predetermined. Compute-first / settle-after — you are never charged for an error.",
      "priceUsd": 0.03,
      "tags": [
        "orcatrace",
        "polymarket-signals"
      ]
    },
    {
      "id": "polymarket-digest",
      "name": "Polymarket Intelligence Digest",
      "description": "Paid ($0.10 USDC via x402). Polymarket Intelligence Digest (every 4h): what repriced and why across 42K markets — significant moves, whale positioning interpreted through calibration, predetermined-outcome signals, and international news context. Synthesized analysis, not raw data. Never serves stale: returns 503 if generation falls behind (no charge). Compute-first / settle-after — you are never charged for an error.",
      "priceUsd": 0.1,
      "tags": [
        "orcatrace",
        "polymarket-digest"
      ]
    },
    {
      "id": "polymarket-digest-history",
      "name": "Historical Polymarket digests",
      "description": "Paid ($0.05 USDC via x402). Historical Polymarket Intelligence Digests (up to 7 days, 4h cadence) — track how prediction-market narratives evolved: ?hours=24&limit=6. Compute-first / settle-after — you are never charged for an error.",
      "priceUsd": 0.05,
      "tags": [
        "orcatrace",
        "polymarket-digest-history"
      ]
    },
    {
      "id": "polymarket-resolving",
      "name": "Markets resolving soon",
      "description": "Paid ($0.02 USDC via x402). Markets resolving within ?withinHours (1-72): odds, contested-vs-converged, liquidity, and order-book microstructure for the nearest expiries. Mechanical short-interval markets excluded by default (?includeNoise=1 to include). Settle-early with a guaranteed refund — if we charge you but cannot deliver, the payment is refunded.",
      "priceUsd": 0.02,
      "tags": [
        "orcatrace",
        "polymarket-resolving"
      ]
    },
    {
      "id": "polymarket-whales",
      "name": "Whale calibration table",
      "description": "Paid ($0.05 USDC via x402). Whale calibration table: per-wallet hold-to-resolution win rates by odds band, mirror/fade ROI, and follow/fade labels (min 30 resolved entries). The data behind the whale_entry annotations in the signal feed; the free proof is GET /v1/track-record. Settle-early with a guaranteed refund — if we charge you but cannot deliver, the payment is refunded.",
      "priceUsd": 0.05,
      "tags": [
        "orcatrace",
        "polymarket-whales"
      ]
    },
    {
      "id": "polymarket-research",
      "name": "Single-market deep-dive research",
      "description": "Paid ($1.00 USDC via x402). Single-market deep-dive: 7-day price action + live order book + tracked-whale positioning with calibration + related international news, synthesized into a thesis with risks and an actionable bottom line. Generated on demand (10-60s); cached 30 minutes. Use ?market=<slug> from polymarket.com/market/<slug> or from our feed items. Settle-early with a guaranteed refund — if we charge you but cannot deliver, the payment is refunded.",
      "priceUsd": 1,
      "tags": [
        "orcatrace",
        "polymarket-research"
      ]
    }
  ],
  "authentication": {
    "schemes": [
      "none",
      "x402"
    ],
    "description": "Free endpoints need no auth. Paid endpoints use the x402 V2 HTTP-402 flow: on an unpaid request the server returns a 402 whose accepts[] lists an exact USDC rail per network. Sign one rail and retry with the PAYMENT-SIGNATURE header (x402 V2) or legacy X-PAYMENT header. Per-call pricing."
  },
  "documentationUrl": "https://api.orcatrace.dev/llms.txt",
  "openApiUrl": "https://api.orcatrace.dev/openapi.json",
  "termsOfService": "https://api.orcatrace.dev/terms.txt"
}
