# West Africa FX Rates — Official Central Bank Exchange Rates API (`malmon/west-africa-fx-rates`) Actor The only API pulling official daily FX rates directly from West African central banks — not World Bank annual releases. 11 countries, 4 currencies, history back to 1996. CBN, Bank of Ghana, BCEAO. Every record source-attributed with legal basis. - **URL**: https://apify.com/malmon/west-africa-fx-rates.md - **Developed by:** [Simon M](https://apify.com/malmon) (community) - **Categories:** Agents, News, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $0.10 / full market snapshot This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## West African FX Rates — Daily Central Bank Exchange Rates Official USD exchange rates published daily by West African central banks, normalised into one consistent schema. Covers **Nigeria** (CBN), **Ghana** (BoG), the **8 WAEMU states** (Benin, Burkina Faso, Côte d'Ivoire, Guinea-Bissau, Mali, Niger, Senegal, Togo), and **Cape Verde** (BCV) — 11 countries in total. Unlike the World Bank, IMF, or ECB datasets already on Apify — which publish African macro data **annually with a 6–12 month lag** — this actor pulls **fresh, daily** rates straight from the issuing institutions. > Part of a regional family: **West African FX Rates** (this actor), with East, Southern, and North African actors in the same normalised schema. --- ### Modes Choose a mode to match your use case: | Mode | What you get | When to use it | |---|---|---| | `usd-core` *(default)* | One USD rate per country, latest available date | Daily monitoring, dashboards, FX baskets | | `all-currencies` | Every currency each central bank publishes, latest date | Multi-currency exposure, FX desks | | `historical` | USD rate per country, every trading day in a date range | Backtesting, time-series analysis, academic research | --- ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `usd-core` | See modes table above. | | `countries` | array | all 11 | ISO 3166-1 alpha-2 codes to include. Nigeria: `NG`. Ghana: `GH`. Cape Verde: `CV`. WAEMU: `BJ` `BF` `CI` `GW` `ML` `NE` `SN` `TG`. | | `dateFrom` | string | — | Start date (`YYYY-MM-DD`). Required in `historical` mode. | | `dateTo` | string | — | End date (`YYYY-MM-DD`). Required in `historical` mode. All three sources support history: Nigeria back to ~2010, Ghana back to 1996, WAEMU back to 1999. | | `maxItems` | integer | 5000 | Hard cap on output rows. | --- ### Output One record per country per run (in `usd-core`), per country-currency (in `all-currencies`), or per country-day (in `historical`). **Nigeria example:** ```json { "id": "NG:USD:2026-06-02:official", "country": "NG", "centralBank": "CBN", "baseCurrency": "USD", "quoteCurrency": "NGN", "pair": "USD/NGN", "date": "2026-06-02", "buying": 1360.0497, "selling": 1361.0497, "mid": 1360.5497, "midMethod": "published", "inverseMid": 0.00073499, "rateType": "official", "warnings": [], "source": { "name": "Central Bank of Nigeria", "url": "https://www.cbn.gov.ng/rates/ExchRateByCurrency.html", "retrievedAt": "2026-06-02T15:00:00.000Z", "asOfDate": "2026-06-02", "licenseNote": "Reproduced with attribution per the CBN website Legal Disclaimer." } } ```` Read it as: **1 USD = 1360.55 NGN** (buying rate: 1360.05, selling rate: 1361.05). **WAEMU/XOF example (Senegal):** ```json { "id": "SN:USD:2026-06-02:derived", "country": "SN", "centralBank": "BCEAO", "baseCurrency": "USD", "quoteCurrency": "XOF", "pair": "USD/XOF", "date": "2026-06-02", "buying": null, "selling": null, "mid": 563.1016, "midMethod": "published", "inverseMid": 0.001776, "rateType": "derived", "sharedRate": true, "warnings": [], "source": { "name": "BCEAO / ECB (derived daily)", "url": "https://data-api.ecb.europa.eu/service/data/EXR/D.USD.EUR.SP00.A", "retrievedAt": "2026-06-02T15:00:00.000Z", "asOfDate": "2026-06-02", "licenseNote": "EUR/USD source: ECB Statistical Data Warehouse (free reuse with attribution). USD/XOF derived using the fixed EUR/XOF peg of 655.957.", "derivationNote": "USD/XOF = 655.957 ÷ ECB daily EUR/USD reference rate. The EUR/XOF peg is fixed by the French Treasury / EU treaty; derivation is exact, not estimated." } } ``` #### Field reference | Field | Meaning | |---|---| | `country` / `centralBank` | ISO 3166-1 alpha-2 country code + issuing bank abbreviation | | `baseCurrency` / `quoteCurrency` / `pair` | ISO 4217 codes. `pair` = `base/quote`. Read as: "price of 1 `baseCurrency` in `quoteCurrency`." | | `date` | The rate's as-of date (ISO 8601, `YYYY-MM-DD`) | | `buying` / `selling` / `mid` | Rates as published. `null` where the source doesn't publish that leg. CBN (NG) and BoG (GH) publish all three. WAEMU and Cape Verde rates are derived from a fixed peg — no bid/ask spread exists, so `buying` and `selling` are always `null` for those rows; use `mid`. | | `midMethod` | How the mid was obtained: `published` (bank's own figure), `midpoint` (computed as `(buy+sell)/2`), or `unavailable` | | `inverseMid` | `1/mid` — units of base per 1 quote (e.g. NGN per USD) | | `rateType` | `official` (CBN NFEM rate), `interbank` (BoG), `derived` (WAEMU/XOF — see below). **Rates of different types are not directly comparable.** | | `sharedRate` | `true` on WAEMU/XOF rows. All 8 states share one rate — see below. | | `warnings` | Data-quality flags from the source, e.g. `buying_gt_selling`, `mid_out_of_range` | | `id` | Deterministic natural key (`country:baseCurrency:date:rateType`) — safe to use for upsert/dedup | | `source` | Full attribution and provenance block: bank name, URL, retrieval timestamp, as-of date, licence note | *** ### Coverage and source notes | Country / Region | Bank | Rate type | buying / selling | Historical | |---|---|---|---|---| | Nigeria (NG) | Central Bank of Nigeria | `official` — NFEM daily closing rate | ✓ published | Available; arbitrary date range via CBN API | | Ghana (GH) | Bank of Ghana | `interbank` — daily interbank mid, buying, selling | ✓ published | Available back to 1996-01-02 | | 8 WAEMU states (BJ BF CI GW ML NE SN TG) | BCEAO / ECB | `derived` — see note | null (peg, no spread) | Available back to 1999-01-04 (ECB EUR/USD series start) | | Cape Verde (CV) | BCV / ECB | `derived` — see note | null (peg, no spread) | Available back to 1999-01-04 (ECB EUR/USD series start) | **Why are WAEMU and Cape Verde rows derived?** Both currencies are **permanently pegged to the EUR by treaty**: - XOF (8 WAEMU states): pegged at **655.957** since 1999 (French Treasury / EU treaty) - CVE (Cape Verde escudo): pegged at **110.265** since 1998 (Portugal, continued with the euro) There is no independent USD rate for either currency — it is derived mathematically: `USD/local = peg ÷ ECB daily EUR/USD`. The derivation is exact, not estimated. Each row carries `sharedRate: true` and `rateType: "derived"`. For billing, all 8 WAEMU rows count as **one** chargeable event per day (they share a single ECB data point); Cape Verde is a separate event. **Delayed data.** Rates are scraped from each institution's published page — not a real-time feed. Expect a few hours' lag after a central bank publishes its daily figure. *** ### Cost Pay-per-event pricing: | Mode | Charge | Typical cost | |---|---|---| | `usd-core` | One `fx-snapshot` per run | $0.10 per run | | `all-currencies` | One `fx-country-day` per unique (currency, country, date) row | $0.015 per row | | `historical` | One `fx-country-day` per unique (currency, country, date) — WAEMU 8 states count as 1 | $0.015 per country-day | **Examples:** - Daily `usd-core` for all 11 countries: **$0.10/day** (~$2.20/month) - 1 year of `historical` for Nigeria + Ghana: 2 × ~252 trading days = ~504 events → **~$7.56** - 1 year of `historical` for all 11 countries: Nigeria + Ghana + 1 WAEMU data point + Cape Verde = 4 × ~252 = ~1,008 chargeable events → **~$15** *** ### Legality & disclaimers **Is the data real-time?** No — it is delayed. We scrape each bank's published web page; publishing lag varies by institution. **Legal basis.** Official exchange rates are **factual data**. Copyright protects creative expression, not facts. These central-bank sites carry only a general copyright notice with no contractual restriction on reusing the published rate figures. The Central Bank of Nigeria additionally grants explicit permission to copy material "provided that CBN is stated expressly as the source." Every output record carries the issuing bank's name, URL, and a licence note — we reproduce values exactly as published without alteration. **Accuracy.** Values are reproduced as published. If a bank revises a figure, re-run to pick up the change; use `asOfDate` and `retrievedAt` to track versions. **Resilience.** Each source is fetched independently. If one central bank's site is down, the run still returns data from the others and logs a per-source summary. **Issues / feedback:** use the Issues tab on the actor page. *This is not legal or financial advice. Verify rates against the issuing central bank before acting on them.* # Actor input Schema ## `mode` (type: `string`): usd-core: one comparable USD rate per country (latest). all-currencies: every currency each bank publishes (latest). historical: a USD-per-country time series — set Date from / Date to below. ## `countries` (type: `array`): Which countries to include (ISO 3166 alpha-2). NG = Nigeria, GH = Ghana, CV = Cape Verde. The 8 WAEMU/XOF states share one BCEAO reference rate: BJ Benin, BF Burkina Faso, CI Côte d'Ivoire, GW Guinea-Bissau, ML Mali, NE Niger, SN Senegal, TG Togo. ## `dateFrom` (type: `string`): Start date (YYYY-MM-DD). Required in historical mode. All sources support history: Nigeria (arbitrary range), Ghana (back to 1996), WAEMU + Cape Verde (back to 1999). ## `dateTo` (type: `string`): End date (YYYY-MM-DD). Required in historical mode. ## `maxItems` (type: `integer`): Hard cap on output records. Mainly relevant in all-currencies and historical modes. ## Actor input object example ```json { "mode": "usd-core", "countries": [ "NG", "GH", "CV", "BJ", "BF", "CI", "GW", "ML", "NE", "SN", "TG" ], "maxItems": 5000 } ``` # Actor output Schema ## `dataset` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "countries": [ "NG", "GH", "CV", "BJ", "BF", "CI", "GW", "ML", "NE", "SN", "TG" ] }; // Run the Actor and wait for it to finish const run = await client.actor("malmon/west-africa-fx-rates").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "countries": [ "NG", "GH", "CV", "BJ", "BF", "CI", "GW", "ML", "NE", "SN", "TG", ] } # Run the Actor and wait for it to finish run = client.actor("malmon/west-africa-fx-rates").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "countries": [ "NG", "GH", "CV", "BJ", "BF", "CI", "GW", "ML", "NE", "SN", "TG" ] }' | apify call malmon/west-africa-fx-rates --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=malmon/west-africa-fx-rates", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "West Africa FX Rates — Official Central Bank Exchange Rates API", "description": "The only API pulling official daily FX rates directly from West African central banks — not World Bank annual releases. 11 countries, 4 currencies, history back to 1996. CBN, Bank of Ghana, BCEAO. Every record source-attributed with legal basis.", "version": "0.1", "x-build-id": "b4ObSMxmw1i3ww7TN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/malmon~west-africa-fx-rates/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-malmon-west-africa-fx-rates", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/malmon~west-africa-fx-rates/runs": { "post": { "operationId": "runs-sync-malmon-west-africa-fx-rates", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/malmon~west-africa-fx-rates/run-sync": { "post": { "operationId": "run-sync-malmon-west-africa-fx-rates", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "usd-core", "all-currencies", "historical" ], "type": "string", "description": "usd-core: one comparable USD rate per country (latest). all-currencies: every currency each bank publishes (latest). historical: a USD-per-country time series — set Date from / Date to below.", "default": "usd-core" }, "countries": { "title": "Countries (optional filter)", "type": "array", "description": "Which countries to include (ISO 3166 alpha-2). NG = Nigeria, GH = Ghana, CV = Cape Verde. The 8 WAEMU/XOF states share one BCEAO reference rate: BJ Benin, BF Burkina Faso, CI Côte d'Ivoire, GW Guinea-Bissau, ML Mali, NE Niger, SN Senegal, TG Togo.", "default": [ "NG", "GH", "CV", "BJ", "BF", "CI", "GW", "ML", "NE", "SN", "TG" ], "items": { "type": "string" } }, "dateFrom": { "title": "Date from (historical mode)", "type": "string", "description": "Start date (YYYY-MM-DD). Required in historical mode. All sources support history: Nigeria (arbitrary range), Ghana (back to 1996), WAEMU + Cape Verde (back to 1999)." }, "dateTo": { "title": "Date to (historical mode)", "type": "string", "description": "End date (YYYY-MM-DD). Required in historical mode." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Hard cap on output records. Mainly relevant in all-currencies and historical modes.", "default": 5000 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```