predictionguard

PredictionGuard platform overview: covered platforms, tool inventory, Polymarket Gamma API ping, Polygon RPC ping (Ankr-backed), known-case count.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Search Polymarket markets by keyword (e.g. 'election', 'fed', 'bitcoin'). Returns question, slug, 24h volume, liquidity, end date.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keyword to search"
    },
    "limit": {
      "type": "integer",
      "description": "Max results (default 10, max 50)",
      "default": 10
    },
    "active_only": {
      "type": "boolean",
      "description": "Only active / non-closed markets",
      "default": true
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Full market info: outcomes, outcome prices, volume, liquidity, best bid/ask, spread, resolution source, conditionId. Provide 'slug' or 'id'.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Market slug"
    },
    "id": {
      "type": "string",
      "description": "Market id / conditionId"
    }
  },
  "additionalProperties": false
}

Volume anomaly heuristic: compares 24h volume vs average daily volume since market start (z-like ratio) and flags thin-book situations where 24h volume >> on-book liquidity.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

Multi-signal integrity scan: combines thin-book flag, spread, low liquidity, geopolitical-term pattern, end-date proximity, and 24h volume concentration. Returns score 0-100, level HIGH/MEDIUM/LOW/CLEAN, triggered signals, and an operational recommendation.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

Top Polymarket markets by 24h volume. Useful for daily compliance triage / catching news catalysts before they land in mainstream coverage.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max results (default 10, max 25)",
      "default": 10
    }
  },
  "additionalProperties": false
}

Registry of publicly reported prediction-market integrity cases (Théo / French whale, Hyperliquid whale, Venezuela, Iran strikes, Nuclear, UMA Ukraine). Filter by category or minimum AML relevance (low/medium/high). Summaries only — no accusations against named parties.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "Optional category substring (e.g. 'geopolitical', 'oracle')"
    },
    "min_aml_relevance": {
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high"
      ],
      "description": "Minimum AML relevance"
    }
  },
  "additionalProperties": false
}

Polygon wallet base profile via JSON-RPC (Ankr-backed when RPC_POLYGON is set, public fallback otherwise). Returns MATIC balance, outbound tx count, contract-vs-EOA detection, and a lightweight risk heuristic.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Polygon address (0x + 40 hex chars)"
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false
}

Screen a named entity against global sanctions lists (OFAC SDN, EU FSF, UN SC, Interpol). Delegates to AMLOracle. Use after resolving a wallet/trader to a real name via public reporting or known-case registry.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Person or entity name"
    },
    "entity_type": {
      "type": "string",
      "description": "Optional: 'person' or 'organization'"
    },
    "threshold": {
      "type": "number",
      "description": "Optional fuzzy-match threshold (0..1)"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

Politically Exposed Person (PEP) check via Wikidata. Delegates to AMLOracle. Relevant for prediction markets where reported traders overlap with political figures.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Person name"
    },
    "country": {
      "type": "string",
      "description": "Optional ISO country code"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

Adverse media scan — negative news on fraud, money laundering, corruption, sanctions. Delegates to AMLOracle. Core building block for evidence chains that link a wallet or trader to publicly reported concerns (always cite the source, never attribute).

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Person or entity name"
    },
    "lang": {
      "type": "string",
      "description": "Optional language (e.g. en, de)"
    },
    "limit": {
      "type": "integer",
      "description": "Max results (default upstream)"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

Full KYC bundle for a named entity: sanctions + PEP + adverse media + country risk in a single call. Delegates to AMLOracle.kyc_bundle.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "country": {
      "type": "string",
      "description": "ISO country code"
    },
    "entity_type": {
      "type": "string",
      "description": "'person' or 'organization'"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

Issue a cryptographically signed, on-chain anchored integrity alert for a Polymarket market. Combines evidence_anchor + get_signed_fact from FeedOracle Trust Layer. Alerts are anchored on Polygon with an ECDSA signature and are externally verifiable via pg_verify_alert and the JWKS at feedoracle.io/.well-known/jwks.json.

{
  "type": "object",
  "properties": {
    "market_slug": {
      "type": "string",
      "description": "Polymarket market slug"
    },
    "claim": {
      "type": "string",
      "description": "Short human-readable claim being asserted"
    },
    "severity": {
      "type": "string",
      "enum": [
        "LOW",
        "MEDIUM",
        "HIGH",
        "CRITICAL"
      ],
      "description": "Alert severity",
      "default": "MEDIUM"
    },
    "signals": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of integrity signals triggered"
    },
    "wallets": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional list of related wallet addresses"
    }
  },
  "required": [
    "market_slug",
    "claim"
  ],
  "additionalProperties": false
}

Complete forensic dossier for a single Polymarket market: market details + integrity scan + volume anomaly profile + Trust Layer provenance trace — aggregated into one dossier ready for manual review, press inquiry, or as input to a SAR report.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Market slug"
    },
    "id": {
      "type": "string",
      "description": "Market id / conditionId"
    }
  },
  "additionalProperties": false
}

Verify a previously issued signed alert (JWS or content-hash). Delegates to Trust Layer verify_signature. Returns validity, signer, and timestamp. JWKS at feedoracle.io/.well-known/jwks.json.

{
  "type": "object",
  "properties": {
    "jws": {
      "type": "string",
      "description": "Full JWS string"
    },
    "content_hash": {
      "type": "string",
      "description": "SHA-256 content hash (alternative to JWS)"
    }
  },
  "additionalProperties": false
}

Resolve a Polygon address to a known entity via PredictionGuard's Wallet Registry (Polymarket core contracts, major stablecoins, known CEX hot wallets), falling back to on-chain heuristic classification for unknown addresses. Returns entity name, type, category, AML relevance, confidence, and source-of-record URL.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Polygon address (0x + 40 hex chars)"
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false
}

Aggregated A–F risk profile for a Polygon wallet. Combines on-chain behavior (pg_wallet_lookup), entity resolution (pg_wallet_entity_resolve), and — where the entity can be screened — AML bundle (sanctions + PEP + adverse media via AMLOracle). Grade A = clean, F = blocked. Includes triggered flags with points deductions for full auditability.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Polygon address (0x + 40 hex chars)"
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false
}

Add a Polygon wallet to the PredictionGuard watchlist. Takes an initial baseline snapshot so subsequent pg_whale_scan calls can detect movement. Set alert_threshold_matic to tune sensitivity (default 100 MATIC). Tags are free-form.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Polygon address (0x + 40 hex)"
    },
    "alias": {
      "type": "string",
      "description": "Optional human-readable label"
    },
    "alert_threshold_matic": {
      "type": "number",
      "description": "Balance delta threshold in MATIC for alerts (default 100)",
      "default": 100
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Free-form tags (e.g. ['polymarket','pre-election','whale'])"
    },
    "notes": {
      "type": "string",
      "description": "Free-form notes"
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false
}

Remove a wallet from the watchlist. By default keeps historical snapshots and alerts (for audit trail). Set keep_history=false to purge everything for this address.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    },
    "keep_history": {
      "type": "boolean",
      "description": "Keep snapshot + alert history (default true)",
      "default": true
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false
}

List all watched wallets with their alias, threshold, tags, notes, and last snapshot. Optionally filter by tag.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 100,
      "description": "Max results (max 500)"
    },
    "tag": {
      "type": "string",
      "description": "Optional tag filter"
    }
  },
  "additionalProperties": false
}

Scan one or all watched wallets against Polygon RPC. Compares current balance + nonce to the last snapshot, writes a new snapshot, and emits an alert when the delta exceeds the wallet's configured threshold. Severity is MEDIUM / HIGH / CRITICAL by delta size. Omit 'address' to scan the entire watchlist. Designed to be called periodically via SchedulerOracle or a systemd timer.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Optional — scan a single address. Omit to scan the whole list."
    }
  },
  "additionalProperties": false
}

Retrieve alerts from the watchlist audit log. Filter by address, severity (LOW/MEDIUM/HIGH/CRITICAL), and/or ISO timestamp 'since'. Default returns the 50 most recent alerts across the whole watchlist.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    },
    "severity": {
      "type": "string",
      "enum": [
        "LOW",
        "MEDIUM",
        "HIGH",
        "CRITICAL"
      ]
    },
    "since": {
      "type": "string",
      "description": "ISO 8601 timestamp (e.g. 2026-04-20T00:00:00Z)"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "description": "Max results (max 500)"
    }
  },
  "additionalProperties": false
}

Global UMA Optimistic Oracle health on Polygon. Scans event logs from OOv2 (and optionally OOv1) over a configurable window, tallies events by type (RequestPrice / ProposePrice / DisputePrice / Settle), computes per-hour rate, and derives a dispute/propose ratio — a leading indicator of oracle-level contention.

{
  "type": "object",
  "properties": {
    "blocks_back": {
      "type": "integer",
      "description": "Blocks to scan back (default 5000 ≈ 3h, max 20000)",
      "default": 5000
    },
    "include_v1": {
      "type": "boolean",
      "description": "Also scan UMA OOv1 (legacy, default false)",
      "default": false
    }
  },
  "additionalProperties": false
}

Resolution source and phase for a specific Polymarket market. Fetches market metadata from Gamma, extracts the resolutionSource address, verifies it's a deployed contract on Polygon, and classifies the resolution phase (active_trading / approaching_resolution / imminent_resolution_window / past_end_awaiting_resolution / resolved).

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Market slug"
    },
    "id": {
      "type": "string",
      "description": "Market id / conditionId"
    }
  },
  "additionalProperties": false
}

Multi-signal resolution-risk score (0–100, CLEAN/LOW/MEDIUM/HIGH/CRITICAL) for a Polymarket market. Combines category priors (geopolitical/election/sanctions patterns from pg_known_cases), resolution-phase proximity, market volume, resolution-source sanity check (is the UMA adapter a real deployed contract), UMA global dispute ratio, and thin-book flag. Returns triggered signals with point deductions for full auditability.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

Generate a draft Suspicious Activity Report (SAR/STR) from structured inputs. Supports EU_GENERIC (FATF-aligned STR, default), US_FINCEN (Form 111 structure), and DE_goAML (German FIU draft). Takes subject, market, activity window, integrity signals, and evidence references — auto-classifies the primary suspicious activity type, generates a narrative, and renders regulator-style markdown. Output is marked draft_for_review; PredictionGuard does not submit SARs directly.

{
  "type": "object",
  "properties": {
    "subject": {
      "type": "object",
      "description": "Required. The subject of the report.",
      "properties": {
        "wallet_address": {
          "type": "string"
        },
        "entity_name": {
          "type": "string"
        },
        "entity_type": {
          "type": "string",
          "enum": [
            "person",
            "organization",
            "unknown"
          ]
        },
        "network": {
          "type": "string"
        },
        "aml_relevance": {
          "type": "string"
        },
        "risk_grade": {
          "type": "string"
        },
        "risk_score": {
          "type": "number"
        }
      }
    },
    "market": {
      "type": "object",
      "description": "Optional. Polymarket market context.",
      "properties": {
        "slug": {
          "type": "string"
        },
        "question": {
          "type": "string"
        },
        "volume_usd": {
          "type": "number"
        },
        "volume_24h_usd": {
          "type": "number"
        },
        "liquidity_usd": {
          "type": "number"
        },
        "end_date": {
          "type": "string"
        }
      }
    },
    "activity": {
      "type": "object",
      "description": "Activity window and amounts.",
      "properties": {
        "amount_usd": {
          "type": "number"
        },
        "date_start": {
          "type": "string"
        },
        "date_end": {
          "type": "string"
        }
      }
    },
    "signals": {
      "type": "array",
      "description": "Integrity signals (strings or objects with 'term'/'reason'/'layer'). Pass the 'triggered_signals' array from pg_market_integrity_scan or pg_resolution_risk_score directly.",
      "items": {
        "type": [
          "string",
          "object"
        ]
      }
    },
    "evidence": {
      "type": "object",
      "description": "References to prior evidence.",
      "properties": {
        "signed_alerts": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "related_wallets": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "related_markets": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "filer": {
      "type": "object",
      "description": "Information about the preparing institution.",
      "properties": {
        "institution": {
          "type": "string"
        },
        "contact_name": {
          "type": "string"
        },
        "contact_email": {
          "type": "string"
        }
      }
    },
    "filing_jurisdiction": {
      "type": "string",
      "enum": [
        "EU_GENERIC",
        "US_FINCEN",
        "DE_goAML"
      ],
      "description": "Report format. Default EU_GENERIC.",
      "default": "EU_GENERIC"
    },
    "narrative_addendum": {
      "type": "string",
      "description": "Optional free-text addendum from the analyst."
    }
  },
  "required": [
    "subject"
  ],
  "additionalProperties": false
}

Raw trade access for a Polymarket market via the Polymarket Data API. Supports client-side filters: time range (from/to, ISO 8601), side (BUY/SELL), minimum trade size, or a specific wallet. Paginates server-side (max 25 pages × 1000 trades). Returns compact records with wallet, pseudonym, side, size, price, notional USD, outcome, timestamp, tx_hash.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Polymarket market slug"
    },
    "id": {
      "type": "string",
      "description": "Market id / conditionId"
    },
    "limit": {
      "type": "integer",
      "default": 100,
      "description": "Max trades to return after filtering (default 100, max 5000)"
    },
    "max_pages": {
      "type": "integer",
      "default": 2,
      "description": "How many pages of 1000 to fetch (default 2, max 25)"
    },
    "from": {
      "type": "string",
      "description": "Only include trades from this ISO timestamp"
    },
    "to": {
      "type": "string",
      "description": "Only include trades up to this ISO timestamp"
    },
    "side": {
      "type": "string",
      "enum": [
        "BUY",
        "SELL"
      ],
      "description": "Only trades on this side"
    },
    "min_size": {
      "type": "number",
      "description": "Minimum trade size (shares)"
    },
    "wallet": {
      "type": "string",
      "description": "Filter to a single wallet address"
    }
  },
  "additionalProperties": false
}

Analyze pre-resolution positioning on a Polymarket market. For the N days before the market's endDate, aggregates trades by wallet, classifies wallets new to the market in that window, detects volume concentration, timing clusters (minutes where ≥5 distinct wallets trade in sync), and pre-event volume spikes vs historical average. Returns a 0–100 risk score (CRITICAL/HIGH/MEDIUM/LOW/CLEAN) with triggered signals, top 10 positioners, and top 10 new wallets. Default window = 7 days.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "days_before_end": {
      "type": "number",
      "default": 7,
      "description": "Pre-event window size in days (1–90, default 7)"
    },
    "max_pages": {
      "type": "integer",
      "default": 10,
      "description": "Trade pagination depth (default 10, max 25)"
    }
  },
  "additionalProperties": false
}

Real-time insider-trading signal scan for a single Polymarket market. Aggregates 5 signals: (1) very large pre-event positions, (2) high ratio of wallets new to this market, (3) coordinated minute-bucket timing clusters, (4) one-sided positioning, (5) sensitive-keyword category match (military/regime/intel). Returns a 0-100 score (CLEAN/LOW/MEDIUM/HIGH/CRITICAL), triggered signals with evidence, top 5 positioners with new-wallet flag, and full methodology for audit. Default window = 72h before market end.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Polymarket market slug"
    },
    "id": {
      "type": "string",
      "description": "Market id / conditionId"
    },
    "window_hours": {
      "type": "integer",
      "default": 72,
      "description": "Pre-event window to analyze (default 72h)"
    },
    "min_position_usd": {
      "type": "number",
      "default": 1000,
      "description": "Min notional to flag (default $1000)"
    }
  },
  "additionalProperties": false
}

Find wallets that co-trade across multiple sensitive Polymarket markets with a target wallet. Given a wallet and 2-10 market slugs, returns: which markets the target traded, top 20 cotraders ranked by overlap count, and an aggregate severity score (≥3 shared markets = MEDIUM, ≥5 = HIGH). Use case: detect coordinated trading rings, shared-info syndicates, or wallet clusters that consistently bet on the same sensitive events.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Target wallet address (0x + 40 hex)"
    },
    "markets": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "2-10 market slugs to check for co-trading overlap"
    }
  },
  "required": [
    "wallet",
    "markets"
  ],
  "additionalProperties": false
}

Statistical timing analysis of a single wallet's position on a specific market. Checks: (1) how close to resolution the wallet entered (<6h=35pts, <24h=25pts, <72h=10pts), (2) position size vs market average (>20× avg=25pts, >5× avg=10pts), (3) single-bet pattern (≤3 trades=10pts, no historical trading rationale). Returns 0-100 score, first-trade timestamp, total notional, and methodology. Pair with pg_information_advantage_score for full assessment.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Market slug"
    },
    "id": {
      "type": "string",
      "description": "Market id / conditionId"
    },
    "wallet": {
      "type": "string",
      "description": "Wallet to analyze (0x + 40 hex)"
    }
  },
  "required": [
    "wallet"
  ],
  "additionalProperties": false
}

Composite A-F rating for whether a wallet appears to have had non-public information on a specific market. Aggregates pg_position_timing_anomaly (50% weight) + pg_insider_signal_scan (30%) plus bonuses for being in top positioners (+10), new to market (+10), and sensitive category (+10). Returns letter grade A-F, composite score 0-100, all component scores, and interpretation guide. Pattern-matches reported cases (Van Dyke, Hyperliquid whale). Statistical signal only — not a legal determination.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Market slug"
    },
    "id": {
      "type": "string",
      "description": "Market id / conditionId"
    },
    "wallet": {
      "type": "string",
      "description": "Wallet to score (0x + 40 hex)"
    }
  },
  "required": [
    "wallet"
  ],
  "additionalProperties": false
}

Daily compliance triage: scans top Polymarket markets by 24h volume and flags those whose question text matches curated sensitive-keyword categories — military action, regime change, leadership death, diplomacy, intelligence ops, monetary policy, regulatory action. Returns flagged markets with monitoring severity (HIGH/MEDIUM/LOW), matched categories and keywords, and volume. Pair flagged HIGH markets with pg_insider_signal_scan for active surveillance.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "description": "Max markets to scan (default 25, max 100)"
    },
    "category": {
      "type": "string",
      "description": "Optional: filter to one category (military_action, regime_change, leadership_death, diplomacy, intelligence, monetary_policy, regulatory_action)"
    }
  },
  "additionalProperties": false
}

Search Kalshi prediction markets (CFTC-regulated event contracts). Returns events ranked by aggregate 24h volume across all markets in the event. Kalshi categories include Elections, Politics, Economics, Climate, Sports, Entertainment, Financials. Public data, no auth needed. Each event has one or more child markets (mutually exclusive or yes/no).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keyword search in title, sub_title, event_ticker"
    },
    "category": {
      "type": "string",
      "description": "Optional category filter (Elections, Politics, Economics, ...)"
    },
    "status": {
      "type": "string",
      "default": "open",
      "enum": [
        "open",
        "closed",
        "settled"
      ]
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "description": "Max events to return (default 25, max 100)"
    }
  },
  "additionalProperties": false
}

Detailed Kalshi market or event info. Pass 'ticker' for a single market (returns yes/no bids+asks, last price, volume, OI, spread, hours until close) or 'event_ticker' for all markets in an event (multi-outcome). Includes the rules_primary text (Kalshi's settlement criteria) which is critical for understanding resolution risk.

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Kalshi market ticker (e.g. KXG7LEADEROUT-45JAN01-DJT)"
    },
    "event_ticker": {
      "type": "string",
      "description": "Kalshi event ticker (returns all child markets)"
    }
  },
  "additionalProperties": false
}

Top trending Kalshi events ranked by aggregate 24h volume across child markets. Filterable by category. Daily-briefing-ready output. Includes the highest-volume sub-market per event.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "Optional category filter (Elections, Politics, ...)"
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "description": "Max events to return (default 25, max 50)"
    }
  },
  "additionalProperties": false
}

Forensic orderbook analysis for one Kalshi market. Detects manipulation-vulnerable patterns: (1) wide spread (>$0.10), (2) shallow depth (<10 contracts), (3) few price levels, (4) single-order dominance (>80% in top level), (5) penny-wall pattern (large bids at ≤$0.005, commonly used to fake depth). Returns 0-100 score, severity, and full level-by-level data. Kalshi returns bids only — implied asks computed via yes_bid + no_bid = $1 reciprocity.

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Kalshi market ticker"
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false
}

Scan all open Kalshi markets and flag those that are manipulation-vulnerable: closing soon (<24h), low open interest, low liquidity, wide spread, low volume. Daily triage tool. Returns markets ranked by risk_score (≥30 threshold). Best paired with pg_kalshi_resolution_calendar for full compliance briefing.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "Optional category filter"
    },
    "max_results": {
      "type": "integer",
      "default": 25,
      "description": "Max flagged markets (default 25, max 50)"
    }
  },
  "additionalProperties": false
}

Compliance briefing: which Kalshi markets resolve in the next N hours? Bucketed by 6h, 24h, 48h, 1 week. Flags markets in CFTC-sensitive categories (Elections, Politics). Use for daily surveillance prep — markets near resolution have highest insider-trading risk window.

{
  "type": "object",
  "properties": {
    "hours_ahead": {
      "type": "integer",
      "default": 48,
      "description": "Look-ahead window (default 48h, max 168h)"
    },
    "min_open_interest": {
      "type": "number",
      "default": 0,
      "description": "Only markets with at least this OI"
    },
    "category": {
      "type": "string",
      "description": "Optional category filter"
    }
  },
  "additionalProperties": false
}

CFTC Rule 5.17(z) conflict-of-interest pre-trade check. Analyzes a Kalshi market's metadata to detect whether trading it would expose decision-makers (election candidates, government officials, athletes, regulators) to insider-trading liability. Pattern-matches against the Kalshi April 2026 disciplinary cases (Moran/Klein/Enriquez) and the CFTC Van Dyke complaint. Returns ALLOW/MONITOR/WARN/BLOCK recommendation + 0-100 score + reference cases. Cannot identify actual trader identity (Kalshi public API anonymizes users) — pair with internal surveillance for full enforcement.

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Kalshi market ticker"
    },
    "event_ticker": {
      "type": "string",
      "description": "Or event_ticker for the whole event"
    },
    "candidate_name": {
      "type": "string",
      "description": "Optional: specific person's name to match against title (e.g. 'Mark Moran')"
    }
  },
  "additionalProperties": false
}

Pre-trade integrity gate for AI agents and compliance teams. ONE call returns ALLOW/WARN/BLOCK decision + risk_level (0-100) + signed evidence receipt. Aggregates orderbook analysis, resolution-window risk, CFTC Rule 5.17(z) conflict-of-interest check, and (Polymarket) insider signal scan. Supports both Polymarket (slug) and Kalshi (ticker). Optional inputs: wallet (Polymarket-side checks), candidate name (Kalshi Rule 5.17(z) name match), amount_usd (amplifies risk for large bets on thin markets). Returns hashable + ECDSA-signed receipt for audit. Designed for x402 paywall pre-trade calls — agent pays once, gets binary go/no-go.

{
  "type": "object",
  "properties": {
    "platform": {
      "type": "string",
      "enum": [
        "polymarket",
        "kalshi"
      ],
      "description": "Which prediction market"
    },
    "market_id": {
      "type": "string",
      "description": "Polymarket slug or Kalshi ticker/event_ticker"
    },
    "wallet": {
      "type": "string",
      "description": "Optional: Polygon wallet address (Polymarket only)"
    },
    "candidate": {
      "type": "string",
      "description": "Optional: candidate name for Kalshi Rule 5.17(z) name match"
    },
    "amount_usd": {
      "type": "number",
      "description": "Optional: bet size for risk amplification"
    }
  },
  "required": [
    "platform",
    "market_id"
  ],
  "additionalProperties": false
}