{"uid":"cap_IzhTeeyGfZJ9BGb8cBO2J","slug":"agent402-exchange-rates-btc-based-multi-asset-rate-lookup-cf5a0e59","name":"Agent402 Exchange Rates – BTC-based multi-asset rate lookup","description":"BTC-denominated exchange rates for ~60 units: crypto (ETH, LTC, BNB, SOL, ...), fiat (USD, EUR, JPY, ...) and commodities (gold, silver ounces), each as units per 1 BTC with name and type. Optional `currencies` filter (comma-separated unit codes) and `type` filter (crypto, fiat, commodity). One call gives a consistent cross-rate table: BTC in gold ounces, ETH/BTC, USD/JPY via BTC. Cached in-process for 60 seconds.","url":"https://agent402.tools/api/exchange-rates","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"type":{"type":"string","description":"Optional filter: crypto, fiat or commodity."},"currencies":{"type":"string","description":"Optional comma-separated unit codes to keep (usd, eur, eth, xau, ...). Default: all."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["source","fetchedAt","cached","base","count","rates"],"properties":{"base":{"type":"string"},"count":{"type":"integer"},"rates":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"perBtc":{"type":"number"}}}},"cached":{"type":"boolean"},"source":{"type":"string"},"fetchedAt":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"base":"BTC","count":4,"rates":[{"code":"usd","name":"US Dollar","type":"fiat","unit":"$","perBtc":77018},{"code":"eur","name":"Euro","type":"fiat","unit":"€","perBtc":65600.2},{"code":"eth","name":"Ether","type":"crypto","unit":"ETH","perBtc":31.813},{"code":"xau","name":"Gold - Troy Ounce","type":"commodity","unit":"XAU","perBtc":22.91}],"cached":false,"source":"coingecko","fetchedAt":"2026-08-22T13:20:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8wJ5LYnVTd7LOi1skc2q0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time Bitcoin-denominated exchange rates for fiat currencies, cryptocurrencies, and commodities, filterable by type or specific currency codes.","exampleAgentPrompt":"Can you pull the latest Bitcoin exchange rates for USD, EUR, ETH, and gold right now — just those four currencies?","exampleUseCases":[{"title":"Portfolio valuation in multiple currencies","prompt":"I need to know what 0.5 BTC is worth right now in USD, EUR, and gold — can you fetch the live exchange rates for all three?"},{"title":"Crypto-to-fiat rate monitoring for trading bot","prompt":"Grab the current BTC-to-fiat exchange rates for usd and eur only — I want to check if the spread has shifted since last hour."},{"title":"Commodity price comparison for research report","prompt":"What's Bitcoin worth relative to gold and other commodities right now? Pull just the commodity exchange rates for me."}],"resultDescription":"A JSON object with base currency (BTC), a list of rate objects each containing code, name, type, unit symbol, and per-BTC rate, plus metadata fields: total count, whether the result was cached, the data source (e.g. coingecko), and the fetch timestamp in ISO 8601 format.","failureModes":["Invalid type filter value returns an error or empty rates array","Unknown currency code in 'currencies' param may be silently ignored or return empty results","Upstream CoinGecko outage may cause stale or failed response","Malformed comma-separated currencies list may result in parse errors","Rate limiting or payment failure returns 402 with payment required details"],"whenToPreferThis":"Choose this endpoint when you need real-time, BTC-denominated exchange rates across a broad mix of fiat currencies, cryptocurrencies, and commodities in a single call. It is ideal for agents that price transactions in Bitcoin, build multi-asset dashboards, or need gold/commodity rates alongside crypto rates. Prefer this over generic FX APIs when BTC is the base unit, or when you want commodity and crypto rates in the same response. It requires no API key — payment is per-call via x402/USDC wallet.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:57:25.000Z","isFirstParty":false}