{"_id":"@allratestoday/cbuae-exchange-rate","_rev":"7-34bb4ee9a4378fc41f2990c7997c5292","name":"@allratestoday/cbuae-exchange-rate","dist-tags":{"latest":"1.3.4"},"versions":{"1.2.2":{"name":"@allratestoday/cbuae-exchange-rate","version":"1.2.2","keywords":["cbuae","central","bank","of","the","uae","exchange-rate","exchange-rates","currency","forex","fx","aed","central-bank","official-rates","united-arab-emirates","api","typescript"],"author":{"url":"https://allratestoday.com","name":"AllRatesToday","email":"hello@allratestoday.com"},"license":"MIT","_id":"@allratestoday/cbuae-exchange-rate@1.2.2","maintainers":[{"name":"chathurangac8","email":"basnayakac8@gmail.com"}],"homepage":"https://allratestoday.com/central-bank-rates-api/cbuae/","bugs":{"url":"https://github.com/AllRates-Today/cbuae-exchange-rate/issues"},"dist":{"shasum":"aff6df4abea522b9914c7b99d329910551e3177a","tarball":"https://registry.npmjs.org/@allratestoday/cbuae-exchange-rate/-/cbuae-exchange-rate-1.2.2.tgz","fileCount":6,"integrity":"sha512-Z6b0M9/3ZIFaPEXgSMl65LFCkAQbkF6bqsmoGt3pS/YD1sqCjpShOQPWE4WZR7d1p184CUOeVIyQ95nwte3cGw==","signatures":[{"sig":"MEUCIQCLVyzqeVnKh+2LkaLtIGbxsWgsOuPZNdmPXwitQP4xIQIgBatAweCmq5ELNI4IPBYDeTkEicPoSMIT9nRZeoBAnig=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":17618},"main":"./index.cjs","type":"module","types":"./index.d.ts","module":"./index.mjs","engines":{"node":">=18"},"exports":{".":{"types":"./index.d.ts","import":"./index.mjs","require":"./index.cjs"}},"gitHead":"7628917ee928d804bc89fa36eaf56610f9e1de5f","_npmUser":{"name":"chathurangac8","email":"basnayakac8@gmail.com"},"repository":{"url":"git+https://github.com/AllRates-Today/cbuae-exchange-rate.git","type":"git"},"_npmVersion":"9.2.0","description":"Official Central Bank of the UAE (United Arab Emirates) daily exchange rates — 75 currencies vs AED, history since 2019. Zero-dependency Node.js/TypeScript client.","directories":{},"sideEffects":false,"_nodeVersion":"22.22.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cbuae-exchange-rate_1.2.2_1786524393844_0.9394227785025033","host":"s3://npm-registry-packages-npm-production"}},"1.2.3":{"name":"@allratestoday/cbuae-exchange-rate","version":"1.2.3","keywords":["cbuae","central","bank","of","the","uae","exchange-rate","exchange-rates","currency","forex","fx","aed","central-bank","official-rates","united-arab-emirates","api","typescript"],"author":{"url":"https://allratestoday.com","name":"AllRatesToday","email":"hello@allratestoday.com"},"license":"MIT","_id":"@allratestoday/cbuae-exchange-rate@1.2.3","maintainers":[{"name":"chathurangac8","email":"basnayakac8@gmail.com"}],"homepage":"https://allratestoday.com/central-bank-rates-api/cbuae/","bugs":{"url":"https://github.com/AllRates-Today/cbuae-exchange-rate/issues"},"dist":{"shasum":"06ba27027226402e5a175a20a1ad1d6a2a9ac0d1","tarball":"https://registry.npmjs.org/@allratestoday/cbuae-exchange-rate/-/cbuae-exchange-rate-1.2.3.tgz","fileCount":6,"integrity":"sha512-53AcEsgENpOeznnIHfE4RqkaYGbhk9AKNaByiCGitfz3LSMSl3oOmbazGklbT2Xs+6axqBLRJFT8PuQnRKWCaQ==","signatures":[{"sig":"MEUCIQCZVjLBehngXyht9rvjSvXuMq+/A2GwiJg6ixzACJ5+2gIgPMIMmNC6aPUSkNFLpDN/TeaLhgMnLc1zybtvFtVXnvM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18309},"main":"./index.cjs","type":"module","types":"./index.d.ts","module":"./index.mjs","engines":{"node":">=18"},"exports":{".":{"types":"./index.d.ts","import":"./index.mjs","require":"./index.cjs"}},"gitHead":"86f5e662605241f5a3f10be7654381a0192651db","_npmUser":{"name":"chathurangac8","email":"basnayakac8@gmail.com"},"repository":{"url":"git+https://github.com/AllRates-Today/cbuae-exchange-rate.git","type":"git"},"_npmVersion":"9.2.0","description":"Official Central Bank of the UAE (United Arab Emirates) daily exchange rates — 75 currencies vs AED, history since 2019. Zero-dependency Node.js/TypeScript client.","directories":{},"sideEffects":false,"_nodeVersion":"22.22.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cbuae-exchange-rate_1.2.3_1786608502933_0.0757875684833762","host":"s3://npm-registry-packages-npm-production"}},"1.2.7":{"name":"@allratestoday/cbuae-exchange-rate","version":"1.2.7","keywords":["cbuae","central","bank","of","the","uae","exchange-rate","exchange-rates","currency","forex","fx","aed","central-bank","official-rates","united-arab-emirates","api","typescript"],"author":{"url":"https://allratestoday.com","name":"AllRatesToday","email":"hello@allratestoday.com"},"license":"MIT","_id":"@allratestoday/cbuae-exchange-rate@1.2.7","maintainers":[{"name":"chathurangac8","email":"basnayakac8@gmail.com"}],"homepage":"https://allratestoday.com/central-bank-rates-api/cbuae/","bugs":{"url":"https://github.com/AllRates-Today/cbuae-exchange-rate/issues"},"dist":{"shasum":"12db31033e58fc40582b39121cd94a0bd46d80d2","tarball":"https://registry.npmjs.org/@allratestoday/cbuae-exchange-rate/-/cbuae-exchange-rate-1.2.7.tgz","fileCount":6,"integrity":"sha512-tIxECFn1GsuZzJ/YdNDlQGp7oWGLttpMpEDv6g6R1WO/86HqiAcDFgj6dBEWG0HEvab41FpoBMyeT/zCHidaGQ==","signatures":[{"sig":"MEQCIHJoBlILg0Z7D2znZ71CLw69kytFzHq8MnrDTQiyKocSAiAI2A+P5F2o87Kd7y0LW8DZi9e/GpWShbSIUx2Xitqdow==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18309},"main":"./index.cjs","type":"module","types":"./index.d.ts","module":"./index.mjs","engines":{"node":">=18"},"exports":{".":{"types":"./index.d.ts","import":"./index.mjs","require":"./index.cjs"}},"gitHead":"0bdc92d850f026c2ce3ab23033ab006807b0ecfc","_npmUser":{"name":"chathurangac8","email":"basnayakac8@gmail.com"},"repository":{"url":"git+https://github.com/AllRates-Today/cbuae-exchange-rate.git","type":"git"},"_npmVersion":"9.2.0","description":"Official Central Bank of the UAE (United Arab Emirates) daily exchange rates — 75 currencies vs AED, history since 2019. Zero-dependency Node.js/TypeScript client.","directories":{},"sideEffects":false,"_nodeVersion":"22.22.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cbuae-exchange-rate_1.2.7_1787566994984_0.6423731859295241","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@allratestoday/cbuae-exchange-rate","version":"1.3.0","keywords":["cbuae","central","bank","of","the","uae","exchange-rate","exchange-rates","currency","forex","fx","aed","central-bank","official-rates","united-arab-emirates","api","typescript"],"author":{"url":"https://allratestoday.com","name":"AllRatesToday","email":"hello@allratestoday.com"},"license":"MIT","_id":"@allratestoday/cbuae-exchange-rate@1.3.0","maintainers":[{"name":"chathurangac8","email":"basnayakac8@gmail.com"}],"homepage":"https://allratestoday.com/central-bank-rates-api/cbuae/","bugs":{"url":"https://github.com/AllRates-Today/cbuae-exchange-rate/issues"},"dist":{"shasum":"8c17d344c528582db1cc3ce119f3a6d9d094c970","tarball":"https://registry.npmjs.org/@allratestoday/cbuae-exchange-rate/-/cbuae-exchange-rate-1.3.0.tgz","fileCount":6,"integrity":"sha512-N/a51Ne2lQdXNctE+4NeoL0fbr5kFbgF4+QQ5yE0/jUOpiK0OEAPXqi1q4WbSDeTenM6+BLannHZkYIzWDvqLg==","signatures":[{"sig":"MEUCIQCe/CSq9FO4OuRN2qRaVufKaMeKX/055jA4G17SXgwQVwIgeMTLcEU+Y8Pc82MFD2S0DBINCkT+WGFCaXQiMjvSYWY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18861},"main":"./index.cjs","type":"module","types":"./index.d.ts","module":"./index.mjs","engines":{"node":">=18"},"exports":{".":{"types":"./index.d.ts","import":"./index.mjs","require":"./index.cjs"}},"gitHead":"ec4d6bcf08cf485c7ab237f12d27e3d5a0f97e14","_npmUser":{"name":"chathurangac8","email":"basnayakac8@gmail.com"},"repository":{"url":"git+https://github.com/AllRates-Today/cbuae-exchange-rate.git","type":"git"},"_npmVersion":"9.2.0","description":"Official Central Bank of the UAE (United Arab Emirates) daily exchange rates — 75 currencies vs AED, history since 2019. Zero-dependency Node.js/TypeScript client.","directories":{},"sideEffects":false,"_nodeVersion":"22.22.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cbuae-exchange-rate_1.3.0_1788977037601_0.23212709356430228","host":"s3://npm-registry-packages-npm-production"}},"1.3.1":{"name":"@allratestoday/cbuae-exchange-rate","version":"1.3.1","keywords":["cbuae","central","bank","of","the","uae","exchange-rate","exchange-rates","currency","forex","fx","aed","central-bank","official-rates","united-arab-emirates","api","typescript"],"author":{"url":"https://allratestoday.com","name":"AllRatesToday","email":"hello@allratestoday.com"},"license":"MIT","_id":"@allratestoday/cbuae-exchange-rate@1.3.1","maintainers":[{"name":"chathurangac8","email":"basnayakac8@gmail.com"}],"homepage":"https://allratestoday.com/central-bank-rates-api/cbuae/","bugs":{"url":"https://github.com/AllRates-Today/cbuae-exchange-rate/issues"},"dist":{"shasum":"85c5d4ffb2714346d5f28309c0a75335625bed7a","tarball":"https://registry.npmjs.org/@allratestoday/cbuae-exchange-rate/-/cbuae-exchange-rate-1.3.1.tgz","fileCount":6,"integrity":"sha512-LEjEagMY0e2GdXk9hqL6q5qjtefZ/MJdATnnUH5LhWw2VUvUTi1BbLgrRgxkVtvSpFHmTlUTwHQR7Os2XDVgXw==","signatures":[{"sig":"MEUCIEAGeUqZLhHIsF6AiB3DJr60jVtVWSNpiwRMmGgiB89yAiEAwyD4v23QpEEAIEXp148XZBkmScUdM+akIjvBzm+pEzE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDVjQsnCDrpfcRpRd7mi2bSqqkKYqF5rC3v/toCQoktZAIhAOlnSQHzwdXsqNkJH70sjDe4wzNSR8xgL+eVwykwxHN2","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22669},"main":"./index.cjs","type":"module","types":"./index.d.ts","module":"./index.mjs","engines":{"node":">=18"},"exports":{".":{"types":"./index.d.ts","import":"./index.mjs","require":"./index.cjs"}},"gitHead":"fc26fa33ba7dd14ed15e95764a0cdb2b1355358f","_npmUser":{"name":"chathurangac8","email":"basnayakac8@gmail.com"},"repository":{"url":"git+https://github.com/AllRates-Today/cbuae-exchange-rate.git","type":"git"},"_npmVersion":"9.2.0","description":"Official Central Bank of the UAE (United Arab Emirates) daily exchange rates — 75 currencies vs AED, history since 2019. Zero-dependency Node.js/TypeScript client.","directories":{},"sideEffects":false,"_nodeVersion":"22.22.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cbuae-exchange-rate_1.3.1_1789650188422_0.963383265309683","host":"s3://npm-registry-packages-npm-production"}},"1.3.3":{"name":"@allratestoday/cbuae-exchange-rate","version":"1.3.3","keywords":["cbuae","central","bank","of","the","uae","exchange-rate","exchange-rates","currency","forex","fx","aed","central-bank","official-rates","united-arab-emirates","api","typescript"],"author":{"url":"https://allratestoday.com","name":"AllRatesToday","email":"hello@allratestoday.com"},"license":"MIT","_id":"@allratestoday/cbuae-exchange-rate@1.3.3","maintainers":[{"name":"chathurangac8","email":"basnayakac8@gmail.com"}],"homepage":"https://allratestoday.com/central-bank-rates-api/cbuae/","bugs":{"url":"https://github.com/AllRates-Today/cbuae-exchange-rate/issues"},"dist":{"shasum":"3c8e2cbe677c5ee4dd1581d6536e76963755bcbb","tarball":"https://registry.npmjs.org/@allratestoday/cbuae-exchange-rate/-/cbuae-exchange-rate-1.3.3.tgz","fileCount":6,"integrity":"sha512-+BmbmkL+FA7l0lzrirK6kX11JFoQ08SjGIVj1WRShFbcBMK1aKAL8sBo3NuhJ/vJihLVX73xgEgQvoFYzkOQJQ==","signatures":[{"sig":"MEUCIQDpcwj/cqy9bwToovaJLouZzssoZ5v3T8NOQIMg4El5OwIgan63086L5Tgvco6HfZlkWaQ4ATE6jWdOtDKvhNd3vXM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCID2UzCe5ZEpEXOiOvahJhuniJSu8fTR4OviXKdGZ15A/AiBY2plPMaH2N9IAm6MpE2pC+X2o5svg8e9Gvk5PRUXrtA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22666},"main":"./index.cjs","type":"module","types":"./index.d.ts","module":"./index.mjs","engines":{"node":">=18"},"exports":{".":{"types":"./index.d.ts","import":"./index.mjs","require":"./index.cjs"}},"gitHead":"ca0b6b268a0b3c562dedb06b2ec12ac8815a6a05","_npmUser":{"name":"chathurangac8","email":"basnayakac8@gmail.com"},"repository":{"url":"git+https://github.com/AllRates-Today/cbuae-exchange-rate.git","type":"git"},"_npmVersion":"9.2.0","description":"Official Central Bank of the UAE (United Arab Emirates) daily exchange rates — 75 currencies vs AED, history since 2019. Zero-dependency Node.js/TypeScript client.","directories":{},"sideEffects":false,"_nodeVersion":"22.22.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cbuae-exchange-rate_1.3.3_1790770313775_0.9087457667207022","host":"s3://npm-registry-packages-npm-production"}},"1.3.4":{"_id":"@allratestoday/cbuae-exchange-rate@1.3.4","bugs":{"url":"https://github.com/AllRates-Today/cbuae-exchange-rate/issues"},"dist":{"shasum":"07154c0f162851ccc697e9040e9aa7977a508fdf","tarball":"https://registry.npmjs.org/@allratestoday/cbuae-exchange-rate/-/cbuae-exchange-rate-1.3.4.tgz","fileCount":6,"integrity":"sha512-HxvtSsinfuKepNiIt9Ck7uMCEiMqtsROWmYCDc7vmcZBnZCLu/uShL1ORnlVI2MH5qokl5ORHUXxhwn9WG4zOw==","signatures":[{"sig":"MEUCICxkKHOjh7AqlP2ABqPwtu3hY56uCCbQKZy4OT9KsJnlAiEAh/whbNyv6vfJ1EXJPUADYiRM5KWyEzhb84FqtV8s/Cs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICF/HJ4xAwEgpdp+Bq+VlPCvY5M8lYjZNOvAAxQGKXWkAiBUeFp4im63PjkFWXMOBHkPB34nx9+6uo4FmoOhZXBu3A=="}],"unpackedSize":23067},"main":"./index.cjs","name":"@allratestoday/cbuae-exchange-rate","type":"module","types":"./index.d.ts","author":{"url":"https://allratestoday.com","name":"AllRatesToday","email":"hello@allratestoday.com"},"module":"./index.mjs","engines":{"node":">=18"},"exports":{".":{"types":"./index.d.ts","import":"./index.mjs","require":"./index.cjs"}},"gitHead":"79b405ca4251d0e8c85b00c9f6c63206e5e3dab3","license":"MIT","version":"1.3.4","_npmUser":{"name":"chathurangac8","email":"basnayakac8@gmail.com"},"homepage":"https://allratestoday.com/central-bank-rates-api/cbuae/","keywords":["cbuae","central","bank","of","the","uae","exchange-rate","exchange-rates","currency","forex","fx","aed","central-bank","official-rates","united-arab-emirates","api","typescript"],"repository":{"url":"git+https://github.com/AllRates-Today/cbuae-exchange-rate.git","type":"git"},"_npmVersion":"9.2.0","description":"Official Central Bank of the UAE (United Arab Emirates) daily exchange rates — 75 currencies vs AED, history since 2019. Zero-dependency Node.js/TypeScript client.","directories":{},"maintainers":[{"name":"chathurangac8","email":"basnayakac8@gmail.com"}],"sideEffects":false,"_nodeVersion":"22.22.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cbuae-exchange-rate_1.3.4_1790851365471_0.588235636668015"}}},"time":{"created":"2026-08-12T08:46:33.547Z","modified":"2026-10-01T10:42:45.752Z","1.2.2":"2026-08-12T08:46:33.991Z","1.2.3":"2026-08-13T08:08:23.080Z","1.2.7":"2026-08-24T10:23:15.119Z","1.3.0":"2026-09-09T18:03:57.731Z","1.3.1":"2026-09-17T13:03:08.520Z","1.3.3":"2026-09-30T12:11:53.887Z","1.3.4":"2026-10-01T10:42:45.567Z"},"bugs":{"url":"https://github.com/AllRates-Today/cbuae-exchange-rate/issues"},"author":{"url":"https://allratestoday.com","name":"AllRatesToday","email":"hello@allratestoday.com"},"license":"MIT","homepage":"https://allratestoday.com/central-bank-rates-api/cbuae/","keywords":["cbuae","central","bank","of","the","uae","exchange-rate","exchange-rates","currency","forex","fx","aed","central-bank","official-rates","united-arab-emirates","api","typescript"],"repository":{"url":"git+https://github.com/AllRates-Today/cbuae-exchange-rate.git","type":"git"},"description":"Official Central Bank of the UAE (United Arab Emirates) daily exchange rates — 75 currencies vs AED, history since 2019. Zero-dependency Node.js/TypeScript client.","maintainers":[{"name":"chathurangac8","email":"basnayakac8@gmail.com"}],"readme":"# Central Bank of the UAE Exchange Rates API — cbuae-exchange-rate\n\n[![npm version](https://img.shields.io/npm/v/@allratestoday%2Fcbuae-exchange-rate.svg)](https://www.npmjs.com/package/@allratestoday/cbuae-exchange-rate)\n[![license](https://img.shields.io/npm/l/@allratestoday%2Fcbuae-exchange-rate.svg)](https://github.com/AllRates-Today/cbuae-exchange-rate/blob/main/LICENSE)\n[![zero dependencies](https://img.shields.io/badge/dependencies-0-brightgreen.svg)](https://www.npmjs.com/package/@allratestoday/cbuae-exchange-rate)\n[![TypeScript](https://img.shields.io/badge/TypeScript-types%20included-3178C6.svg)](https://www.typescriptlang.org/)\n\n**Official Central Bank of the UAE (the United Arab Emirates) daily exchange rates for Node.js and TypeScript. The published central bank rates behind tax filings, customs valuations, audits, and compliant invoicing — not market estimates, but the numbers Central Bank of the UAE itself prints, every business day.**\n\n## 🚀 Why this client?\n\n- 🏛️ **Official published rates** — Central Bank of the UAE's own table, with the publisher's own `rate_date` on every response\n- 📅 **History back to 2019** — point-in-time tables and daily series for any past date\n- 🔀 **Published vs derived, always flagged** — computed inverse/cross pairs carry `derived: true`, never mixed with official prints\n- ⚡ **Zero dependencies** — pure ESM + CJS over global `fetch`; Node 18+, Bun, Deno, and edge runtimes\n- 🔷 **Type-safe** — full TypeScript definitions shipped with the package\n- 🧾 **Compliance-grade metadata** — `rate_type`, publication date, and source disclaimer on every response\n\n> **Official rate, not mid-market:** every value here is a number Central Bank of the UAE itself published, fixed once printed and carrying the central bank's own `rate_date` — what filings and audits require. Need the live mid-market rate for pricing or display instead? Use the [mid-market API](https://allratestoday.com/docs/) or [`@allratestoday/sdk`](https://www.npmjs.com/package/@allratestoday/sdk). The two can diverge by several percent.\n\n## ⚡ Try it without a key\n\nThe latest Central Bank of the UAE table is also served keyless, CORS-open and edge-cached, for evaluation, embeds and AI agents:\n\n```bash\ncurl \"https://allratestoday.com/api/open/central-bank/cbuae?source=USD&target=AED\"\n```\n\n```js\nconst r = await fetch('https://allratestoday.com/api/open/central-bank/cbuae').then((x) => x.json());\nconsole.log(r.rate_date, r.rates.length); // the central bank's latest published table, no key\n```\n\nThe open endpoint serves the *latest* table only and asks for a visible attribution link. The client below uses the keyed API, which adds point-in-time tables, history, and CSV/XML/Excel output.\n\n## 🔑 Get your API key\n\nGet a free API key at [allratestoday.com/register](https://allratestoday.com/register) — no credit card required. Latest rates are on every plan, including free.\n\n## 📦 Installation\n\n```bash\nnpm install @allratestoday/cbuae-exchange-rate\n```\n\n```bash\nyarn add @allratestoday/cbuae-exchange-rate\n```\n\n```bash\npnpm add @allratestoday/cbuae-exchange-rate\n```\n\nRequires Node 18+ (global `fetch`); also runs on Bun, Deno and edge runtimes. Scoped mirror of [`cbuae-exchange-rate`](https://www.npmjs.com/package/cbuae-exchange-rate) — same code, same versions.\n\n## 🏁 Quick start\n\n```js\nimport { getRate } from '@allratestoday/cbuae-exchange-rate';\n\nconst pair = await getRate('USD', 'AED', { apiKey: 'art_live_...' });\nconsole.log(pair.rate, pair.rate_date); // the official Central Bank of the UAE rate, on the central bank's own date\n```\n\n## 📚 API reference\n\n- [Latest pair rate](#latest-pair-rate) — one pair from the latest published table\n- [Full published table](#full-published-table) — everything the central bank printed, in one call\n- [Table for a date](#table-for-a-date) — the official table for an invoice or filing date\n- [Daily time series](#daily-time-series) — one pair across a date range\n\n---\n\n### Latest pair rate\n\nFree plan and up. Pairs the central bank does not print directly are resolved from its table and flagged (see *Published vs derived rates* below).\n\n```js\nconst pair = await getRate('USD', 'AED', { apiKey: 'art_live_...' });\n```\n\n**Response:**\n\n```javascript\n{\n  bank: 'cbuae',\n  name: 'Central Bank of the UAE',\n  rate_date: '2026-09-25',   // Central Bank of the UAE's own publication date\n  source: 'USD',\n  target: 'AED',\n  rate: 3.6725,\n  rate_type: 'reference',\n  derived: false,\n  method: 'published',\n  disclaimer: 'Official rates as published by the named central bank. On weekends/holidays the most recent published rate_date is returned.'\n}\n```\n\n### Full published table\n\nFree plan and up. The complete table for the latest publication date.\n\n```js\nimport { getLatestRates } from '@allratestoday/cbuae-exchange-rate';\n\nconst table = await getLatestRates({ apiKey: 'art_live_...' });\nconsole.log(table.rate_date, table.rates.length);\n```\n\n**Response:**\n\n```javascript\n{\n  bank: 'cbuae',\n  name: 'Central Bank of the UAE',\n  rate_date: '2026-09-25',\n  rates: [\n    { \"base\": \"USD\", \"quote\": \"AED\", \"type\": \"reference\", \"value\": 3.6725 },\n    // … the rest of the published table (75 currencies vs AED)\n  ],\n  disclaimer: '…'\n}\n```\n\n### Table for a date\n\nPaid plans. The official table for any date since 2019 — weekends and holidays return the most recent published date, flagged via `published_on_requested_date`, which is exactly the in-force rate a filing needs.\n\n```js\nimport { getRatesForDate } from '@allratestoday/cbuae-exchange-rate';\n\nconst day = await getRatesForDate('2026-06-30', { apiKey: 'art_live_...' });\n// Optionally narrow to one pair:\nconst one = await getRatesForDate('2026-06-30', { apiKey: 'art_live_...', source: 'USD', target: 'AED' });\n```\n\n**Response:**\n\n```javascript\n{\n  bank: 'cbuae',\n  requested_date: '2026-06-30',\n  rate_date: '2026-06-30',                // the date actually published\n  published_on_requested_date: true,      // false when a weekend/holiday fell back\n  rates: [ /* the full table for that date */ ],\n  disclaimer: '…'\n}\n```\n\n### Daily time series\n\nPaid plans. One resolved rate per publication date — ready for charting, revaluation runs, or audit workpapers.\n\n```js\nimport { getHistory } from '@allratestoday/cbuae-exchange-rate';\n\nconst series = await getHistory(\n  { source: 'USD', target: 'AED', from: '2026-01-01', to: '2026-09-25' },\n  { apiKey: 'art_live_...' }\n);\n```\n\n**Response:**\n\n```javascript\n{\n  bank: 'cbuae',\n  source: 'USD',\n  target: 'AED',\n  from: '2026-01-01',\n  to: '2026-09-25',\n  count: 152,\n  rates: [\n    // one entry per publication date\n    { date: '2026-09-25', rate: 3.6725, rate_type: 'reference', derived: false, method: 'published' },\n    // …\n  ],\n  disclaimer: '…'\n}\n```\n\nPass `{ symbol: 'USD' }` instead of `source`/`target` to get the raw published rows for one currency (all rate types, no pair resolution).\n\n---\n\n## 🗺️ Currencies covered\n\nCentral Bank of the UAE currently publishes rates covering **75 currencies** against the AED (as of the latest table):\n\n🇦🇷 `ARS` · 🇦🇺 `AUD` · 🇦🇿 `AZN` · 🇧🇩 `BDT` · 🇧🇬 `BGN` · 🇧🇭 `BHD` · 🇧🇳 `BND` · 🇧🇷 `BRL` · 🇧🇼 `BWP` · 🇧🇾 `BYN` · 🇨🇦 `CAD` · 🇨🇭 `CHF` · 🇨🇱 `CLP` · 🇨🇳 `CNH` · 🇨🇳 `CNY` · 🇨🇴 `COP` · 🇨🇿 `CZK` · 🇩🇰 `DKK` · 🇩🇿 `DZD` · 🇪🇬 `EGP` · 🇪🇹 `ETB` · 🇪🇺 `EUR` · 🇬🇧 `GBP` · 🇭🇰 `HKD` · 🇭🇺 `HUF` · 🇮🇩 `IDR` · 🇮🇱 `ILS` · 🇮🇳 `INR` · 🇮🇶 `IQD` · 🇮🇸 `ISK` · 🇯🇴 `JOD` · 🇯🇵 `JPY` · 🇰🇪 `KES` · 🇰🇷 `KRW` · 🇰🇼 `KWD` · 🇰🇿 `KZT` · 🇱🇰 `LKR` · 🇱🇾 `LYD` · 🇲🇦 `MAD` · 🇲🇰 `MKD` · 🇲🇺 `MUR` · 🇲🇽 `MXN` · 🇲🇾 `MYR` · 🇳🇬 `NGN` · 🇳🇴 `NOK` · 🇳🇵 `NPR` · 🇳🇿 `NZD` · 🇴🇲 `OMR` · 🇵🇪 `PEN` · 🇵🇭 `PHP` · 🇵🇰 `PKR` · 🇵🇱 `PLN` · 🇶🇦 `QAR` · 🇷🇴 `RON` · 🇷🇸 `RSD` · 🇷🇺 `RUB` · 🇸🇦 `SAR` · 🇸🇩 `SDG` · 🇸🇪 `SEK` · 🇸🇬 `SGD` · 🇸🇾 `SYP` · 🇹🇭 `THB` · 🇹🇲 `TMT` · 🇹🇳 `TND` · 🇹🇷 `TRY` · 🇹🇹 `TTD` · 🇹🇼 `TWD` · 🇹🇿 `TZS` · 🇺🇬 `UGX` · 🇺🇸 `USD` · 🇺🇿 `UZS` · 🇻🇳 `VND` · 🇾🇪 `YER` · 🇿🇦 `ZAR` · 🇿🇲 `ZMW`\n\n## 🏛️ Source\n\nThe Central Bank of the UAE publishes daily dirham exchange rates for over 70 currencies. With the dirham pegged to the US dollar since 1997, these official rates are the reference for UAE customs, VAT and corporate-tax conversion.\n\n- Publisher's own page: [Exchange rates against AED](https://www.centralbank.ae/en/forex-eibor/exchange-rates/) · [www.centralbank.ae](https://www.centralbank.ae)\n- Publication: every business day; the exact schedule, freshness status and any current delay are on the [Central Bank of the UAE rates page](https://allratestoday.com/central-bank-rates-api/cbuae/)\n- Values are stored unmodified, with the publisher's own `rate_date` on every row — see the [methodology](https://allratestoday.com/official-rates-methodology/)\n\n## 🧭 Reading the numbers\n\n- `value` is always **quote currency per 1 unit of base currency** (`base: \"EUR\", quote: \"USD\", value: 1.15` means 1 EUR = 1.15 USD).\n- Central Bank of the UAE quotes **AED per 1 unit of foreign currency** (e.g. `base: \"USD\", quote: \"AED\"` means AED per one US dollar).\n- Need the other way round? Ask `getRate(target, source)` and the API inverts or crosses for you, flagged `derived: true` — never divide a published rate yourself in a compliance workflow.\n- `rate_type` tells you which of the central bank's series a row belongs to (`reference` here); some publishers print buy/sell or several fixings for the same pair.\n\n## 🧩 ERP & accounting systems\n\nLoading the official Central Bank of the UAE rate into an accounting system is a supported workflow, not a hack. Step-by-step guides with the direction each system expects:\n\n- [Dynamics 365 Business Central](https://allratestoday.com/docs/integrations/business-central/) — built-in Currency Exchange Rate Service, no code\n- [Xero](https://allratestoday.com/docs/integrations/xero/) · [QuickBooks Online](https://allratestoday.com/docs/integrations/quickbooks/) · [SAP S/4HANA and ECC](https://allratestoday.com/docs/integrations/sap/) · [Odoo](https://allratestoday.com/docs/integrations/odoo/)\n\nThe same keyed endpoints return `?format=csv`, `?format=xml` and `?format=xlsx`, and accept the key as `?api_key=` on the URL for importers that cannot send headers:\n\n```bash\ncurl \"https://allratestoday.com/api/v1/central-bank/cbuae/latest?format=xml&api_key=art_live_...\"\n```\n\n## 🤖 AI agents\n\n- MCP server: `npx -y @allratestoday/central-bank-mcp` (stdio) or the hosted endpoint `https://allratestoday.com/api/mcp` — tools for official rates, history, cross-bank comparison and publication calendars\n- Already using the general SDK or MCP server? Since 2026-10-01 [`@allratestoday/sdk`](https://www.npmjs.com/package/@allratestoday/sdk) 1.4+ has `officialRates('cbuae')` and [`@allratestoday/mcp-server`](https://www.npmjs.com/package/@allratestoday/mcp-server) 0.6+ has a `get_official_rates` tool — both return this source's latest table with no key, so you can add it without a second dependency\n- Machine-readable site guide: [llms.txt](https://allratestoday.com/llms.txt) · [for-ai-agents](https://allratestoday.com/for-ai-agents/)\n\n## ⚖️ Published vs derived rates\n\nIf Central Bank of the UAE does not print a pair directly, the API resolves it from the central bank's own table and says so — official and computed values are never confused:\n\n| `method` | `derived` | Meaning |\n| --- | --- | --- |\n| `published` | `false` | The central bank printed this pair directly |\n| `inverse` | `true` | Computed as 1 ÷ the published opposite direction |\n| `cross` | `true` | Computed via AED from two published rates |\n\n## 🛡️ Error handling\n\nErrors are thrown as `Error` with `status` (HTTP code) and `body` (the API's JSON error) attached:\n\n```js\ntry {\n  const pair = await getRate('USD', 'XXX', { apiKey: 'art_live_...' });\n} catch (err) {\n  console.log(err.message); // human-readable reason\n  console.log(err.status);  // e.g. 404\n}\n```\n\n| Status | Meaning |\n| ------ | ------- |\n| — | Missing `apiKey` (thrown before any request) |\n| `400` | Malformed date or parameters |\n| `401` | Invalid API key |\n| `403` | Endpoint needs a [paid plan](https://allratestoday.com/pricing/) (historical dates & series) |\n| `404` | Pair or date range not covered by Central Bank of the UAE |\n| `429` | Monthly quota exceeded |\n\n## 🔷 TypeScript\n\nFull definitions ship with the package — no `@types` install:\n\n```ts\nimport type { LatestRates, PairRate, DatedRates, RateEntry, HistoryQuery, RequestOptions } from '@allratestoday/cbuae-exchange-rate';\n```\n\n## 📦 CommonJS\n\n```javascript\nconst { getRate } = require('@allratestoday/cbuae-exchange-rate');\n\ngetRate('USD', 'AED', { apiKey: 'art_live_...' }).then((pair) => console.log(pair.rate));\n```\n\n## 💡 Quota tips\n\n- Rates change once per business day — cache the published table locally and a small monthly quota goes a long way.\n- Every request counts toward your AllRatesToday quota, shared across all AllRatesToday endpoints on your key.\n\n## 📖 Methods reference\n\n| Method | Plan | Description |\n| ------ | ---- | ----------- |\n| `getRate(source, target, { apiKey })` | Free | Latest rate for one pair, resolved from the published table |\n| `getLatestRates({ apiKey })` | Free | The central bank's full latest published table |\n| `getRatesForDate(date, { apiKey, source?, target? })` | Paid | The official table (or one pair) for a YYYY-MM-DD date |\n| `getHistory({ symbol \\| source+target, from?, to? }, { apiKey })` | Paid | Daily series since 2019 |\n\n## 📥 Bulk data (no key)\n\nNeed the whole archive rather than an API call? The same published tables are mirrored daily as open data:\n\n- Hugging Face: [AllRates/central-bank-exchange-rates](https://huggingface.co/datasets/AllRates/central-bank-exchange-rates) — one CSV per institution (`rates/cbuae.csv`)\n- Kaggle: [allratestoday/central-bank-exchange-rates](https://www.kaggle.com/datasets/allratestoday/central-bank-exchange-rates)\n- CDN JSON: `https://cdn.jsdelivr.net/gh/AllRates-Today/central-bank-exchange-rates@main/data/cbuae/latest.json`\n\n## 🔗 Links\n\n- [Central Bank of the UAE rates page](https://allratestoday.com/central-bank-rates-api/cbuae/) — live table, publication cadence, FAQ\n- [All central bank sources](https://allratestoday.com/central-bank-rates-api/)\n- [Package docs on the site](https://allratestoday.com/docs/sdk/cbuae-exchange-rate/) · [ERP integration guides](https://allratestoday.com/docs/integrations/)\n- [API documentation](https://allratestoday.com/docs/#central-bank) · [Interactive reference](https://allratestoday.com/api-reference/) · [Methodology](https://allratestoday.com/official-rates-methodology/)\n- [Register (free)](https://allratestoday.com/register) · [Pricing](https://allratestoday.com/pricing/)\n- [GitHub](https://github.com/AllRates-Today/cbuae-exchange-rate)\n\n## 📜 License\n\nMIT\n","readmeFilename":"README.md"}