# PriceMyFill

> Calculadoras y un informe de decisión para operar prediction markets (Polymarket, Kalshi).
> Todo stateless: el cliente manda su book y su config de mercado; la API devuelve la aritmética
> exacta y un veredicto. Pago por llamada con x402 v2 en USDC sobre Base (eip155:8453).

Precios: 0.005 / 0.01 / 0.02 USDC por calculadora, 0.99 USDC el informe completo.
Pago: x402. El primer request devuelve 402 con `accepts` (asset, amount, payTo, network). Sin cuenta ni API key.

## Calculadoras (entrada barata)

- GET https://api.pricemyfill.workers.dev/v1/pm/fee?category=politics&shares=800&price=0.017&side=buy&role=taker
  Fee de plataforma exacto: C × feeRate × p(1−p). Sólo taker; maker = 0. Incluye rebate y builder fee.
  Categorías: crypto(0.07) sports(0.05) politics(0.04) finance(0.04) economics(0.05) culture(0.05) weather(0.05) tech(0.04) mentions(0.04) other(0.05) geopolitics(0) combos(0.05).

- GET https://api.pricemyfill.workers.dev/v1/pm/rewards?shares=800&spread_cents=0.1&rewards_min_size=200&rewards_max_spread=3.5&daily_pot=5&competing_shares=4000
  Elegibilidad (tamaño mínimo y spread máximo) y estimación del reparto diario.

- GET https://api.pricemyfill.workers.dev/v1/pm/fill  (POST con el book)
  Recorre el book nivel por nivel: VWAP, slippage en bps, shares sin llenar.

## Producto

- POST https://api.pricemyfill.workers.dev/v1/pm/market-brief   (0.99 USDC)
  Cuerpo: {"market_id","category","book":{"bids":[],"asks":[]},"size_shares","side","role","rewards":{...},"your_probability"}
  Devuelve: fill + costos + breakeven_probability + elegibilidad de rewards + edge neto + veredicto
  ("operate" / "operate_partial" / "do_not_operate" / "insufficient_data") con razones enumeradas.

## MCP (mismo servicio, para Claude / Cursor / cualquier cliente MCP)

- POST https://api.pricemyfill.workers.dev/mcp — transporte Streamable HTTP.
  El handshake (initialize, tools/list) es GRATIS: hay que poder descubrir las tools antes
  de pagar. Cada tools/call se cobra al mismo precio que su ruta REST; sin pago devuelve 402
  con el precio en el header PAYMENT-REQUIRED, el cliente paga y reintenta el mismo POST.
  Tools: pm_market_brief (0.99) · pm_order_book_fill (0.02) · pm_reward_eligibility (0.01) · pm_platform_fee (0.005)
  Recurso: pm://fee-categories (tasas por categoría, gratis).

## Muestra gratis

- https://api.pricemyfill.workers.dev/sample  — un informe real con datos congelados, con la explicación de cómo se lee.

## Notas para agentes

- No hay storage ni estado: no se guarda nada de lo que mandás.
- Si falta un dato, la respuesta lo dice ("no medible") en vez de inventarlo.
- El veredicto nunca promete retorno: compara tu probabilidad contra el breakeven de ejecución.