# NexusAPI

## Overview
NexusAPI is a unified paid API hub with 444 endpoints for AI agents and developers.
All endpoints use the x402 payment protocol on Base (chain eip155:8453) with USDC payments.
No API keys needed — pay per call in USDC.

## Endpoints
444 total endpoints across 14 categories:
- ai: 50 endpoints
- anime: 8 endpoints
- crypto: 50 endpoints
- finance: 50 endpoints
- fun: 22 endpoints
- gaming: 12 endpoints
- geo: 40 endpoints
- health: 30 endpoints
- media: 17 endpoints
- news: 15 endpoints
- social: 51 endpoints
- tools: 50 endpoints
- weather: 40 endpoints
- web: 9 endpoints

## How to Use
1. Fetch the OpenAPI spec at /openapi.json to discover all endpoints and pricing
2. Each endpoint returns a 402 Payment Required response with the price in the response body
3. Send an X-PAYMENT header with your signed payment proof
4. The facilitator at https://facilitator.payai.network handles verification and settlement

## Payment Details
- Protocol: x402 v2
- Network: Base (eip155:8453)
- Asset: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
- Payment header: X-PAYMENT
- Facilitator: https://facilitator.payai.network
- Prices: $0.05-$0.20 per call (50000-200000 atomic units)

## Discovery
- OpenAPI spec: /openapi.json
- This file: /llms.txt
- x402 discovery: /.well-known/x402

## Example Endpoints
- GET /api/crypto/price — Get real-time crypto price ($0.140654)
- GET /api/crypto/history — Get crypto price history ($0.122102)
- GET /api/crypto/market — Get global crypto market data ($0.167697)
- GET /api/crypto/trending — Get trending cryptocurrencies ($0.091212)
- GET /api/crypto/search — Search cryptocurrencies by name ($0.085726)
- GET /api/crypto/exchanges — List crypto exchanges ($0.062573)
- GET /api/crypto/coins — List all coins with market data ($0.085364)
- GET /api/crypto/coin-detail — Get detailed coin info ($0.130898)
- GET /api/crypto/coin-history — Get coin price history ($0.152313)
- GET /api/crypto/coin-markets — Get markets for a coin ($0.069604)
- GET /api/crypto/news — Get latest crypto news ($0.172373)
- GET /api/crypto/sentiment — Get crypto market sentiment ($0.101916)
- GET /api/crypto/defi — Get DeFi protocol data ($0.173928)
- GET /api/crypto/nft — Get NFT collection data ($0.121433)
- GET /api/crypto/gas — Get current gas prices ($0.114550)
- GET /api/crypto/whale-alert — Track whale transactions ($0.169485)
- GET /api/crypto/fear-greed — Get Fear & Greed index ($0.156508)
- GET /api/crypto/bitcoin/mempool — Get Bitcoin mempool stats ($0.070534)
- GET /api/crypto/ethereum/gas — Get Ethereum gas tracker ($0.152600)
- GET /api/crypto/solana/tokens — Get Solana token data ($0.064409)
... and 424 more endpoints.

## Categories
### ai
AI chat, translation, code generation, image generation, text analysis, summarization

### anime
Anime and manga databases, seasonal data, recommendations

### crypto
Cryptocurrency prices, market data, DeFi, NFTs, whale tracking, on-chain data

### finance
Stocks, forex, commodities, ETFs, bonds, economic data, calculators

### fun
Trivia, jokes, quotes, facts, horoscopes, tarot, cocktails, meals

### gaming
Steam, Twitch, Pokemon, game databases

### geo
Geocoding, IP lookup, timezone, country data, place search, routing

### health
BMI, nutrition, exercises, yoga, meditation, calorie data

### media
Movies, TV shows, books, music, podcasts, lyrics

### news
News headlines, search, trending, category-specific news

### social
Twitter, Instagram, TikTok, YouTube, Reddit, Facebook, LinkedIn analytics

### tools
QR codes, hashing, encoding, regex, unit conversion, math, utilities

### weather
Current weather, forecasts, air quality, UV index, pollen, alerts

### web
Web search, image search, screenshots, PDF extraction, URL metadata