{"uid":"cap_1oZ7sKRrJqOUzDJ0lKanM","slug":"hermes-data-api-forex-rate-lookup-946ea9a3","name":"Hermes Data API – Forex Rate Lookup","description":"Pay-per-call data API: crypto prices (CoinGecko), China A-share quotes (Sina), weather (Open-Meteo), forex rates, and Ethereum gas fees. Payments via x402 protocol, USDC on Base.","url":"https://x402-api-blond.vercel.app/forex/rate","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","toolName","inputSchema"],"properties":{"type":{"type":"string","const":"mcp"},"example":{"type":"object"},"toolName":{"type":"string"},"description":{"type":"string"},"inputSchema":{"type":"object"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"to":"CNY","ts":1750000000000,"from":"USD","rate":7.25,"source":"exchangerate-api"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6dcH-rGE8UBQSiQLLw8B-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current exchange rate between two currency pairs, sourced from exchangerate-api, for $0.01 USDC per call via x402 protocol.","exampleAgentPrompt":"What's the current exchange rate from USD to CNY? I need the live forex rate right now.","exampleUseCases":[{"title":"Invoice currency conversion for freelancer","prompt":"I just sent an invoice in EUR but my client pays in USD — what's the current EUR to USD exchange rate so I can convert the amount accurately?"},{"title":"Travel budget planning","prompt":"I'm heading to Japan next week. What's the live forex rate from USD to JPY so I can figure out how much yen I'll get for $500?"},{"title":"Crypto-to-fiat reporting","prompt":"I need to mark my books in GBP but my revenue is in AUD — can you pull the current AUD to GBP exchange rate for me?"}],"resultDescription":"Returns a JSON object containing the source currency (from), target currency (to), the live exchange rate (rate), a Unix timestamp (ts) of when the rate was fetched, and the data source name (e.g. 'exchangerate-api').","failureModes":["Unsupported or invalid currency codes return an error","Payment failure via x402 protocol (insufficient USDC balance or incorrect payment header) results in 402 response","Upstream exchangerate-api outage may cause delayed or unavailable rates","Malformed request body (missing 'from' or 'to' fields) returns a validation error"],"whenToPreferThis":"Choose this endpoint when you need a quick, low-cost ($0.01 USDC) spot forex rate lookup for any currency pair via a pay-per-call model with no subscription required. It is especially useful for AI agents operating in crypto-native environments already using the x402 payment protocol on Base, and when you also need sibling data (crypto prices, weather, A-share quotes) from the same Hermes API without managing multiple API keys.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:37:48.423Z","isFirstParty":false}