# AgentServices — Complete API Reference

> Paid APIs for AI agents. 53 services, 41 paid. Data, search, market intelligence, inference, and services agents pay for via x402 (USDC on Base).

## What is AgentServices?

AgentServices is a paid API platform for AI agents. Agents discover and pay for data, search, market intelligence, and other services via x402 (USDC on Base). 53 endpoints, 41 paid, MCP integration, and cross-DEX arbitrage scanning.

## Base URL
https://agentservices.to

## Authentication
Paid endpoints use the x402 protocol (USDC on Base Mainnet, chain ID 8453). Free endpoints require no authentication.
Payment wallet: 0x9863aB6242663FCc84c33632741711dB78f8Fd15

## Free Endpoints (No Payment Required)

### Cryptocurrency
- GET /v1/price/{symbol} — Current crypto price (BTC, ETH, SOL, etc.)
- GET /v1/prices?symbols=BTC,ETH,SOL — Batch crypto prices
- GET /v1/fear-greed — Crypto Fear & Greed Index (0-100 scale)
- GET /v1/global — Global market cap, 24h volume, BTC dominance
- GET /v1/trending — Trending tokens being searched right now
- GET /v1/gas — Current Ethereum gas prices (slow/standard/fast in Gwei)
- GET /v1/swap/quote?chain=ethereum&tokenIn=...&tokenOut=... — DEX swap quote (0x API, 6 chains)

### Prediction Markets
- GET /v1/predictions — Active Polymarket prediction markets
- GET /v1/predictions/{slug} — Specific prediction market details

### News & Social
- GET /v1/news — Latest crypto and blockchain news headlines
- GET /v1/social — Trending coins, categories, NFTs from social signals

### Utility
- GET /v1/geo/{ip} — IP geolocation lookup (city, country, ISP, coordinates)
- GET /v1/policies — List dispute policy templates
- GET /v1/agent-context — Paste-ready market context for LLM prompts
- POST /mcp — MCP server (JSON-RPC over SSE, 36 tools)

## Paid Endpoints (x402 / USDC on Base)

### Crypto Data & Analytics ($0.01-$0.04)
- GET /v1/indicators/{symbol} — Technical indicators: RSI, Bollinger Bands, ATR, Support/Resistance ($0.02)
- GET /v1/yields — Top DeFi yield pools by TVL across chains ($0.02)
- GET /v1/metadata?url=... — URL metadata extraction and unfurling ($0.01)
- GET /v1/search?q=... — AI-powered web search ($0.01)
- GET /v1/whales — Large whale transactions for BTC/ETH ($0.02)
- GET /v1/exchange-flows — CEX reserve flows and netflow ($0.02)
- GET /v1/correlation — 30-day cross-asset correlation matrix ($0.03)
- GET /v1/defi-tvl — DeFi protocol TVL rankings ($0.02)
- GET /v1/stablecoin-flows — Stablecoin market caps and supply changes ($0.02)
- GET /v1/github-velocity — GitHub crypto repo velocity scores ($0.02)
- GET /v1/macro — Macro economic indicators: CPI, GDP, Fed rate ($0.02)
- GET /v1/token-risk/{token} — Token risk scoring (0-100) ($0.03)
- GET /v1/signals/{symbol} — Crypto buy/sell signals with confidence ($0.04)
- GET /v1/hn-sentiment — Hacker News tech sentiment analysis ($0.02)
- GET /v1/npm-stats/{package} — NPM download trends ($0.02)
- GET /v1/github-trending — GitHub trending repos (daily/weekly) ($0.02)
- GET /v1/yield-comparison — DeFi yield comparison with risk assessment ($0.03)

### Traditional Finance ($0.003-$0.03)
- GET /v1/stocks/{ticker} — Real-time stock quote ($0.02)
- GET /v1/stocks/{ticker}/history — Historical OHLCV data ($0.03)
- GET /v1/sec/{ticker} — SEC filings parser: 10-K, 10-Q, Form 4 ($0.03)
- GET /v1/commodities — Oil, gold, silver, wheat prices ($0.03)
- GET /v1/economic — CPI, GDP, unemployment, Fed rate (FRED) ($0.03)
- GET /v1/fx?base=USD — 30+ currency exchange rates ($0.003)

### Utility ($0.002-$0.02)
- GET /v1/extract?url=... — Web content extraction, clean text from any URL ($0.002)
- GET /v1/security/{package} — Package vulnerability scan (PyPI/npm) ($0.02)
- GET /v1/seo/keywords?keyword=... — SEO keyword research with volume ($0.01)

### AI Inference ($0.03)
- POST /v1/inference — LLM inference gateway (gpt-5.4, gpt-5.4-mini, gpt-5.5, gemini) ($0.03)
- POST /v1/complete?prompt=... — Quick text completion ($0.03)

### Bundled Intelligence ($0.05-$0.25)
- GET /v1/research?q=... — Deep research: search + extract + synthesize ($0.05)
- GET /v1/portfolio?symbol=... — Portfolio intelligence: price + signal + risk + sentiment ($0.10)
- GET /v1/defi-strategy?chain=... — DeFi strategy: yields + TVL + comparison + risk ($0.25)
- GET /v1/market-pulse — Market pulse: sentiment + trending + news + whales + global ($0.05)
- GET /v1/onchain-overview — On-chain: whales + flows + correlation + DeFi TVL ($0.15)
- GET /v1/arbitrage?symbols=... — Cross-DEX arbitrage scanner with gas-adjusted profitability ($0.08)

### Marketing Intelligence ($0.03-$0.05)
- POST /v1/marketing/sentiment — AI brand sentiment analysis ($0.03)
- POST /v1/marketing/trends — Industry trend detection with velocity ($0.03)
- POST /v1/marketing/competitors — Competitive intelligence ($0.05)
- POST /v1/marketing/content-gaps — SEO content gap analysis ($0.04)
- POST /v1/marketing/ad-copy — AI ad copy generator ($0.05)

### Dispute Resolution
- POST /v1/disputes — Submit dispute for policy-driven ruling ($0.05)

### Voice
- GET /v1/phone — AgentServices phone number info (FREE)
- POST /v1/calls — Make outbound AI voice call ($0.54)
- GET /v1/lookup/{phone} — Phone number carrier lookup ($0.05)

## Example Usage

```bash
# Free: Get BTC price
curl https://agentservices.to/v1/price/BTC

# Paid: Get BTC technical indicators (returns 402 without payment)
curl https://agentservices.to/v1/indicators/BTC

# Free: Batch prices
curl 'https://agentservices.to/v1/prices?symbols=BTC,ETH,SOL'

# Free: Trending tokens
curl https://agentservices.to/v1/trending
```

## MCP Integration

AgentServices provides a remote MCP server at https://agentservices.to/mcp with 36 tools.

MCP config for Claude Desktop:
{"mcpServers":{"agentservices":{"url":"https://agentservices.to/mcp"}}}


## Payment Protocol

AgentServices uses x402 version 2. Agents pay per call with USDC on Base (chain ID 8453).
- Discovery: /.well-known/x402.json
- 402 response includes: payment amount, payTo address, network, asset contract, Bazaar extension
- Revenue wallet: 0x9863aB6242663FCc84c33632741711dB78f8Fd15

## Discovery Files
- /.well-known/x402.json — x402 v2 payment manifest
- /.well-known/x402-service.json — x402 service listing format
- /.well-known/mcp/server-card.json — MCP server card
- /.well-known/ai-catalog.json — ARD (Agentic Resource Discovery) catalog
- /.well-known/ai-plugin.json — OpenAI plugin manifest
- /.well-known/agent-card.json — Agent identity card
- /.well-known/agentskills/agentservices/SKILL.md — AgentSkills.io skill
- /.well-known/agent-skills/index.json — Agent skills index
- /openapi.json — OpenAPI 3.1 specification with x-payment-info
- /robots.txt — AI crawler rules with Content-Signal directives
- /sitemap.xml — XML sitemap
- /feed.json — JSON Feed
- /llms.txt — Concise LLM-readable description
- /examples — Agent integration guide with curl examples

## Links
- API Docs (Swagger): https://agentservices.to/docs
- Integration Examples: https://agentservices.to/examples
- GitHub: https://github.com/vbkotecha/aiservices-api
- x402 Manifest: https://agentservices.to/.well-known/x402.json

## SDK
- Python: pip install agentservices (LangChain + CrewAI tools included)
- MCP: npx agentservices-mcp (pure JavaScript, zero dependencies)
- ElizaOS: @agentservices/plugin-elizaos (12 actions + market context provider)
- AgentKit: @agentservices/agentkit-provider (18 actions for Coinbase AgentKit)