AgentServices

APIs de pago para agentes de IA: MCP + REST con liquidación x402 en Base.

Documentación

AgentServices

La capa API de pago para agentes de IA: datos, inteligencia, inferencia y medios mediante micropagos x402

Proyecto canónico: https://github.com/vbkotecha/agentservices-api Sitio oficial: https://agentservices.to Licencia: Apache-2.0

AgentServices es un proyecto independiente. No está afiliado, respaldado ni es un reemplazo de ningún otro proveedor de datos de mercado x402.

En vivo en: agentservices.to | Servidor MCP: https://agentservices.to/mcp (HTTP Streamable) | Descubrimiento: /.well-known/x402

¿Qué es esto?

AgentServices es la capa API monetizada para agentes de IA. Sin claves API, sin suscripciones: los agentes pagan por solicitud con USDC en Base mediante el protocolo de pago x402.

Más de 60 endpoints en datos de criptomonedas, inteligencia de mercado, análisis DeFi, análisis on-chain, más de 400 modelos LLM, generación de imágenes, texto a voz, inteligencia de cartera y resolución de disputas. 12 son gratuitos. Más de 48 son de pago mediante x402 (desde $0.002 hasta $0.25 por llamada).

Novedades en v6.0

Más de 400 modelos LLM mediante /v1/chat/completions compatible con OpenAI: GPT, Claude, Gemini, DeepSeek, Grok, Llama y más
Enrutador inteligente: usa model: "auto" y la pasarela clasifica tu tarea y elige el modelo más económico que pueda manejarla
Generación de imágenes: /v1/images/generations mediante gpt-image-2 ($0.05)
Texto a voz: /v1/audio/speech con voces naturales ($0.05)
3 nuevas herramientas MCP: chat, generate_image, text_to_speech

Ruta del comprador: descubrir → probar → pagar → conservar

Usa la guía de inicio rápido para compradores para el recorrido completo. La siguiente acción exacta es ejecutar la verificación de descubrimiento sin credenciales:

python3 examples/mcp_discovery_buyer_proof.py

Luego sigue el mismo recorrido del comprador:

Descubrir: confirma el servidor MCP alojado y el catálogo de herramientas gratuitas con la prueba de descubrimiento MCP.
Probar gratis: obtén un resultado de precio real con la prueba gratuita del SDK.
Inspeccionar el desafío de pago: decodifica los términos 402 en vivo con la prueba del SDK de pago. Nunca firma ni liquida pagos.
Comprar un resultado: paga los términos x402 devueltos, reintenta la misma solicitud y conserva el resultado de pago devuelto. Consulta los contratos token-risk, market-pulse y research-brief para conocer los límites de resultados y la procedencia.
Conservar evidencia: ejecuta el constructor de recibos existente con el desafío original, la respuesta de pago y tu autorización de cartera o referencia de transacción.

Las cuatro pruebas tienen límites diferentes: descubrimiento y SDK gratuito verifican acceso sin gasto; la prueba del SDK de pago verifica solo la forma del desafío; el constructor de recibos genera un hash de la evidencia en poder del comprador y no verifica la liquidación. Ninguna de ellas afirma adopción, liquidación o ingresos.

Para las definiciones de medición de activación, consulta Métricas de activación. Para sondear el embudo en vivo, ejecuta python3 examples/check_activation_funnel.py.

Endpoints

Gratuitos (sin pago requerido)

Endpoint	Descripción
`GET /v1/prices?symbols=BTC,ETH`	Precios actuales de criptomonedas (CoinGecko)
`GET /v1/trending`	Tokens en tendencia por actividad de mercado
`GET /v1/global`	Capitalización de mercado global, volumen, dominancia de BTC
`GET /v1/fear-greed`	Índice de sentimiento de miedo y codicia en criptomonedas
`GET /v1/gas`	Precios actuales de gas en Base/Ethereum
`GET /v1/predictions`	Predicciones de mercado generadas por IA
`GET /v1/news`	Últimos titulares de noticias de criptomonedas
`GET /v1/social/trending`	Temas de sentimiento social en tendencia
`GET /v1/geo?ip=1.2.3.4`	Geolocalización por IP
`GET /v1/swap/quote?from=&to=&amount=`	Cotización de swap DEX (integración 0x)
`GET /v1/policies`	Lista de plantillas de políticas de resolución de disputas
`GET /health`	Verificación de estado de la API

De pago — APIs de datos (x402)

Endpoint	Precio	Descripción
`GET /v1/indicators/BTC`	$0.02	Indicadores técnicos (RSI, MACD, Bandas de Bollinger, ATR, Soporte/Resistencia)
`GET /v1/yields`	$0.02	Principales pools de rendimiento DeFi por TVL
`GET /v1/metadata?url=`	$0.01	Extracción y despliegue de metadatos de URL
`GET /v1/search?q=`	$0.01	Búsqueda web de información de criptomonedas/mercado
`GET /v1/onchain/:address`	$0.02	Análisis on-chain para cualquier dirección
`GET /v1/onchain/:address/tokens`	$0.03	Tenencias de tokens para cualquier dirección

De pago — APIs de síntesis (x402)

Endpoint	Precio	Descripción
`GET /v1/token-risk/{token}`	$0.03	Puntuación de riesgo basada en volatilidad, proxy de liquidez y capitalización de mercado
`GET /v1/crypto-signals`	$0.04	Señales agregadas de compra/venta en múltiples indicadores
`GET /v1/yield-comparison`	$0.03	Comparación de rendimientos entre protocolos con retornos ajustados al riesgo
`GET /v1/hn-sentiment`	$0.02	Análisis de sentimiento de Hacker News para temas tecnológicos
`GET /v1/npm-stats/:package`	$0.02	Estadísticas y tendencias de descargas de paquetes NPM
`GET /v1/github-trending`	$0.02	Repositorios de GitHub en tendencia por lenguaje/tema
`GET /v1/marketing-intel`	$0.05	Inteligencia de marketing: competidores, brechas de contenido, textos publicitarios

De pago — Inteligencia combinada (x402)

Endpoint	Precio	Descripción
`GET /v1/research?q=`	$0.05	Investigación profunda: búsqueda + extracción + síntesis en una sola llamada
`GET /v1/portfolio?symbol=BTC`	$0.10	Inteligencia de cartera: precio + señal + riesgo + sentimiento + veredicto
`GET /v1/defi-strategy`	$0.25	Informe de estrategia DeFi: mejores rendimientos + TVL + comparación + alertas de riesgo
`GET /v1/market-pulse`	$0.05	Pulso de mercado: miedo-codicia + tendencias + noticias + social + ballenas + global
`GET /v1/onchain-overview`	$0.15	Resumen on-chain: ballenas + flujos de exchanges + flujos de stablecoins + correlación + TVL DeFi

De pago — Inferencia de IA (x402)

Endpoint	Precio	Descripción
`POST /v1/inference`	$0.03	Inferencia LLM (gpt-5.4/5.4-mini/5.5) — finalizaciones de chat
`POST /v1/complete`	$0.03	Finalización de texto (proxy CodexSale)

De pago — Resolución de disputas (x402)

Endpoint	Precio	Descripción
`POST /v1/disputes`	$0.05	Resolución de disputas impulsada por IA (7 plantillas de políticas)

Casos de uso: qué pueden construir los agentes

Monitor de cartera

# ALL-IN-ONE: Get portfolio intelligence in a single call ($0.10)
# Returns: price + technical signal + risk score + market sentiment + verdict
curl "https://agentservices.to/v1/portfolio?symbol=BTC"

# Or build it yourself from individual endpoints:
# Get current prices (FREE)
curl https://agentservices.to/v1/prices?symbols=BTC,ETH,SOL

# Get technical signals for entry/exit ($0.04)
curl https://agentservices.to/v1/crypto-signals

# Check snapshot-based token risk before buying ($0.03)
# Use a CoinGecko-compatible identifier for portable direct HTTP calls.
curl https://api.agentservices.to/v1/token-risk/pepe
# Contract and payment-receipt guidance: docs/token-risk-outcome-contract.md

Optimizador de rendimiento DeFi

# ALL-IN-ONE: Get DeFi strategy report ($0.25)
# Returns: top yields + protocol TVL + cross-chain comparison + risk flags
curl "https://agentservices.to/v1/defi-strategy"

# Get all yield pools ranked by TVL ($0.02)
curl https://agentservices.to/v1/yields

# Compare yields with risk-adjusted returns ($0.03)
curl https://agentservices.to/v1/yield-comparison

# Check on-chain position for any wallet ($0.02)
curl https://agentservices.to/v1/onchain/0x9863aB6242663FCc84c33632741711dB78f8Fd15

Agente de inteligencia de mercado

# ALL-IN-ONE: Get market pulse report ($0.05)
# Returns: fear-greed + trending + news + social + whales + global market
curl "https://agentservices.to/v1/market-pulse"

# Get market sentiment (FREE)
curl https://agentservices.to/v1/fear-greed

# Search for latest news on any topic ($0.01)
curl "https://agentservices.to/v1/search?q=base+chain+ecosystem"

# Get trending tokens (FREE)
curl https://agentservices.to/v1/trending

# Get marketing intelligence report ($0.05)
curl "https://agentservices.to/v1/marketing-intel?competitor=blockrun&topic=x402"

Bot de análisis técnico

# Full technical indicator suite ($0.02)
curl https://agentservices.to/v1/indicators/BTC
# Returns: RSI, MACD, Bollinger Bands, ATR, Support/Resistance levels

# AI-generated market predictions (FREE)
curl https://agentservices.to/v1/predictions

# Combine with on-chain analytics ($0.03)
curl https://agentservices.to/v1/onchain/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/tokens

Agente de investigación para desarrolladores

# GitHub trending repos ($0.02)
curl "https://agentservices.to/v1/github-trending?language=python&since=weekly"

# NPM package stats ($0.02)
curl https://agentservices.to/v1/npm-stats/react

# Hacker News sentiment ($0.02)
curl "https://agentservices.to/v1/hn-sentiment?q=AI+agents"

Chat / Inferencia de IA

# Chat completions via x402 ($0.03)
curl -X POST https://agentservices.to/v1/inference \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.4-mini","messages":[{"role":"user","content":"Explain x402 in 3 sentences"}]}'

Análisis on-chain

# ALL-IN-ONE: Get full on-chain overview ($0.15)
# Returns: whale movements + exchange flows + stablecoin flows + correlation matrix + DeFi TVL
curl "https://agentservices.to/v1/onchain-overview"

# On-chain analytics for any wallet ($0.02)
curl https://agentservices.to/v1/onchain/0x9863aB6242663FCc84c33632741711dB78f8Fd15

# Token holdings for any wallet ($0.03)
curl https://agentservices.to/v1/onchain/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/tokens

Inicio rápido

Usando curl

# Free — no payment needed
curl https://agentservices.to/v1/prices?symbols=BTC,ETH

# Paid — returns HTTP 402 with payment instructions in the header
curl -i https://agentservices.to/v1/indicators/BTC
# Response includes x402 payment envelope: network, amount, payTo address
# Agent pays via x402 client, retries with X-Payment header, gets data

Usando como servidor MCP (Claude Desktop, Cursor, etc.)

{
  "mcpServers": {
    "agentservices": {
      "url": "https://agentservices.to/mcp",
      "transport": "streamable-http"
    }
  }
}

Más de 13 herramientas MCP disponibles: crypto_prices, trending_tokens, global_market, gas_prices, market_predictions, crypto_news, social_trending, technical_indicators, defi_yields, search_web, token_risk, crypto_signals, onchain_analytics, deep_research, portfolio_intelligence, defi_strategy, market_pulse, onchain_overview

Usando con Python

import httpx

# Free endpoints
resp = httpx.get("https://agentservices.to/v1/prices?symbols=BTC,ETH")
prices = resp.json()

# Paid endpoints — use x402 client to handle payment
from x402.client import x402Client
client = x402Client()
result = client.get("https://agentservices.to/v1/indicators/BTC")
# Client handles 402 → pays USDC → retries with payment proof → returns data

Usando con JavaScript/TypeScript

// Free endpoints
const prices = await fetch("https://agentservices.to/v1/prices?symbols=BTC,ETH").then(r => r.json());

// Paid endpoints — use @x402/facilitator
import { wrapFetchWithPayment } from "@x402/facilitator";
const paidFetch = wrapFetchWithPayment(fetch);
const indicators = await paidFetch("https://agentservices.to/v1/indicators/BTC").then(r => r.json());

Motor de resolución de disputas

AgentServices incluye un sistema de resolución de disputas impulsado por IA con 7 plantillas de políticas:

Política	Caso de uso
`freelance-delivery`	Disputas de entrega entre freelancers y clientes
`milestone-payment`	Disputas de pago de proyectos basados en hitos
`sla-monitoring`	Violaciones de acuerdos de nivel de servicio
`api-quality`	Disputas de calidad de respuesta / tiempo de actividad de API
`bug-bounty`	Disputas de validez de recompensas por errores
`scope-dispute`	Disputas por expansión del alcance del proyecto
`physical-commerce`	Disputas de transacciones de bienes físicos

Puerta de facturación humana (ChatGPT / Claude)

Los agentes de cartera continúan pagando mediante x402 en REST — sin cambios. Los humanos que se conectan a través del Modo Desarrollador de ChatGPT o conectores personalizados de Claude pueden usar Google OAuth + créditos prepagados de Stripe en MCP.

Vía	Quién	Cómo
x402	Agentes de cartera	REST sin autenticación → HTTP 402 → USDC en Base
Créditos	Humanos con sesión iniciada	Google OAuth en MCP → deducir el mismo precio en USD del saldo prepagado

URL MCP para ChatGPT: https://agentservices.to/mcp

Variables de entorno

Copia .env.example. Requerido para habilitar la puerta humana:

Variable	Propósito
`GOOGLE_CLIENT_ID`	ID de cliente de Google OAuth
`GOOGLE_CLIENT_SECRET`	Secreto de cliente de Google OAuth
`OAUTH_JWT_SECRET`	Firma los tokens bearer de MCP (o usa `SESSION_SECRET`)
`STRIPE_SECRET_KEY`	Clave secreta de la API de Stripe
`STRIPE_WEBHOOK_SECRET`	Verifica los webhooks de `checkout.session.completed`
`STRIPE_PRICE_CREDITS_10`	ID de precio de Stripe opcional para el paquete de $10 (si no, codificado)
`PUBLIC_BASE_URL`	Host canónico, p. ej., `https://agentservices.to`

Los saldos de crédito prepagado se almacenan en el Saldo de cliente de Stripe (un cliente de Stripe por sub de Google). No se requiere Redis, Postgres ni otra base de datos.

Sin las variables de Google/Stripe, la API se inicia en modo solo x402.

URI de redirección de Google Cloud Console

Agrega ambos hosts:

https://agentservices.to/oauth/google/callback
https://api.agentservices.to/oauth/google/callback

Webhook de Stripe

Apunta Stripe a:

https://agentservices.to/billing/webhook
https://api.agentservices.to/billing/webhook

Evento: checkout.session.completed

Descubrimiento y listados

Descubrimiento x402 — En vivo
Registro MCP — Listado como to.agentservices/agentservices
CDP Bazaar — Extensión habilitada
awesome-x402 — PR enviado

Pila tecnológica

FastAPI (Python 3.11+)
Middleware de pago x402 v2 (facilitador Coinbase CDP)
USDC en Base Mainnet (transferencias sin gas EIP-3009)
Desplegado en Railway con dominio personalizado + TLS

Integración con Coinbase AgentKit

AgentServices incluye un Coinbase AgentKit integrado como proveedor de acciones (directorio agentkit/). Esto permite que cualquier agente AgentKit use las APIs de AgentServices con acciones tipadas y documentadas:

from coinbase_agentkit import AgentKit, AgentKitConfig
from agentkit import agentservices_action_provider

agent_kit = AgentKit(AgentKitConfig(
    wallet_provider=wallet_provider,
    action_providers=[agentservices_action_provider()]
))

18 acciones que cubren endpoints gratuitos (precios, miedo-codicia, tendencias, gas) y de pago (indicadores, rendimientos DeFi, inteligencia de cartera, investigación, análisis on-chain, inferencia de IA y más). Consulta agentkit/README.md para la documentación completa.

Licencia

MIT — Constrúyelo, haz un fork, intégralo.

Enlaces

API: agentservices.to
MCP: agentservices.to/mcp
Descubrimiento: agentservices.to/.well-known/x402
GitHub: github.com/vbkotecha/agentservices-api
Protocolo x402: x402.org
Base: base.org