# AIServices

> Paid data APIs for AI agents. Crypto prices, technical indicators, DeFi yields, IP geolocation, URL metadata, on-chain analytics, whale tracking, correlation matrix, DeFi TVL, stablecoin flows, GitHub velocity, macro indicators, marketing intelligence, and dispute resolution.

## Base URL
https://api.agentservices.to

## Authentication
Paid endpoints use x402 protocol (USDC on Base Mainnet). Free endpoints require no auth.

## Free Endpoints
- GET /v1/price/{symbol} — Current crypto price (e.g., BTC, ETH)
- GET /v1/prices?symbols=BTC,ETH,SOL — Batch crypto prices
- GET /v1/fear-greed — Crypto Fear & Greed Index (0-100)
- GET /v1/geo/{ip} — IP geolocation lookup
- GET /v1/global — Global market cap, volume, BTC dominance
- GET /v1/trending — Trending tokens being searched right now
- GET /v1/gas — Current Ethereum gas prices (slow/standard/fast)
- GET /v1/swap/quote — DEX swap quote (0x API, 6 chains)
- GET /v1/predictions — Active Polymarket prediction markets
- GET /v1/predictions/{slug} — Specific prediction market details
- GET /v1/news — Latest crypto and blockchain news
- GET /v1/social — Trending coins, categories, NFTs

## Paid Endpoints (x402 / USDC on Base)
- GET /v1/indicators/{symbol} — RSI, Bollinger Bands, ATR, Support/Resistance ($0.02)
- GET /v1/yields — Top DeFi yield pools by TVL ($0.02)
- GET /v1/metadata?url=... — URL metadata extraction and unfurling ($0.01)
- GET /v1/search?q=... — AI-powered web search ($0.01)
- 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)
- GET /v1/whales — Large whale transactions BTC/ETH ($0.02)
- GET /v1/exchange-flows — CEX reserve flows ($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 ($0.02)
- GET /v1/github-velocity — GitHub crypto repo velocity scores ($0.02)
- GET /v1/macro — Macro economic indicators ($0.02)

## Free Agent Tools
- GET /v1/agent-context — Paste-ready market context for LLM prompts

## Example Usage
```
# Free: Get BTC price
curl https://api.agentservices.to/v1/price/BTC

# Paid: Get BTC indicators (requires x402 payment)
curl https://api.agentservices.to/v1/indicators/BTC
```

## Payment Wallet
0x1830DAdb0A16eb569B5f8526AADDF47ce85aC8e0

## Links
- API Docs: https://api.agentservices.to/docs
- GitHub: https://github.com/vbkotecha/aiservices-api