PriceMyFill

Calcul d’exécution pour les marchés de prédiction : frais exacts de Polymarket, admissibilité aux récompenses de liquidité, exécution des ordres dans le carnet et glissement, ainsi qu’un dossier complet sur le marché qui se conclut par un verdict go/no-go. Paiement par appel avec x402 en USDC sur Base.

Serveur MCP hébergé

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

S’installe dans Claude Code, Codex, Cursor et plus

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

MercadoXi Jinping out before 2027?
Categoríapolitics · feeRate 0,04
Bookmejor bid 0,015 · mejor ask 0,017 · mid 0,016
Rewards del mercadopool 5 USDC/día · min 200 shares · max spread 3,5¢
Consulta800 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

RutaPrecioQué devuelve
GET /v1/pm/fee0,005 USDCfee exacto por categoría, con rebate y builder fee
GET /v1/pm/rewards0,01 USDCelegibilidad y reparto estimado
GET /v1/pm/fill0,02 USDCVWAP, slippage en bps, resto sin llenar
POST /v1/pm/market-brief0,99 USDCeste 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.