{"openapi":"3.1.0","info":{"title":"x402-api","version":"1.0.5","description":"Eight paid crypto and DeFi data endpoints. HTTP 402 challenges describe USDC payment on Base."},"servers":[{"url":"https://x402-api.fly.dev"}],"paths":{"/api/price-feed":{"get":{"operationId":"priceFeed","summary":"BTC, ETH, SOL prices and selected 24h movers from CoinGecko or CoinLore fallback.","description":"Price: 0.001 USDC per successful call on Base. Request without payment to receive an x402 v1 challenge. Upstream data is checked before payment is requested.","parameters":[],"responses":{"200":{"description":"Live data returned after payment","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid query parameters"},"402":{"description":"x402 v1 payment challenge, including price and Base USDC payment requirements","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"Live upstream data unavailable; no payment requested"}}}},"/api/whale-tracker":{"get":{"operationId":"whaleTracker","summary":"GoPlus top-holder sample and reported supply concentration; no transfer history or Gini.","description":"Price: 0.005 USDC per successful call on Base. Request without payment to receive an x402 v1 challenge. Upstream data is checked before payment is requested.","parameters":[{"name":"token","in":"query","required":false,"schema":{"type":"string","default":"ETH"}},{"name":"chain","in":"query","required":false,"schema":{"type":"string","default":"ethereum"}}],"responses":{"200":{"description":"Live data returned after payment","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid query parameters"},"402":{"description":"x402 v1 payment challenge, including price and Base USDC payment requirements","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"Live upstream data unavailable; no payment requested"}}}},"/api/funding-rates":{"get":{"operationId":"fundingRates","summary":"Hourly Hyperliquid and dYdX v4 funding rates with indicative spread comparison.","description":"Price: 0.008 USDC per successful call on Base. Request without payment to receive an x402 v1 challenge. Upstream data is checked before payment is requested.","parameters":[{"name":"asset","in":"query","required":false,"schema":{"type":"string","default":"all"}},{"name":"min_spread","in":"query","required":false,"schema":{"type":"number","default":0}}],"responses":{"200":{"description":"Live data returned after payment","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid query parameters"},"402":{"description":"x402 v1 payment challenge, including price and Base USDC payment requirements","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"Live upstream data unavailable; no payment requested"}}}},"/api/gas-tracker":{"get":{"operationId":"gasTracker","summary":"Gas prices across Ethereum, Base, Polygon, Arbitrum with speed tiers and USD cost estimates.","description":"Price: 0.001 USDC per successful call on Base. Request without payment to receive an x402 v1 challenge. Upstream data is checked before payment is requested.","parameters":[],"responses":{"200":{"description":"Live data returned after payment","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid query parameters"},"402":{"description":"x402 v1 payment challenge, including price and Base USDC payment requirements","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"Live upstream data unavailable; no payment requested"}}}},"/api/token-scanner":{"get":{"operationId":"tokenScanner","summary":"GoPlus ERC-20 security flags and disclosed heuristic risk score; unavailable fields are null.","description":"Price: 0.003 USDC per successful call on Base. Request without payment to receive an x402 v1 challenge. Upstream data is checked before payment is requested.","parameters":[{"name":"token","in":"query","required":false,"schema":{"type":"string","default":"PEPE"}},{"name":"chain","in":"query","required":false,"schema":{"type":"string","default":"ethereum"}}],"responses":{"200":{"description":"Live data returned after payment","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid query parameters"},"402":{"description":"x402 v1 payment challenge, including price and Base USDC payment requirements","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"Live upstream data unavailable; no payment requested"}}}},"/api/dex-quotes":{"get":{"operationId":"dexQuotes","summary":"One live ParaSwap aggregate route quote; no independent DEX comparison.","description":"Price: 0.002 USDC per successful call on Base. Request without payment to receive an x402 v1 challenge. Upstream data is checked before payment is requested.","parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string","default":"ETH"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","default":"USDC"}},{"name":"amount","in":"query","required":false,"schema":{"type":"number","default":1}},{"name":"chain","in":"query","required":false,"schema":{"type":"string","default":"ethereum"}}],"responses":{"200":{"description":"Live data returned after payment","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid query parameters"},"402":{"description":"x402 v1 payment challenge, including price and Base USDC payment requirements","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"Live upstream data unavailable; no payment requested"}}}},"/api/yield-scanner":{"get":{"operationId":"yieldScanner","summary":"Live DefiLlama pool APYs and TVL, filterable by chain, asset, and TVL.","description":"Price: 0.005 USDC per successful call on Base. Request without payment to receive an x402 v1 challenge. Upstream data is checked before payment is requested.","parameters":[{"name":"chain","in":"query","required":false,"schema":{"type":"string","default":"all"}},{"name":"min_tvl","in":"query","required":false,"schema":{"type":"number","default":0}},{"name":"asset","in":"query","required":false,"schema":{"type":"string","default":"all"}},{"name":"limit","in":"query","required":false,"schema":{"type":"number","default":20}}],"responses":{"200":{"description":"Live data returned after payment","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid query parameters"},"402":{"description":"x402 v1 payment challenge, including price and Base USDC payment requirements","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"Live upstream data unavailable; no payment requested"}}}},"/api/wallet-profiler":{"get":{"operationId":"walletProfiler","summary":"Priced wallet balances from Blockscout or limited public RPC fallback; partial coverage disclosed.","description":"Price: 0.008 USDC per successful call on Base. Request without payment to receive an x402 v1 challenge. Upstream data is checked before payment is requested.","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string"}},{"name":"chain","in":"query","required":false,"schema":{"type":"string","default":"all"}}],"responses":{"200":{"description":"Live data returned after payment","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid query parameters"},"402":{"description":"x402 v1 payment challenge, including price and Base USDC payment requirements","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"Live upstream data unavailable; no payment requested"}}}}}}