AgentServices

AgentServices

A camada de API paga para agentes de IA — dados, inteligência, inferência e mídia via micropagamentos x402

Projeto canônico: https://github.com/vbkotecha/agentservices-api Site oficial: https://agentservices.to Licença: Apache-2.0

AgentServices é um projeto independente. Não é afiliado, endossado ou um substituto para qualquer outro provedor de dados de mercado x402.

No ar em: agentservices.to | Servidor MCP: https://agentservices.to/mcp (HTTP Streamable) | Descoberta: /.well-known/x402

O que é isso?

AgentServices é a camada de API monetizada para agentes de IA. Sem chaves de API, sem assinaturas — agentes pagam por requisição com USDC na Base usando o protocolo de pagamento x402.

Mais de 60 endpoints em dados de criptomoedas, inteligência de mercado, análises DeFi, análises on-chain, mais de 400 modelos de LLM, geração de imagens, texto-para-fala, inteligência de portfólio e resolução de disputas. 12 são gratuitos. Mais de 48 são pagos via x402 (de $0,002 a $0,25 por chamada).

O que há de novo na v6.0

• Mais de 400 modelos de LLM via /v1/chat/completions compatível com OpenAI — GPT, Claude, Gemini, DeepSeek, Grok, Llama e outros
• Roteador inteligente — use model: "auto" e o gateway classifica sua tarefa e escolhe o modelo mais barato que a resolve
• Geração de imagens — /v1/images/generations via gpt-image-2 ($0,05)
• Texto-para-fala — /v1/audio/speech com vozes naturais ($0,05)
• 3 novas ferramentas MCP — chat, generate_image, text_to_speech

Caminho do comprador: descobrir → experimentar → pagar → reter

Use o quickstart para compradores para o caminho completo. A próxima ação exata é executar a verificação de descoberta sem credenciais:

python3 examples/mcp_discovery_buyer_proof.py

Em seguida, siga a mesma jornada do comprador:

1. Descobrir: confirme o servidor MCP hospedado e o catálogo de ferramentas gratuitas com a prova de descoberta MCP.
2. Experimentar grátis: recupere um resultado de preço real com a prova gratuita do SDK.
3. Inspecionar o desafio pago: decodifique os termos 402 ao vivo com a prova paga do SDK. Ela nunca assina ou liquida pagamentos.
4. Comprar um resultado: pague os termos x402 retornados, repita a mesma requisição e retenha o resultado pago retornado. Consulte os contratos token-risk, market-pulse e research-brief para limites de resultado e proveniência.
5. Reter evidências: execute o construtor de recibos existente com o desafio original, a resposta paga e sua autorização de carteira ou referência de transação.

As quatro provas têm limites diferentes: descoberta e SDK gratuito verificam acesso sem gasto; a prova paga do SDK verifica apenas a forma do desafio; o construtor de recibos gera hash de evidências retidas pelo comprador e não verifica liquidação. Nenhuma delas afirma adoção, liquidação ou receita.

Para definições de medição de ativação, consulte Métricas de Ativação. Para sondar o funil ao vivo, execute python3 examples/check_activation_funnel.py.

Endpoints

Gratuitos (sem pagamento necessário)

Endpoint	Descrição
GET /v1/prices?symbols=BTC,ETH	Preços atuais de criptomoedas (CoinGecko)
GET /v1/trending	Tokens em tendência por atividade de mercado
GET /v1/global	Capitalização de mercado global, volume, dominância do BTC
GET /v1/fear-greed	Índice de sentimento de Medo e Ganância em cripto
GET /v1/gas	Preços atuais de gas na Base/Ethereum
GET /v1/predictions	Previsões de mercado geradas por IA
GET /v1/news	Últimas manchetes de notícias de cripto
GET /v1/social/trending	Tópicos de sentimento social em tendência
GET /v1/geo?ip=1.2.3.4	Consulta de geolocalização por IP
GET /v1/swap/quote?from=&to=&amount=	Cotação de swap DEX (integração 0x)
GET /v1/policies	Listar modelos de política de resolução de disputas
GET /health	Verificação de saúde da API

Pagos — APIs de Dados (x402)

Endpoint	Preço	Descrição
GET /v1/indicators/BTC	$0,02	Indicadores técnicos (RSI, MACD, Bandas de Bollinger, ATR, Suporte/Resistência)
GET /v1/yields	$0,02	Principais pools de rendimento DeFi por TVL
GET /v1/metadata?url=	$0,01	Extração e desdobramento de metadados de URL
GET /v1/search?q=	$0,01	Busca na web por informações de cripto/mercado
GET /v1/onchain/:address	$0,02	Análises on-chain para qualquer endereço
GET /v1/onchain/:address/tokens	$0,03	Participações em tokens para qualquer endereço

Pagos — APIs de Síntese (x402)

Endpoint	Preço	Descrição
GET /v1/token-risk/{token}	$0,03	Pontuação de risco baseada em volatilidade, proxy de liquidez e capitalização de mercado
GET /v1/crypto-signals	$0,04	Sinais agregados de compra/venda em múltiplos indicadores
GET /v1/yield-comparison	$0,03	Comparar rendimentos entre protocolos com retornos ajustados ao risco
GET /v1/hn-sentiment	$0,02	Análise de sentimento do Hacker News para tópicos de tecnologia
GET /v1/npm-stats/:package	$0,02	Estatísticas e tendências de downloads de pacotes NPM
GET /v1/github-trending	$0,02	Repositórios GitHub em tendência por linguagem/tópico
GET /v1/marketing-intel	$0,05	Inteligência de marketing: concorrentes, lacunas de conteúdo, textos de anúncios

Pagos — Inteligência Agrupada (x402)

Endpoint	Preço	Descrição
GET /v1/research?q=	$0,05	Pesquisa profunda: busca + extração + síntese em uma única chamada
GET /v1/portfolio?symbol=BTC	$0,10	Inteligência de portfólio: preço + sinal + risco + sentimento + veredito
GET /v1/defi-strategy	$0,25	Relatório de estratégia DeFi: principais rendimentos + TVL + comparação + alertas de risco
GET /v1/market-pulse	$0,05	Pulso de mercado: medo-ganância + tendências + notícias + social + baleias + global
GET /v1/onchain-overview	$0,15	Visão geral on-chain: baleias + fluxos de exchanges + fluxos de stablecoins + correlação + TVL DeFi

Pagos — Inferência de IA (x402)

Endpoint	Preço	Descrição
POST /v1/inference	$0,03	Inferência de LLM (gpt-5.4/5.4-mini/5.5) — conclusões de chat
POST /v1/complete	$0,03	Conclusão de texto (proxy CodexSale)

Pagos — Resolução de Disputas (x402)

Endpoint	Preço	Descrição
POST /v1/disputes	$0,05	Resolução de disputas com IA (7 modelos de política)

---

Casos de Uso — O que os Agentes Podem Construir

Monitor de Portfólio

# 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

Otimizador de Rendimento 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 Inteligência 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álise Técnica

# 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 Pesquisa para Desenvolvedores

# 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 / Inferência 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álises 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

---

Início 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"
    }
  }
}

Mais de 13 ferramentas MCP disponíveis: 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 com 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 com 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());

Mecanismo de Resolução de Disputas

AgentServices inclui um sistema de resolução de disputas com IA e 7 modelos de política:

Política	Caso de Uso
freelance-delivery	Disputas de entrega entre freelancer e cliente
milestone-payment	Disputas de pagamento de projetos baseados em marcos
sla-monitoring	Violações de acordo de nível de serviço
api-quality	Disputas de qualidade de resposta / disponibilidade de API
bug-bounty	Disputas de validade de recompensas por bugs
scope-dispute	Disputas de expansão de escopo de projeto
physical-commerce	Disputas de transações de bens físicos

Porta de cobrança humana (ChatGPT / Claude)

Agentes de carteira continuam pagando via x402 em REST — sem alterações. Humanos conectados pelo Modo Desenvolvedor do ChatGPT ou conectores personalizados do Claude podem usar Google OAuth + créditos pré-pagos Stripe no MCP.

Trilho	Quem	Como
x402	Agentes de carteira	REST não autenticado → HTTP 402 → USDC na Base
Créditos	Humanos logados	Google OAuth no MCP → deduz o mesmo preço em USD do saldo pré-pago

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

Variáveis de ambiente

Copie .env.example. Necessário para habilitar a porta humana:

Variável	Finalidade
GOOGLE_CLIENT_ID	ID do cliente Google OAuth
GOOGLE_CLIENT_SECRET	Segredo do cliente Google OAuth
OAUTH_JWT_SECRET	Assina tokens de portador MCP (ou use SESSION_SECRET)
STRIPE_SECRET_KEY	Chave secreta da API Stripe
STRIPE_WEBHOOK_SECRET	Verifica webhooks checkout.session.completed
STRIPE_PRICE_CREDITS_10	ID de Preço Stripe opcional para pacote de $10 (caso contrário, codificado)
PUBLIC_BASE_URL	Host canônico, ex.: https://agentservices.to

Saldos de crédito pré-pago são armazenados no Saldo do Cliente Stripe (um Cliente Stripe por Google sub). Nenhum Redis, Postgres ou outro banco de dados é necessário.

Sem as variáveis do Google/Stripe, a API inicia no modo somente x402.

URIs de redirecionamento do Google Cloud Console

Adicione ambos os hosts:

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

Webhook do Stripe

Aponte o Stripe para:

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

Evento: checkout.session.completed

Descoberta e Listagens

• Descoberta x402 — Ao vivo
• Registro MCP — Listado como to.agentservices/agentservices
• CDP Bazaar — Extensão habilitada
• awesome-x402 — PR enviado

Pilha Tecnológica

• FastAPI (Python 3.11+)
• Middleware de pagamento x402 v2 (facilitador Coinbase CDP)
• USDC na Base Mainnet (transferências sem gas EIP-3009)
• Implantado na Railway com domínio personalizado + TLS

Integração com Coinbase AgentKit

AgentServices inclui um provedor de ações Coinbase AgentKit integrado (diretório agentkit/). Isso permite que qualquer agente AgentKit use as APIs do AgentServices com ações tipadas e 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 ações cobrindo endpoints gratuitos (preços, medo-ganância, tendências, gas) e pagos (indicadores, rendimentos DeFi, inteligência de portfólio, pesquisa, análises on-chain, inferência de IA e mais). Consulte agentkit/README.md para documentação completa.

Licença

MIT — Construa em cima, faça fork, integre.

Links

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