preflight_trade

Pre-flight verdict (OK / CAUTION / VETO) for a Polymarket order before you send it: expected VWAP slippage, visible depth, 2026 taker-fee drag, safe size and book staleness, computed deterministically from the live CLOB book. Identify the market by token_id, or by slug + outcome. Price: $0.02 per call via x402 or 1 credit with a bearer token; sandbox: true is free.

Parameters9

slug	string	optional	Market or event slug (a polymarket.com/event/<slug> URL works too). Use with outcome.
outcome	string	optional	Outcome name, e.g. Yes / No / candidate name (partial match OK for multi-outcome events).
token_id	string	optional	CLOB token id - alternative to slug + outcome.
side	string	optional	Order side. Default BUY.
usd	number	optional	Order size in USD. Default 100, max 10000.
max_slippage_c	number	optional	Threshold override: slippage in cents above which the verdict degrades from OK to CAUTION. Default 1.0.
veto_slippage_c	number	optional	Threshold override: slippage in cents at which the verdict becomes VETO. Default 3.0.
max_book_age_s	number	optional	Threshold override: maximum acceptable order-book age in seconds. Default 60.
sandbox	boolean	optional	true = free deterministic example response, never charged.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Market or event slug (a polymarket.com/event/<slug> URL works too). Use with outcome."
    },
    "outcome": {
      "type": "string",
      "description": "Outcome name, e.g. Yes / No / candidate name (partial match OK for multi-outcome events)."
    },
    "token_id": {
      "type": "string",
      "description": "CLOB token id - alternative to slug + outcome."
    },
    "side": {
      "type": "string",
      "enum": [
        "BUY",
        "SELL"
      ],
      "description": "Order side. Default BUY."
    },
    "usd": {
      "type": "number",
      "description": "Order size in USD. Default 100, max 10000."
    },
    "max_slippage_c": {
      "type": "number",
      "description": "Threshold override: slippage in cents above which the verdict degrades from OK to CAUTION. Default 1.0."
    },
    "veto_slippage_c": {
      "type": "number",
      "description": "Threshold override: slippage in cents at which the verdict becomes VETO. Default 3.0."
    },
    "max_book_age_s": {
      "type": "number",
      "description": "Threshold override: maximum acceptable order-book age in seconds. Default 60."
    },
    "sandbox": {
      "type": "boolean",
      "description": "true = free deterministic example response, never charged."
    }
  },
  "additionalProperties": false
}

preflight_copy

COPY / WATCH / VETO verdict for copy-trading a Polymarket wallet, with the numbers behind it (fee-inclusive copier ROI from a fixed $5-entry / +2c-slippage simulation, win rate, entry-price buckets, category mix). Wallets not yet computed return QUEUED free of charge (retry in ~1 hour). Price: $0.10 per call via x402 or 5 credits with a bearer token; sandbox: true is free.

Parameters2

wallet	string	optional	Polymarket wallet address (0x + 40 hex). Required for live calls; optional with sandbox: true.
sandbox	boolean	optional	true = free deterministic example response, never charged.

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Polymarket wallet address (0x + 40 hex). Required for live calls; optional with sandbox: true."
    },
    "sandbox": {
      "type": "boolean",
      "description": "true = free deterministic example response, never charged."
    }
  },
  "additionalProperties": false
}

leaderboard

Polymarket wallets currently rated COPY or WATCH for copyability: simulated copier ROI net of 2026 taker fees and slippage, out-of-sample validation, sample sizes and reasons. Price: $0.02 per call via x402 or 1 credit with a bearer token; sandbox: true is free.

Parameters1

sandbox

boolean

optional

true = free deterministic example response, never charged.

Raw schema

{
  "type": "object",
  "properties": {
    "sandbox": {
      "type": "boolean",
      "description": "true = free deterministic example response, never charged."
    }
  },
  "additionalProperties": false
}

red_list

Polymarket wallets a copier should refuse (VETO): negative fee-inclusive copier ROI or farming patterns, same method and window as the leaderboard. Price: $0.02 per call via x402 or 1 credit with a bearer token; sandbox: true is free.

Parameters1

sandbox

boolean

optional

true = free deterministic example response, never charged.

Raw schema

{
  "type": "object",
  "properties": {
    "sandbox": {
      "type": "boolean",
      "description": "true = free deterministic example response, never charged."
    }
  },
  "additionalProperties": false
}

credits_balance

Remaining credit balance for your bearer token. Free - requires Authorization: Bearer tk_<wallet>_<secret> on the MCP request; without a token it returns the credit-pack purchase terms instead.

Parameters

No parameters.

Raw schema

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

MCP

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

preflight_trade

preflight_copy

leaderboard

red_list

credits_balance

Install

Remote endpoint