Precios

Precios por llamada en USD. Versión legible por máquina: /v1/pricing. Modo de pago: x402. POST /v1/research cuesta $0.50 por llamada (configurable).

EndpointPrecio (USD / llamada)
POST /v1/research$0.50
GET /v1/search$0.02
GET /v1/tenders/:id$0.02
GET /v1/companies/:id$0.05
GET /v1/companies/:id/awards$0.05
GET /v1/companies/:id/opportunities$0.10
GET /v1/buyers/:id/history$0.05
GET /v1/renewals$0.25
GET /v1/pricinggratis
GET /v1/statsgratis
GET /v1/demogratis
POST /v1/billing/credits/5$5.00
POST /v1/billing/credits/10$10.00
POST /v1/billing/credits/25$25.00
GET /v1/billinggratis

GET /v1/demo es gratuito: una muestra etiquetada de los datos de pago (licitación reciente + señal de renovación), para que los agentes validen la calidad antes de pagar.

Créditos y facturación

Paquetes de créditos prepagados: una compra única. Compra un paquete y luego paga cada llamada desde tu saldo enviando x-client-key: <tu clave> en la solicitud (en lugar de una prueba de pago por llamada).

PaquetePrecio (USD)
POST /v1/billing/credits/5$5.00
POST /v1/billing/credits/10$10.00
POST /v1/billing/credits/25$25.00

Dos vías de pago, según cómo compres: la suscripción mensual se paga en EUR con tarjeta a través de Creem (sin cartera cripto); el pago por llamada y los créditos prepagados se facturan en USD y se pagan con pruebas USDC vía x402.

Suscripción mensual

Creem MoR: suscríbete en POST /v1/creem/checkout por €29.00/mes (configurable — siempre el CREEM_PRICE_CENTS configurado). Tras el pago, Creem llama a POST /v1/creem/webhook (con firma verificada) y la cuenta queda marcada kind=creem durante 30 días. Las llamadas de suscriptor descuentan créditos de un solo uso: agotarlos devuelve 402 hasta que recargues.

Compra: POST /v1/billing/credits/5 (o /10 /25) con el flujo de pago máquina a máquina normal (402 → reintento PAYMENT-SIGNATURE). Consulta el saldo: GET /v1/billing con la cabecera x-client-key: <tu clave>. MCP: billing_purchase_credits / billing_get_balance.

Cómo funciona el pago

  1. Llama a un endpoint de pago → 402 con una cabecera PAYMENT-REQUIRED en base64 que describe el requisito exacto de USDC (esquema exact, EIP-3009 transferWithAuthorization).
  2. Firma la autorización con un cliente x402 y reintenta con PAYMENT-SIGNATURE: <payload> (v2; la cabecera heredada X-PAYMENT sigue funcionando).
  3. El servidor verifica y liquida el pago antes de servir el contenido; las pruebas son de un solo uso.
  4. Solo desarrollo local (PAYMENTS_MODE=dev): POST /v1/dev-faucet {"endpoint":"<MÉTODO RUTA>"} → { token, expires_at }, y reintenta con X-PAYMENT (REST) o payment_token (MCP). No disponible en producción.