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
| 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.