# OmniAPI

## Overview
OmniAPI is a unified paid API hub with 444 endpoints for AI agents and developers.
All endpoints use the x402 payment protocol with USDC payments across 9+ chains.
No API keys needed — pay per call in USDC.

## Multi-Chain Support
Supported chains:
- Base (eip155:8453) — Primary
- Polygon (eip155:137)
- Arbitrum (eip155:42161)
- Optimism (eip155:10)
- Avalanche (eip155:43114)
- BNB Smart Chain (eip155:56)
- Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)

## Multi-Facilitator Support
Payments are verified and settled across 4 independent facilitators:
- Dexter (https://x402.dexter.cash) — Free, 11 chains
- Meridian (https://settle.mrdn.finance) — Proxy facilitator, 10 chains
- FluxA (https://fluxapay.xyz) — Agent wallet, Base + XRP
- GoPlausible (https://facilitator.goplausible.xyz) — Free, Base + Solana + Algorand

## 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 and chain options
3. Send an X-PAYMENT header with your signed payment proof on any supported chain
4. The server verifies against all 4 facilitators and settles with the one that validates

## Payment Details
- Protocol: x402 v2
- Networks: Base, Polygon, Arbitrum, Optimism, Avalanche, BNB, Solana
- Asset: USDC
- Payment header: X-PAYMENT
- Prices: $0.01-$0.20 per call (10000-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.