PriceMyFill

Execution math for prediction markets: exact Polymarket fees, liquidity reward eligibility, order-book fill and slippage, and a full market brief that ends in a go/no-go verdict. Pay per call with x402 in USDC on Base.

View on workers.dev

Hosted MCP Server

npx add-mcp 'https://api.pricemyfill.workers.dev/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Así se ve un informe de PriceMyFill

Datos reales de Polymarket, congelados el 2026-11-12T11:11:14Z. Nada inventado: el book y el cálculo salen del CLOB y de la fórmula pública de fees.

El mercado

Mercado	Xi Jinping out before 2027?
Categoría	politics · feeRate 0,04
Book	mejor bid `0,015` · mejor ask `0,017` · mid `0,016`
Rewards del mercado	pool 5 USDC/día · min 200 shares · max spread 3,5¢
Consulta	`800 shares, compra, taker`

La respuesta del endpoint

{
 "market": {
  "id": "0xa467b14d51f01b957109d9cbb1d6c124fab2a089d52ed8f471d23c2812e743b7",
  "question": "Xi Jinping out before 2027?",
  "category": "politics"
 },
 "as_of": "2026-11-12T11:11:14Z",
 "book": {
  "bids": [
   {
    "price": 0.015,
    "size": 2034.63
   },
   {
    "price": 0.014,
    "size": 1957.58
   }
  ],
  "asks": [
   {
    "price": 0.017,
    "size": 2970.31
   },
   {
    "price": 0.018,
    "size": 14594.54
   }
  ]
 },
 "brief": {
  "fill": {
   "filled_shares": 800,
   "unfilled_shares": 0,
   "vwap": 0.017,
   "slippage_bps": 625,
   "mid": 0.016,
   "complete": true,
   "notional_usdc": 13.6
  },
  "costs": {
   "platform_fee_usdc": 0.534752,
   "total_cost_usdc": 0.534752,
   "cost_per_share_usdc": 0.000668,
   "effective_pct_of_notional": 3.932
  },
  "breakeven_probability": 0.017668,
  "rewards": {
   "eligible": true,
   "estimate": {
    "daily_usdc": 0.833333,
    "monthly_usdc": 25
   }
  },
  "edge": {
   "your_probability": 0.05,
   "net_edge_bps": 323.3,
   "net_edge_usdc": 25.864
  },
  "verdict": {
   "decision": "operate",
   "reasons": [
    "edge neto +323.3 bps después de fees y slippage",
    "elegible para rewards (pool estimado 0.83 USDC/día)",
    "costo de ejecución: 3.932% del notional"
   ]
  }
 }
}

Cómo se lee

El fee no es el costo principal acá. Sobre 13,60 USDC de notional, el fee de plataforma son 0,53 USDC (3,93%). El problema es otro:
El spread se come 625 bps. Con mid en 0,016, cruzar de 0,015 a 0,017 cuesta el 12,5% del precio. En mercados de cola el spread domina al fee — y ninguna calculadora de fees te lo dice.
Breakeven: 0,0177. Ésa es la probabilidad mínima que tenés que creer para que la compra tenga sentido. Si creés 5%, el edge neto es +323 bps; si creés 1,5%, estás pagando por nada.
Rewards: elegible. 800 shares superan el mínimo de 200 y el spread entra en 3,5¢ → estimación de 0,83 USDC/día por hacer liquidez.
Veredicto: operate, con las tres razones enumeradas. La decisión viene documentada, no como un número suelto.

La API

Ruta	Precio	Qué devuelve
`GET /v1/pm/fee`	0,005 USDC	fee exacto por categoría, con rebate y builder fee
`GET /v1/pm/rewards`	0,01 USDC	elegibilidad y reparto estimado
`GET /v1/pm/fill`	0,02 USDC	VWAP, slippage en bps, resto sin llenar
`POST /v1/pm/market-brief`	0,99 USDC	este informe completo

Pago por llamada con x402 en USDC sobre Base. Sin cuenta, sin API key: el primer request devuelve 402 con el precio y la dirección; el cliente paga y reintenta.