{"uid":"cap_v6Z6PFJIfKlUPQwfLWxOO","slug":"x402-onchainexpat-com-8e392fd0","name":"x402.onchainexpat.com Crypto Price Feed","description":"Pay-per-request AI, crypto, proxy, and utility APIs using x402 protocol","url":"https://x402.onchainexpat.com/api/x402-crypto/price-feed","method":"POST","headers":{},"bodySchema":{"type":"object","required":["token"],"properties":{"token":{"type":"string","description":"Token symbol (ETH, BTC), name (ethereum), or contract address"},"include_history":{"type":"boolean","description":"Include 7-day price history (default: false)"}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"ath":{"type":"object","description":"All-time high price and date"},"atl":{"type":"object","description":"All-time low price and date"},"price":{"type":"object","description":"Current price in USD"},"token":{"type":"object","description":"Token id, symbol, name, image"},"market":{"type":"object","description":"Market cap, volume, supply data"},"changes":{"type":"object","description":"Price changes for 1h, 24h, 7d, 30d"}}},"success":{"type":"boolean"}}},"example":{"request":{"token":"BTC","include_history":false},"response":{"data":{"ath":{"date":"2025-10-06T18:57:42.558Z","price":126080,"change_percent":-49.35394},"atl":{"date":"2013-07-06T00:00:00.000Z","price":67.81,"change_percent":94068.16932},"price":{"btc":null,"eth":null,"usd":63854,"usd_formatted":"$63,854.00"},"token":{"id":"bitcoin","name":"Bitcoin","image":"https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400","symbol":"BTC"},"market":{"market_cap":1279990816450,"max_supply":21000000,"volume_24h":33086735306,"total_supply":20044290,"market_cap_rank":1,"circulating_supply":20044275,"fully_diluted_valuation":1279991774323},"changes":{"1h":{"percent":-0.5582732656595366,"direction":"down"},"7d":{"percent":1.90242481210321,"direction":"up"},"24h":{"usd":-2012.9500189134124,"percent":-3.05606,"direction":"down"},"30d":{"percent":-16.760577498136936,"direction":"down"}}},"cached":false,"success":true,"timestamp":"2026-06-18T04:43:34.570118+00:00"}},"exampleRequest":{"token":"BTC","include_history":false},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9jSdO6w_iKKELBpng2KLQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current price, market cap, 24h volume, ATH/ATL, and multi-timeframe price changes for a given cryptocurrency token","exampleAgentPrompt":"What's the current price of ETH right now, including its 24-hour price change, market cap, and trading volume?","exampleUseCases":[{"title":"Real-time portfolio performance tracking","prompt":"Check the current price and 24-hour change for Bitcoin and Ethereum so I can see how my portfolio is performing today."},{"title":"Investment decision research brief","prompt":"Show me the all-time high, all-time low, and current price for Solana along with its market cap rank and 7-day price movement."},{"title":"Market opportunity monitoring alert","prompt":"Get me the latest market cap, trading volume, and price changes across the last 30 days for Polygon so I can assess if it's a good buying opportunity right now."}],"resultDescription":"Returns a structured JSON object with: current price in USD (and optionally BTC/ETH), formatted price string, all-time high and low with dates and percent-from-ATH/ATL, market data (market cap, volume, supply figures, rank), price change direction and percentage for 1h/24h/7d/30d timeframes, token metadata (name, image, symbol, CoinGecko ID), and a timestamp indicating whether the result was cached.","failureModes":["Unknown or unsupported token symbol returns error","Payment failure or insufficient USDC balance blocks the request","Rate limiting if too many calls in quick succession","Stale/cached data if the market data provider is delayed","Malformed request body returns validation error"],"whenToPreferThis":"Use this endpoint when you need rich, multi-dimensional market data for a single cryptocurrency token in one call — including price, market cap, volume, supply, rank, ATH/ATL, and multi-timeframe changes. Prefer this over a simple price-only endpoint when downstream decisions depend on market context. It is distinct from the sibling /crypto/price endpoint and from fiat currency conversion.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:51:01.257Z","isFirstParty":false}