{"uid":"cap_eSQSR0d01Dzb13EgNtpST","slug":"agent-time-place-fx-currency-conversion-23732598","name":"Agent Time & Place — FX Currency Conversion","description":"Geocoding, timezones, holidays, business days, sun times, FX and distances for AI agents. Deterministic, sub-cent, no API key: payment is authentication (x402).","url":"https://time-place.agent-utils.workers.dev/v1/convert","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","required":["from","to"],"properties":{"to":{"type":"string","description":"ISO 4217 code, or comma list for several targets"},"from":{"type":"string","description":"ISO 4217 code"},"amount":{"type":"number","default":1}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":"string"},"from":{"type":"string"},"amount":{"type":"number"},"source":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"to":{"type":"string"},"rate":{"type":"number"},"converted":{"type":"number"}}}}}}}}}},"responseSchema":{"type":"json","example":{"asOf":"2026-09-06T00:02:31.000Z","from":"USD","amount":100,"source":"open.er-api.com","results":[{"to":"EUR","rate":0.8604,"converted":86.04}]}},"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_Zi95UF8JkawbybENpNaIQ","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":"Converts an amount from one ISO 4217 currency to one or more target currencies using live exchange rates.","exampleAgentPrompt":"What's the current exchange rate from USD to EUR and JPY, and how much would 250 USD come out to in each?","exampleUseCases":[{"title":"Multi-currency invoice pricing","prompt":"I need to quote a client 1500 USD in both British pounds and Canadian dollars — what are the current converted amounts?"},{"title":"Travel budget estimation","prompt":"I'm budgeting a trip and want to know how much 2000 USD is worth in Thai baht and Vietnamese dong right now."},{"title":"E-commerce checkout FX display","prompt":"Show me the live exchange rate from EUR to USD, GBP, and AUD so I can display localized prices on my checkout page."}],"resultDescription":"Returns a JSON object with the source currency, the requested amount, the timestamp of the rates, the data source (open.er-api.com), and an array of results each containing the target currency code, the exchange rate, and the converted amount.","failureModes":["Invalid or unsupported ISO 4217 currency code returns an error","Missing required 'from' or 'to' query parameter returns a 400-level error","Payment not provided or insufficient causes a 402 Payment Required response","Rate data temporarily unavailable from upstream provider may cause a 503 or stale response"],"whenToPreferThis":"Choose this endpoint when you need deterministic, low-cost FX conversion without managing API keys — payment via x402 micropayment is authentication. Ideal for AI agents that need on-demand currency conversion as a utility call, supporting multiple target currencies in a single request. Prefer over free-tier FX APIs when you want no key management and sub-cent per-call pricing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:46:41.292Z","isFirstParty":false}