{"name":"x402 Crypto Research Brief API","description":"Structured crypto/market research brief for any token: price, market cap, volume, 24h/7d/30d change, liquidity/venue concentration, DefiLlama TVL, on-chain holder & contract-risk notes (GoPlus), recent news headlines with sources, rule-based risk flags, and a deterministic summary. Free public data only; nulls when a source fails.","x402Version":2,"endpoints":[{"method":"GET","path":"/brief","url":"https://x402-brief-api.vercel.app/brief","example":"https://x402-brief-api.vercel.app/brief?asset=ETH","price":{"amount_usd":"0.10","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","decimals":6},"scheme":"exact","transfer_method":"EIP-3009 transferWithAuthorization","network":"eip155:8453","network_name":"Base mainnet","payTo":"0x4ca2874A162fCd2bf742bb4b8D672243e3E084c4","facilitator":"PayAI facilitator (https://facilitator.payai.network)","input_schema":{"type":"object","properties":{"asset":{"type":"string","description":"Ticker symbol (BTC, ETH, AERO), CoinGecko id (aerodrome-finance), or a Base/Ethereum token contract address (0x...)"}},"required":["asset"]},"output_example":{"asset":{"query":"aero","id":"aerodrome-finance","symbol":"AERO","name":"Aerodrome Finance"},"market":{"price_usd":0.666,"market_cap_usd":559000000,"volume_24h_usd":25500000,"change_24h_pct":-3.47,"change_7d_pct":-16.52},"liquidity":{"volume_to_mcap_ratio":0.0456,"top_venue_share_pct":16.6,"top_venues":[{"venue":"Coinbase Exchange","share_pct":16.6}]},"defillama":{"protocol":{"name":"Aero","tvl_usd":365198700}},"onchain":{"chain_id":8453,"holder_count":746229,"top10_holders_pct":62.1},"news":[{"title":"...","url":"https://...","source":"CoinDesk","published":"2026-10-26T04:37:02.000Z"}],"risks":[{"level":"medium","flag":"supply_overhang","detail":"..."}],"summary":"Aerodrome Finance (AERO) trades at $0.666 ...","generated_at":"2026-10-26T05:00:00.000Z","data_sources":[{"name":"CoinGecko","url":"https://www.coingecko.com/en/coins/aerodrome-finance"}]}},{"method":"GET","path":"/testnet/brief","url":"https://x402-brief-api.vercel.app/testnet/brief","example":"https://x402-brief-api.vercel.app/testnet/brief?asset=ETH","testnet":true,"price":{"amount_usd":"0.10","asset":"USDC (testnet)","asset_address":"0x036CbD53842c5426634e7929541eC2318f3dCF7e","decimals":6},"scheme":"exact","transfer_method":"EIP-3009 transferWithAuthorization","network":"eip155:84532","network_name":"Base Sepolia (testnet)","payTo":"0x51c1EFD2C28a2f81f51A8D9583016388E905AD60","facilitator":"public facilitator https://x402.org/facilitator (testnet)"}],"free_endpoints":["/","/.well-known/x402","/openapi.json","/health","/sample"],"data_sources":["CoinGecko free API","DefiLlama","GoPlus Security","Google News RSS","Cointelegraph RSS","Decrypt RSS","CoinDesk RSS"],"how_to_pay":"Call GET /brief?asset=... ; you'll get HTTP 402 with a PAYMENT-REQUIRED header (base64 JSON PaymentRequired v2). Sign an EIP-3009 authorization and retry with a PAYMENT-SIGNATURE header, e.g. using @x402/fetch or @x402/axios."}