{"uid":"cap_qWGR51c19QReJHZ1OMJlb","slug":"carry-currency-converter-7e67e38f","name":"Carry Currency Converter","description":"Currency converter. Convert an amount between ~50 currencies at the official reference rate (Bank Al-Maghrib for MAD pairs, ECB otherwise, cross via EUR), with rate, date and source.","url":"https://carry.genexxis.com/convert?utm_source=zero.xyz","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"},"from":{"type":"string","description":"ISO 4217 code"},"amount":{"type":"string","description":"Positive amount, default 1"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"to":"MAD","date":"2026-10-23","from":"USD","rate":9.2041,"amount":1000,"method":"direct","result":9204.1,"source":"Bank Al-Maghrib reference rate"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bbWqmvp72QO0fKHV9sP7a","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts an amount between ~50 currencies at official reference rates (Bank Al-Maghrib for MAD pairs, ECB otherwise), returning the rate, date, source, and converted result.","exampleAgentPrompt":"Can you convert 1000 USD to MAD using the official Bank Al-Maghrib reference rate and tell me the rate and date it's from?","exampleUseCases":[{"title":"Invoice pricing in local currency","prompt":"I need to invoice a Moroccan client for $2500 worth of services — what's that in MAD at today's official rate?"},{"title":"Travel budget conversion","prompt":"I'm traveling from France to Morocco next week and want to bring 800 EUR in cash — how many Moroccan dirhams will that be at the official reference rate?"},{"title":"Cross-currency rate check","prompt":"What's the official exchange rate from Japanese yen to Moroccan dirham today, and what's the source of that rate?"}],"resultDescription":"A JSON object containing: the from and to currency codes, the numeric exchange rate, the converted result, the rate date, the rate source (e.g. 'Bank Al-Maghrib reference rate' or 'ECB'), and the conversion method (direct or cross via EUR).","failureModes":["Unsupported currency code returns an error — only ~50 currencies supported","Invalid ISO 4217 code in 'from' or 'to' parameter returns a 4xx error","Amount of zero or negative value may be rejected or return unexpected results","Rate may be from prior business day if central bank hasn't published today's rate yet","Network or upstream data source unavailability causes 5xx errors"],"whenToPreferThis":"Choose this endpoint when you need official central bank reference rates (not mid-market or broker rates), especially for Moroccan dirham (MAD) pairs which use Bank Al-Maghrib data. Prefer it over general FX APIs when regulatory or audit accuracy of the rate source matters, or when working with ~50 major/regional currencies at no meaningful latency cost.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T12:35:06.337Z","isFirstParty":false,"canonicalSlug":"carry-currency-converter-7e67e38f"}