{"openapi":"3.1.0","info":{"title":"PARADIGMA Crypto Feed","version":"1.1.0","description":"Pay-per-call crypto data for AI agents via x402 (USDC on Base). Endpoints return 402 with PAYMENT-REQUIRED header; pay via x402 client and retry."},"servers":[{"url":"https://opportunity-api-production.up.railway.app"}],"paths":{"/api/opportunities":{"get":{"summary":"Live crypto earning opportunities: active Galxe quests/campaigns scored 0-100 by project size, reward and time window.","x-price-usd":0.01,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/trending":{"get":{"summary":"Trending crypto tokens right now (CoinGecko) with USD price and 24h change.","x-price-usd":0.005,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/yields":{"get":{"summary":"Top stablecoin yield pools (DeFiLlama): APY, TVL, chain, risk flags. TVL >= $10M, APY < 60%.","x-price-usd":0.01,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/fear-greed":{"get":{"summary":"Crypto Fear & Greed index: current value plus 7-day history.","x-price-usd":0.005,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/prices":{"get":{"summary":"Spot USD prices, 24h change, market cap for up to 25 CoinGecko coin ids. Query param: ids=bitcoin,ethereum,...","x-price-usd":0.005,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"ids","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9,_-]{1,400}$"},"description":"Comma-separated CoinGecko coin ids (max 25). Default: bitcoin,ethereum"}],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/chains":{"get":{"summary":"Top 30 blockchains ranked by DeFi TVL (DeFiLlama).","x-price-usd":0.01,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/score":{"get":{"summary":"Rule-based farming score 0-100 for any Galxe project with verdict. Query param: project (Galxe alias).","x-price-usd":0.02,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"project","in":"query","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,64}$"},"description":"Galxe project alias from app.galxe.com/<alias>"}],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/market-brief":{"get":{"summary":"Premium one-call market snapshot: sentiment + trending + yields + scored opportunities.","x-price-usd":0.05,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/token-safety":{"get":{"summary":"Token safety check (GoPlus): honeypot, taxes, mintable, blacklist — score 0-100 + verdict. Params: chain, address.","x-price-usd":0.02,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/new-pools":{"get":{"summary":"Newest DEX pools on a network (GeckoTerminal), liquidity-filtered. Params: network, min_reserve.","x-price-usd":0.01,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/trending-pools":{"get":{"summary":"Trending DEX pools right now (GeckoTerminal). Param: network.","x-price-usd":0.01,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/funding-rates":{"get":{"summary":"Perp funding rates (Hyperliquid): top extremes or requested symbols, hourly + annualized %. Param: symbols.","x-price-usd":0.005,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/gas":{"get":{"summary":"Gas prices in gwei: Ethereum, Base, Arbitrum, Optimism, Polygon in one call.","x-price-usd":0.005,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/stable-pegs":{"get":{"summary":"Stablecoin peg monitor with DEPEG WARNING flags: USDT, USDC, DAI, USDe, FDUSD, PYUSD, FRAX, TUSD.","x-price-usd":0.005,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/news":{"get":{"summary":"Latest crypto headlines from CoinTelegraph, CoinDesk, The Block — one normalized feed.","x-price-usd":0.01,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/dex-volumes":{"get":{"summary":"Top-20 DEXes by 24h volume with 1d/7d change (DeFiLlama).","x-price-usd":0.01,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/extract":{"get":{"summary":"Any public URL to clean agent-ready markdown (Readability). Param: url.","x-price-usd":0.005,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/token-brief":{"get":{"summary":"Premium one-call token due diligence: safety + market data + TRADEABLE/DO NOT TRADE verdict. Params: chain, address.","x-price-usd":0.05,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/search-pools":{"get":{"summary":"Resolve any token name, symbol or address to its DEX pools (GeckoTerminal). Params: query, network (optional).","x-price-usd":0.005,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/token-holders":{"get":{"summary":"Holder distribution: top-10 holders, concentration, creator %, LP lock % (GoPlus). Params: chain, address.","x-price-usd":0.01,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/pool-ohlcv":{"get":{"summary":"OHLCV candles for a DEX pool (GeckoTerminal). Params: network, pool, timeframe, limit.","x-price-usd":0.01,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/pool-trades":{"get":{"summary":"Recent swaps for a DEX pool with buy/sell split (GeckoTerminal). Params: network, pool, min_usd.","x-price-usd":0.01,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/orderbook":{"get":{"summary":"Live perp orderbook depth, spread, imbalance (Hyperliquid). Param: coin.","x-price-usd":0.01,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/oi-leaders":{"get":{"summary":"Perp open-interest/volume leaderboard with funding (Hyperliquid). Param: sort.","x-price-usd":0.01,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/fees-leaders":{"get":{"summary":"Top-20 protocols by 24h fees and revenue (DeFiLlama).","x-price-usd":0.01,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}},"/api/protocol-tvl":{"get":{"summary":"TVL of any DeFi protocol by chain (DeFiLlama). Param: protocol (slug).","x-price-usd":0.01,"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"parameters":[],"responses":{"200":{"description":"JSON data"},"402":{"description":"Payment required (x402: PAYMENT-REQUIRED header with USDC requirements)"}}}}}}