Polymarket integrity MCP — 28 tools for wallet risk, whales, UMA scans, SAR/STR reports.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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).
Person or entity name
Optional language (e.g. en, de)
Max results (default upstream)
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
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).
| Argument | Type | Description |
|---|---|---|
| lang | string | Optional language (e.g. en, de) |
| name* | string | Person or entity name |
| limit | integer | Max results (default upstream) |
{
"type": "object",
"required": [
"name"
],
"properties": {
"lang": {
"type": "string",
"description": "Optional language (e.g. en, de)"
},
"name": {
"type": "string",
"description": "Person or entity name"
},
"limit": {
"type": "integer",
"description": "Max results (default upstream)"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max markets to scan (default 25, max 100) |
| category | string | Optional: filter to one category (military_action, regime_change, leadership_death, diplomacy, intelligence, monetary_policy, regulatory_action) |
{
"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
}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.
| Argument | Type | Description |
|---|---|---|
| id | string | Market id / conditionId |
| slug | string | Market slug |
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Market id / conditionId"
},
"slug": {
"type": "string",
"description": "Market slug"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| id | string | Market id / conditionId |
| slug | string | Market slug |
| wallet* | string | Wallet to score (0x + 40 hex) |
{
"type": "object",
"required": [
"wallet"
],
"properties": {
"id": {
"type": "string",
"description": "Market id / conditionId"
},
"slug": {
"type": "string",
"description": "Market slug"
},
"wallet": {
"type": "string",
"description": "Wallet to score (0x + 40 hex)"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| claim* | string | Short human-readable claim being asserted |
| signals | array | List of integrity signals triggered |
| wallets | array | Optional list of related wallet addresses |
| severity | string | Alert severity |
| market_slug* | string | Polymarket market slug |
{
"type": "object",
"required": [
"market_slug",
"claim"
],
"properties": {
"claim": {
"type": "string",
"description": "Short human-readable claim being asserted"
},
"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"
},
"severity": {
"enum": [
"LOW",
"MEDIUM",
"HIGH",
"CRITICAL"
],
"type": "string",
"default": "MEDIUM",
"description": "Alert severity"
},
"market_slug": {
"type": "string",
"description": "Polymarket market slug"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| id | string | Market id / conditionId |
| slug | string | Polymarket market slug |
| window_hours | integer | Pre-event window to analyze (default 72h) |
| min_position_usd | number | Min notional to flag (default $1000) |
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Market id / conditionId"
},
"slug": {
"type": "string",
"description": "Polymarket market slug"
},
"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
}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.
| Argument | Type | Description |
|---|---|---|
| ticker | string | Kalshi market ticker |
| event_ticker | string | Or event_ticker for the whole event |
| candidate_name | string | Optional: specific person's name to match against title (e.g. 'Mark Moran') |
{
"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
}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.
| Argument | Type | Description |
|---|---|---|
| ticker | string | Kalshi market ticker (e.g. KXG7LEADEROUT-45JAN01-DJT) |
| event_ticker | string | Kalshi event ticker (returns all child markets) |
{
"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
}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.
| Argument | Type | Description |
|---|---|---|
| ticker* | string | Kalshi market ticker |
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"description": "Kalshi market ticker"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| category | string | Optional category filter |
| hours_ahead | integer | Look-ahead window (default 48h, max 168h) |
| min_open_interest | number | Only markets with at least this OI |
{
"type": "object",
"properties": {
"category": {
"type": "string",
"description": "Optional category filter"
},
"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"
}
},
"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).
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max events to return (default 25, max 100) |
| query | string | Keyword search in title, sub_title, event_ticker |
| status | string | |
| category | string | Optional category filter (Elections, Politics, Economics, ...) |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 25,
"description": "Max events to return (default 25, max 100)"
},
"query": {
"type": "string",
"description": "Keyword search in title, sub_title, event_ticker"
},
"status": {
"enum": [
"open",
"closed",
"settled"
],
"type": "string",
"default": "open"
},
"category": {
"type": "string",
"description": "Optional category filter (Elections, Politics, Economics, ...)"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| category | string | Optional category filter |
| max_results | integer | Max flagged markets (default 25, max 50) |
{
"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
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max events to return (default 25, max 50) |
| category | string | Optional category filter (Elections, Politics, ...) |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 25,
"description": "Max events to return (default 25, max 50)"
},
"category": {
"type": "string",
"description": "Optional category filter (Elections, Politics, ...)"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| category | string | Optional category substring (e.g. 'geopolitical', 'oracle') |
| min_aml_relevance | string | Minimum AML relevance |
{
"type": "object",
"properties": {
"category": {
"type": "string",
"description": "Optional category substring (e.g. 'geopolitical', 'oracle')"
},
"min_aml_relevance": {
"enum": [
"low",
"medium",
"high"
],
"type": "string",
"description": "Minimum AML relevance"
}
},
"additionalProperties": false
}Full KYC bundle for a named entity: sanctions + PEP + adverse media + country risk in a single call. Delegates to AMLOracle.kyc_bundle.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| country | string | ISO country code |
| entity_type | string | 'person' or 'organization' |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"country": {
"type": "string",
"description": "ISO country code"
},
"entity_type": {
"type": "string",
"description": "'person' or 'organization'"
}
},
"additionalProperties": false
}Full market info: outcomes, outcome prices, volume, liquidity, best bid/ask, spread, resolution source, conditionId. Provide 'slug' or 'id'.
| Argument | Type | Description |
|---|---|---|
| id | string | Market id / conditionId |
| slug | string | Market slug |
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Market id / conditionId"
},
"slug": {
"type": "string",
"description": "Market slug"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| id | string | |
| slug | string |
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"additionalProperties": false
}Search Polymarket markets by keyword (e.g. 'election', 'fed', 'bitcoin'). Returns question, slug, 24h volume, liquidity, end date.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results (default 10, max 50) |
| query* | string | Keyword to search |
| active_only | boolean | Only active / non-closed markets |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"description": "Max results (default 10, max 50)"
},
"query": {
"type": "string",
"description": "Keyword to search"
},
"active_only": {
"type": "boolean",
"default": true,
"description": "Only active / non-closed markets"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| id | string | Market id / conditionId |
| to | string | Only include trades up to this ISO timestamp |
| from | string | Only include trades from this ISO timestamp |
| side | string | Only trades on this side |
| slug | string | Polymarket market slug |
| limit | integer | Max trades to return after filtering (default 100, max 5000) |
| wallet | string | Filter to a single wallet address |
| min_size | number | Minimum trade size (shares) |
| max_pages | integer | How many pages of 1000 to fetch (default 2, max 25) |
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.
| Argument | Type | Description |
|---|---|---|
| id | string | |
| slug | string |
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"additionalProperties": false
}PredictionGuard platform overview: covered platforms, tool inventory, Polymarket Gamma API ping, Polygon RPC ping (Ankr-backed), known-case count.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Politically Exposed Person (PEP) check via Wikidata. Delegates to AMLOracle. Relevant for prediction markets where reported traders overlap with political figures.
| Argument | Type | Description |
|---|---|---|
| name* | string | Person name |
| country | string | Optional ISO country code |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Person name"
},
"country": {
"type": "string",
"description": "Optional ISO country code"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| id | string | Market id / conditionId |
| slug | string | Market slug |
| wallet* | string | Wallet to analyze (0x + 40 hex) |
{
"type": "object",
"required": [
"wallet"
],
"properties": {
"id": {
"type": "string",
"description": "Market id / conditionId"
},
"slug": {
"type": "string",
"description": "Market slug"
},
"wallet": {
"type": "string",
"description": "Wallet to analyze (0x + 40 hex)"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| id | string | |
| slug | string | |
| max_pages | integer | Trade pagination depth (default 10, max 25) |
| days_before_end | number | Pre-event window size in days (1–90, default 7) |
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"max_pages": {
"type": "integer",
"default": 10,
"description": "Trade pagination depth (default 10, max 25)"
},
"days_before_end": {
"type": "number",
"default": 7,
"description": "Pre-event window size in days (1–90, default 7)"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| wallet | string | Optional: Polygon wallet address (Polymarket only) |
| platform* | string | Which prediction market |
| candidate | string | Optional: candidate name for Kalshi Rule 5.17(z) name match |
| market_id* | string | Polymarket slug or Kalshi ticker/event_ticker |
| amount_usd | number | Optional: bet size for risk amplification |
{
"type": "object",
"required": [
"platform",
"market_id"
],
"properties": {
"wallet": {
"type": "string",
"description": "Optional: Polygon wallet address (Polymarket only)"
},
"platform": {
"enum": [
"polymarket",
"kalshi"
],
"type": "string",
"description": "Which prediction market"
},
"candidate": {
"type": "string",
"description": "Optional: candidate name for Kalshi Rule 5.17(z) name match"
},
"market_id": {
"type": "string",
"description": "Polymarket slug or Kalshi ticker/event_ticker"
},
"amount_usd": {
"type": "number",
"description": "Optional: bet size for risk amplification"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| id | string | |
| slug | string |
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| name* | string | Person or entity name |
| threshold | number | Optional fuzzy-match threshold (0..1) |
| entity_type | string | Optional: 'person' or 'organization' |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Person or entity name"
},
"threshold": {
"type": "number",
"description": "Optional fuzzy-match threshold (0..1)"
},
"entity_type": {
"type": "string",
"description": "Optional: 'person' or 'organization'"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| filer | object | Information about the preparing institution. |
| market | object | Optional. Polymarket market context. |
| signals | array | 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. |
| subject* | object | Required. The subject of the report. |
| activity | object | Activity window and amounts. |
| evidence | object | References to prior evidence. |
| narrative_addendum | string | Optional free-text addendum from the analyst. |
| filing_jurisdiction | string |
Top Polymarket markets by 24h volume. Useful for daily compliance triage / catching news catalysts before they land in mainstream coverage.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results (default 10, max 25) |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"description": "Max results (default 10, max 25)"
}
},
"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).
| Argument | Type | Description |
|---|---|---|
| id | string | Market id / conditionId |
| slug | string | Market slug |
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Market id / conditionId"
},
"slug": {
"type": "string",
"description": "Market slug"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| include_v1 | boolean | Also scan UMA OOv1 (legacy, default false) |
| blocks_back | integer | Blocks to scan back (default 5000 ≈ 3h, max 20000) |
{
"type": "object",
"properties": {
"include_v1": {
"type": "boolean",
"default": false,
"description": "Also scan UMA OOv1 (legacy, default false)"
},
"blocks_back": {
"type": "integer",
"default": 5000,
"description": "Blocks to scan back (default 5000 ≈ 3h, max 20000)"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| jws | string | Full JWS string |
| content_hash | string | SHA-256 content hash (alternative to JWS) |
{
"type": "object",
"properties": {
"jws": {
"type": "string",
"description": "Full JWS string"
},
"content_hash": {
"type": "string",
"description": "SHA-256 content hash (alternative to JWS)"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| wallet* | string | Target wallet address (0x + 40 hex) |
| markets* | array | 2-10 market slugs to check for co-trading overlap |
{
"type": "object",
"required": [
"wallet",
"markets"
],
"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"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| address* | string | Polygon address (0x + 40 hex chars) |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "Polygon address (0x + 40 hex chars)"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| address* | string | Polygon address (0x + 40 hex chars) |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "Polygon address (0x + 40 hex chars)"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| address* | string | Polygon address (0x + 40 hex chars) |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "Polygon address (0x + 40 hex chars)"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| tags | array | Free-form tags (e.g. ['polymarket','pre-election','whale']) |
| alias | string | Optional human-readable label |
| notes | string | Free-form notes |
| address* | string | Polygon address (0x + 40 hex) |
| alert_threshold_matic | number | Balance delta threshold in MATIC for alerts (default 100) |
{
"type": "object",
"required": [
"address"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Free-form tags (e.g. ['polymarket','pre-election','whale'])"
},
"alias": {
"type": "string",
"description": "Optional human-readable label"
},
"notes": {
"type": "string",
"description": "Free-form notes"
},
"address": {
"type": "string",
"description": "Polygon address (0x + 40 hex)"
},
"alert_threshold_matic": {
"type": "number",
"default": 100,
"description": "Balance delta threshold in MATIC for alerts (default 100)"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results (max 500) |
| since | string | ISO 8601 timestamp (e.g. 2026-04-20T00:00:00Z) |
| address | string | |
| severity | string |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"description": "Max results (max 500)"
},
"since": {
"type": "string",
"description": "ISO 8601 timestamp (e.g. 2026-04-20T00:00:00Z)"
},
"address": {
"type": "string"
},
"severity": {
"enum": [
"LOW",
"MEDIUM",
"HIGH",
"CRITICAL"
],
"type": "string"
}
},
"additionalProperties": false
}List all watched wallets with their alias, threshold, tags, notes, and last snapshot. Optionally filter by tag.
| Argument | Type | Description |
|---|---|---|
| tag | string | Optional tag filter |
| limit | integer | Max results (max 500) |
{
"type": "object",
"properties": {
"tag": {
"type": "string",
"description": "Optional tag filter"
},
"limit": {
"type": "integer",
"default": 100,
"description": "Max results (max 500)"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| address* | string | |
| keep_history | boolean | Keep snapshot + alert history (default true) |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string"
},
"keep_history": {
"type": "boolean",
"default": true,
"description": "Keep snapshot + alert history (default true)"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| address | string | Optional — scan a single address. Omit to scan the whole list. |
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "Optional — scan a single address. Omit to scan the whole list."
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Market id / conditionId"
},
"to": {
"type": "string",
"description": "Only include trades up to this ISO timestamp"
},
"from": {
"type": "string",
"description": "Only include trades from this ISO timestamp"
},
"side": {
"enum": [
"BUY",
"SELL"
],
"type": "string",
"description": "Only trades on this side"
},
"slug": {
"type": "string",
"description": "Polymarket market slug"
},
"limit": {
"type": "integer",
"default": 100,
"description": "Max trades to return after filtering (default 100, max 5000)"
},
"wallet": {
"type": "string",
"description": "Filter to a single wallet address"
},
"min_size": {
"type": "number",
"description": "Minimum trade size (shares)"
},
"max_pages": {
"type": "integer",
"default": 2,
"description": "How many pages of 1000 to fetch (default 2, max 25)"
}
},
"additionalProperties": false
}| Report format. Default EU_GENERIC. |
{
"type": "object",
"required": [
"subject"
],
"properties": {
"filer": {
"type": "object",
"properties": {
"institution": {
"type": "string"
},
"contact_name": {
"type": "string"
},
"contact_email": {
"type": "string"
}
},
"description": "Information about the preparing institution."
},
"market": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"end_date": {
"type": "string"
},
"question": {
"type": "string"
},
"volume_usd": {
"type": "number"
},
"liquidity_usd": {
"type": "number"
},
"volume_24h_usd": {
"type": "number"
}
},
"description": "Optional. Polymarket market context."
},
"signals": {
"type": "array",
"items": {
"type": [
"string",
"object"
]
},
"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."
},
"subject": {
"type": "object",
"properties": {
"network": {
"type": "string"
},
"risk_grade": {
"type": "string"
},
"risk_score": {
"type": "number"
},
"entity_name": {
"type": "string"
},
"entity_type": {
"enum": [
"person",
"organization",
"unknown"
],
"type": "string"
},
"aml_relevance": {
"type": "string"
},
"wallet_address": {
"type": "string"
}
},
"description": "Required. The subject of the report."
},
"activity": {
"type": "object",
"properties": {
"date_end": {
"type": "string"
},
"amount_usd": {
"type": "number"
},
"date_start": {
"type": "string"
}
},
"description": "Activity window and amounts."
},
"evidence": {
"type": "object",
"properties": {
"signed_alerts": {
"type": "array",
"items": {
"type": "string"
}
},
"related_markets": {
"type": "array",
"items": {
"type": "string"
}
},
"related_wallets": {
"type": "array",
"items": {
"type": "string"
}
}
},
"description": "References to prior evidence."
},
"narrative_addendum": {
"type": "string",
"description": "Optional free-text addendum from the analyst."
},
"filing_jurisdiction": {
"enum": [
"EU_GENERIC",
"US_FINCEN",
"DE_goAML"
],
"type": "string",
"default": "EU_GENERIC",
"description": "Report format. Default EU_GENERIC."
}
},
"additionalProperties": false
}