AgentServices

AgentServices

The paid API layer for AI agents — data, intelligence, inference, and media via x402 micropayments

Canonical project: https://github.com/vbkotecha/agentservices-api Official site: https://agentservices.to License: Apache-2.0

AgentServices is an independent project. It is not affiliated with, endorsed by, or a replacement for any other x402 market-data provider.

[Version] [Network] [Payment] [MCP] [Status]

Live at: agentservices.to | MCP Server: https://agentservices.to/mcp (Streamable HTTP) | Discovery: /.well-known/x402

What is this?

AgentServices is the monetized API layer for AI agents. No API keys, no subscriptions — agents pay per-request with USDC on Base using the x402 payment protocol.

60+ endpoints across crypto data, market intelligence, DeFi analytics, on-chain analytics, 400+ LLM models, image generation, text-to-speech, portfolio intelligence, and dispute resolution. 12 are free. 48+ are paid via x402 (from $0.002 to $0.25 per call).

What's new in v6.0

• 400+ LLM models via OpenAI-compatible /v1/chat/completions — GPT, Claude, Gemini, DeepSeek, Grok, Llama, and more
• Smart router — use model: "auto" and the gateway classifies your task and picks the cheapest model that handles it
• Image generation — /v1/images/generations via gpt-image-2 ($0.05)
• Text-to-speech — /v1/audio/speech with natural voices ($0.05)
• 3 new MCP tools — chat, generate_image, text_to_speech

Buyer path: discover → try → pay → retain

Use the buyer quickstart for the complete path. The exact next action is to run the no-credential discovery check:

python3 examples/mcp_discovery_buyer_proof.py

Then follow the same buyer journey:

1. Discover: confirm the hosted MCP server and free tool catalog with the MCP discovery proof.
2. Try free: retrieve a real price result with the free SDK proof.
3. Inspect the paid challenge: decode the live 402 terms with the paid SDK proof. It never signs or settles payment.
4. Buy an outcome: pay the returned x402 terms, retry the same request, and retain the returned paid result. See the token-risk, market-pulse, and research-brief contracts for result limits and provenance.
5. Retain evidence: run the existing receipt builder with the original challenge, paid response, and your wallet authorization or transaction reference.

The four proofs have different limits: discovery and free SDK verify no-spend access; the paid SDK proof verifies challenge shape only; the receipt builder hashes buyer-held evidence and does not verify settlement. None of them claims adoption, settlement, or revenue.

For activation measurement definitions, see Activation Metrics. To probe the live funnel, run python3 examples/check_activation_funnel.py.

Buyer path: discover → try → pay → retain

Use the buyer quickstart for the complete path. The exact next action is to run the no-credential discovery check:

python3 examples/mcp_discovery_buyer_proof.py

Then follow the same buyer journey:

1. Discover: confirm the hosted MCP server and free tool catalog with the MCP discovery proof.
2. Try free: retrieve a real price result with the free SDK proof.
3. Inspect the paid challenge: decode the live 402 terms with the paid SDK proof. It never signs or settles payment.
4. Buy an outcome: pay the returned x402 terms, retry the same request, and retain the returned paid result. See the token-risk, market-pulse, and research-brief contracts for result limits and provenance.
5. Retain evidence: run the existing receipt builder with the original challenge, paid response, and your wallet authorization or transaction reference.

The four proofs have different limits: discovery and free SDK verify no-spend access; the paid SDK proof verifies challenge shape only; the receipt builder hashes buyer-held evidence and does not verify settlement. None of them claims adoption, settlement, or revenue.

Endpoints

Free (no payment required)

Trade API — venue doors (FREE — not x402)

AgentServices is building venue trade doors under /v1/trade/{venue}/…. Hyperliquid ships first; more venues and a venue-neutral /v1/trade/execute router follow.

Each door is a policy leash + forward — not a smarter router. We do not claim better fills than the venue direct. Execution is free at the call (no x402 on the order path). Builder fees are omitted so routing through us is not more expensive than going direct.

We never collect venue API keys. Agents sign orders locally with an HL-approved agent wallet (approveAgent on the main wallet is the one human bootstrap step). AgentServices policy-checks (max notional, coin allowlist, kill switch) and forwards the signed payload.

Request bodies accept market_type: spot, perp, or future. Hyperliquid implements perp and spot today; unsupported types return a machine-readable market_type_not_supported error.

Legacy hl_* MCP tool names remain as aliases. See GET /v1/trade/hyperliquid/bootstrap for the approveAgent signing model.

Roadmap: /v1/trade/{venue} for additional venues; /v1/trade/execute for venue-neutral routing later.

Paid — Data APIs (x402)

Paid — Synthesis APIs (x402)

Paid — Bundled Intelligence (x402)

Paid — AI Inference (x402)

Paid — Dispute Resolution (x402)

Use Cases — What Agents Can Build

Portfolio Monitor

# ALL-IN-ONE: Get portfolio intelligence in a single call ($0.10)# Returns: price + technical signal + risk score + market sentiment + verdictcurl "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

DeFi Yield Optimizer

# ALL-IN-ONE: Get DeFi strategy report ($0.25)# Returns: top yields + protocol TVL + cross-chain comparison + risk flagscurl "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

Market Intelligence Agent

# ALL-IN-ONE: Get market pulse report ($0.05)# Returns: fear-greed + trending + news + social + whales + global marketcurl "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"

Technical Analysis Bot

# 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

Developer Research Agent

# 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"

AI Chat / Inference

# 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"}]}'

On-Chain Analytics

# ALL-IN-ONE: Get full on-chain overview ($0.15)# Returns: whale movements + exchange flows + stablecoin flows + correlation matrix + DeFi TVLcurl "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

Quick Start

Using curl

# Free — no payment neededcurl https://agentservices.to/v1/prices?symbols=BTC,ETH
# Paid — returns HTTP 402 with payment instructions in the headercurl -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

Using as MCP Server (Claude Desktop, Cursor, etc.)

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

13+ MCP tools available: 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

Using with Python

import httpx
# Free endpointsresp = httpx.get("https://agentservices.to/v1/prices?symbols=BTC,ETH")prices = resp.json()
# Paid endpoints — use x402 client to handle paymentfrom x402.client import x402Clientclient = x402Client()result = client.get("https://agentservices.to/v1/indicators/BTC")# Client handles 402 → pays USDC → retries with payment proof → returns data

Using with JavaScript/TypeScript

// Free endpointsconst prices = await fetch("https://agentservices.to/v1/prices?symbols=BTC,ETH").then(r => r.json());
// Paid endpoints — use @x402/facilitatorimport { wrapFetchWithPayment } from "@x402/facilitator";const paidFetch = wrapFetchWithPayment(fetch);const indicators = await paidFetch("https://agentservices.to/v1/indicators/BTC").then(r => r.json());

Dispute Resolution Engine

AgentServices includes an AI-powered dispute resolution system with 7 policy templates:

Human billing door (ChatGPT / Claude)

Wallet agents continue to pay via x402 on REST — unchanged. Humans connecting through ChatGPT Developer Mode or Claude custom connectors can use Google OAuth + Stripe prepaid credits on MCP.

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

Environment variables

Copy .env.example. Required to enable the human door:

Prepaid credit balances are stored in Stripe Customer Balance (one Stripe Customer per Google sub). No Redis, Postgres, or other database is required.

Without Google/Stripe vars the API boots in x402-only mode.

Google Cloud Console redirect URIs

Add both hosts:

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

Stripe webhook

Point Stripe to:

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

Event: checkout.session.completed

Discovery & Listings

• x402 Discovery — Live
• MCP Registry — Listed as to.agentservices/agentservices
• CDP Bazaar — Extension enabled
• awesome-x402 — PR submitted

Tech Stack

• FastAPI (Python 3.11+)
• x402 v2 payment middleware (Coinbase CDP facilitator)
• USDC on Base Mainnet (EIP-3009 gasless transfers)
• Deployed on Vercel (agentservices.to + api.agentservices.to, auto-deploy from main)

Coinbase AgentKit Integration

AgentServices includes a built-in Coinbase AgentKit action provider (agentkit/ directory). This lets any AgentKit agent use AgentServices APIs with typed, documented actions:

from coinbase_agentkit import AgentKit, AgentKitConfigfrom agentkit import agentservices_action_provider
agent_kit = AgentKit(AgentKitConfig(    wallet_provider=wallet_provider,    action_providers=[agentservices_action_provider()]))

18 actions covering free (prices, fear-greed, trending, gas) and paid endpoints (indicators, DeFi yields, portfolio intelligence, research, onchain analytics, AI inference, and more). See agentkit/README.md for full documentation.

License

MIT — Build on it, fork it, integrate it.

Links

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