# BRVM Market Data — West African Stock Exchange API (`malmon/brvm-market-data`) Actor The only API for BRVM equity data — delayed quotes, 25+ years of price history, indices, and company fundamentals for all ~47 stocks across 8 West African nations (WAEMU). - **URL**: https://apify.com/malmon/brvm-market-data.md - **Developed by:** [Simon M](https://apify.com/malmon) (community) - **Categories:** Agents, News, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $0.25 / quotes 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 ## BRVM Market Data **The only structured API for the BRVM — West Africa's regional stock exchange. Get delayed quotes, indices, historical prices, company fundamentals, and official announcements for all ~47 listed equities across 8 WAEMU countries.** ### What is BRVM? The **Bourse Régionale des Valeurs Mobilières (BRVM)** is the single regional stock exchange shared by eight francophone West African nations: Côte d'Ivoire, Senegal, Burkina Faso, Benin, Mali, Niger, Togo, and Guinea-Bissau. Founded in 1998 and headquartered in Abidjan, it is the primary capital market for the West African Economic and Monetary Union (WAEMU). BRVM equities are **not covered by mainstream data providers** such as Yahoo Finance or Bloomberg at the retail API tier. This Actor provides the only readily accessible, structured API for BRVM data — pulling directly from [brvm.org](https://www.brvm.org) and the [BRVM financial database](https://bfin.brvm.org). ### What does BRVM Market Data do? Five data modes in one Actor: | Mode | What you get | |------|-------------| | `quotes` | Latest delayed prices, change, volume for all ~47 equities | | `indices` | BRVM Composite, BRVM 30, and BRVM Prestige index values | | `historical` | Daily close prices and volume per ticker — **back to September 1998** | | `company` | Company fundamentals: ISIN, sector, listing date, shares outstanding, market cap | | `announcements` | Official issuer press releases and regulatory filings | All data is **delayed by ~15 minutes** and sourced exclusively from publicly available pages. Running on the Apify platform gives you scheduling, automatic retries, proxy rotation, monitoring dashboards, and export in JSON, CSV, or Excel — no infrastructure to manage. ### Why use BRVM Market Data? - **Fintech and diaspora investing apps** — display portfolio values for users holding BRVM stocks; no other off-the-shelf API covers this exchange - **Quantitative research** — 25+ years of daily price history (6,700+ trading sessions) for emerging African market studies - **ESG and impact investing** — screen WAEMU-listed companies by sector and country across 8 nations in one call - **Financial dashboards and BI tools** — embed BRVM data into Power BI, Tableau, or custom dashboards on a schedule - **Price monitoring and alerts** — run on a schedule, compare to a stored baseline, trigger webhooks on moves ### How to use BRVM Market Data 1. Go to the Actor page on Apify Store and click **Try for free** 2. Select a **mode** from the dropdown (default: `quotes`) 3. Optionally enter specific **Tickers** (e.g. `SNTS, SGBC, ETIT`) — leave blank for all equities 4. For `historical` mode, set **Start date** and **End date**; set **Max items** to cap cost 5. Click **Start** — a typical quotes run finishes in under 10 seconds 6. Download from the **Output** tab in JSON, CSV, or Excel, or read via the Apify API ### Input | Field | Type | Default | Description | |-------|------|---------|-------------| | `mode` | enum | `"quotes"` | `quotes` · `indices` · `historical` · `company` · `announcements` | | `tickers` | string[] | all | Filter to specific BRVM symbols, e.g. `["SNTS", "SGBC"]`. Leave empty for all. | | `dateFrom` | string | -30 days | ISO date. `historical` mode only. | | `dateTo` | string | today | ISO date. `historical` mode only. | | `maxItems` | integer | 1000 | Hard cap on output records — directly bounds cost. | **Quotes (all 47 equities):** ```json { "mode": "quotes" } ```` **Filtered quotes (3 tickers):** ```json { "mode": "quotes", "tickers": ["SNTS", "ETIT", "SGBC"] } ``` **Historical (one ticker, full year, capped at 300 rows):** ```json { "mode": "historical", "tickers": ["SNTS"], "dateFrom": "2024-01-01", "dateTo": "2024-12-31", "maxItems": 300 } ``` ### Output All modes push records to the **default Apify Dataset**. Download as JSON, CSV, or Excel from the Output tab. Every record includes `source`, `fetched_at`, and `delay_minutes: 15`. #### quotes ```json { "ticker": "SNTS", "isin": "SN0000000019", "name": "SONATEL SENEGAL", "country": "SN", "sector": "Telecommunications", "currency": "XOF", "last": 28500, "previous_close": 28900, "change": -400, "change_pct": -1.38, "volume": 2514, "value_xof": 71673000, "trading_date": "2026-05-22", "source": "brvm.org", "fetched_at": "2026-05-28T11:04:00.000Z", "delay_minutes": 15 } ``` #### indices ```json { "code": "BRVMC", "name": "BRVM Composite", "value": 223.08, "change": 1.46, "change_pct": 0.66, "trading_date": "2026-05-28", "source": "brvm.org", "fetched_at": "2026-05-28T11:04:00.000Z", "delay_minutes": 15 } ``` Index codes: `BRVMC` (Composite), `BRVM30`, `BRVMPR` (Prestige). #### historical ```json { "ticker": "SNTS", "date": "2026-05-22", "open": 28900, "high": 28900, "low": 28500, "close": 28500, "volume": 2514, "source": "brvm.org", "fetched_at": "2026-05-28T11:04:00.000Z", "delay_minutes": 15 } ``` > **Note on OHLCV:** The BRVM publishes only daily closing prices and volumes — no intraday ticks. `open` is set to the previous session's closing price; `high` and `low` are derived from `open` and `close`. For long-term trend analysis this is accurate; for intraday range analysis it is not. #### company ```json { "ticker": "SNTS", "isin": "SN0000000019", "name": "SONATEL SENEGAL", "country": "SN", "sector": "Telecommunications", "listing_date": "1998-09-16", "shares_outstanding": 100000000, "market_cap_xof": 2850000000000, "website": "https://www.sonatel.sn", "source": "brvm.org", "fetched_at": "2026-05-28T11:04:00.000Z", "delay_minutes": 15 } ``` #### announcements ```json { "ticker": "SNTS", "title": "SNTS | Notation financière", "published_at": "2025-07-07", "url": "https://www.brvm.org/sites/default/files/...", "summary": null, "source": "brvm.org", "fetched_at": "2026-05-28T11:04:00.000Z" } ``` ### Field reference — quotes mode | Field | Description | |-------|-------------| | `ticker` | BRVM symbol (e.g. `SNTS`) | | `isin` | 12-character ISIN code | | `name` | Full registered company name | | `country` | ISO 3166-1 alpha-2 country of incorporation | | `sector` | Sector classification | | `currency` | Always `XOF` (West African CFA franc) | | `last` | Last traded price in XOF | | `previous_close` | Prior session closing price | | `change` | `last − previous_close` | | `change_pct` | Percentage change | | `volume` | Shares traded in the session | | `value_xof` | Approximate turnover (`volume × last`) | | `trading_date` | ISO date of the session | ### Scheduling BRVM trading hours are **09:00–15:00 GMT, Monday–Friday**. Use the Apify Scheduler to run on a cron expression: | Goal | Cron expression | Cost/month (all tickers) | |------|----------------|--------------------------| | Every 15 min during trading hours | `*/15 9-15 * * 1-5` | ~$22 | | Every 30 min during trading hours | `*/30 9-15 * * 1-5` | ~$11 | | Once per trading day (open) | `0 9 * * 1-5` | ~$1.10 | | Weekly snapshot | `0 9 * * 1` | ~$0.25 | Combine a `quotes` run with a [webhook](https://docs.apify.com/platform/integrations/webhooks) to trigger downstream processing when new data arrives. ### Pricing This Actor uses **Pay-Per-Event** pricing — you pay per data record, not per CPU-minute. | Event | Price | When | |-------|-------|------| | `apify-actor-start` | $0.00005 | Every run (covers ~5 s compute) | | `quotes-snapshot` | $0.25 | Once per unfiltered `quotes` run (~47 records) | | `quote-filtered` | $0.05 | Per ticker when using the `tickers` filter | | `index-snapshot` | $0.10 | Once per `indices` run (3 records) | | `historical-row` | $0.01 | Per daily row | | `company-record` | $0.10 | Per company | | `announcement` | $0.01 | Per announcement | **Cost examples:** - **Full quotes snapshot** (all 47 equities, once): **$0.25** - **5 filtered tickers** (quotes): 5 × $0.05 = **$0.25** - **One year of history for 1 ticker** (~250 rows): **$2.50** - **Full historical dataset** (47 tickers × 6,700 days): **~$3,150** — use `maxItems` and ticker filters to stay within budget ### API usage **JavaScript / Node.js:** ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_TOKEN' }); const run = await client.actor('malmon/brvm-market-data').call({ mode: 'quotes', }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` **Python:** ```python from apify_client import ApifyClient client = ApifyClient("YOUR_TOKEN") run = client.actor("malmon/brvm-market-data").call( run_input={"mode": "quotes"} ) items = client.dataset(run["defaultDatasetId"]).list_items().items print(items) ``` **curl:** ```bash curl -X POST \ "https://api.apify.com/v2/acts/malmon~brvm-market-data/runs?token=YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"mode":"quotes"}' ``` ### For AI agents This Actor is available via the Apify MCP server at [mcp.apify.com](https://mcp.apify.com). Call it with `{"mode": "quotes"}` for a full market snapshot or `{"mode": "historical", "tickers": ["SNTS"], "dateFrom": "2025-01-01", "dateTo": "2025-12-31"}` for historical data. Supports agentic payments via x402 and Skyfire. ### FAQ **Is this data real-time?** No. All data carries a ~15-minute delay per BRVM's public data policy. Do not use it for live execution decisions. **How far back does historical data go?** The BRVM financial database holds records from September 1998 (the exchange's founding). That is 6,700+ trading sessions as of 2026. **Where does the data come from?** `quotes`, `indices`, `company`, and `announcements` are sourced from [brvm.org](https://www.brvm.org). `historical` prices come from [bfin.brvm.org](https://bfin.brvm.org), the BRVM's own financial database. No login-gated or paid data sections are accessed. **Is scraping brvm.org permitted?** The Actor scrapes only publicly available pages, without authentication, at a maximum rate of one request per second, and identifies itself via a `User-Agent` header. Users are responsible for compliance with brvm.org's Terms of Service and applicable law in their jurisdiction. **What countries and currencies are covered?** All eight WAEMU member states: Côte d'Ivoire, Senegal, Burkina Faso, Benin, Mali, Niger, Togo, Guinea-Bissau. All prices are in **XOF** (West African CFA franc). **Why are open/high/low the same in some historical rows?** The BRVM publishes only daily close prices and volumes — no intraday data. `open` approximates the previous session's close; if the price did not move, open = high = low = close. See the note in the historical output section above. **Known limitations:** - No real-time or order book data - ISIN codes may be `null` for some tickers in `quotes` mode if the company page is unavailable - `company` mode financial fields (`shares_outstanding`, `market_cap_xof`) may be `null` if not published on the issuer's page **Issues and feature requests:** Report on the Issues tab or via the Apify console. # Actor input Schema ## `mode` (type: `string`): Which type of market data to fetch. ## `tickers` (type: `array`): Leave empty to fetch all ~47 listed equities. Enter BRVM ticker symbols to filter, e.g. SNTS, SGBC, ETIT. Not used in 'indices' mode. ## `dateFrom` (type: `string`): First date to fetch, inclusive. ISO 8601 format, e.g. 2025-01-01. Defaults to 30 days ago. ## `dateTo` (type: `string`): Last date to fetch, inclusive. ISO 8601 format, e.g. 2025-12-31. Defaults to today. ## `maxItems` (type: `integer`): Hard cap on the number of output records. Use this to control cost on large historical pulls — e.g. set 250 to get one full trading day across all tickers. ## Actor input object example ```json { "mode": "quotes", "tickers": [ "SNTS", "SGBC", "ETIT" ], "maxItems": 1000 } ``` # 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 = { "tickers": [ "SNTS", "SGBC", "ETIT" ] }; // Run the Actor and wait for it to finish const run = await client.actor("malmon/brvm-market-data").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 = { "tickers": [ "SNTS", "SGBC", "ETIT", ] } # Run the Actor and wait for it to finish run = client.actor("malmon/brvm-market-data").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 '{ "tickers": [ "SNTS", "SGBC", "ETIT" ] }' | apify call malmon/brvm-market-data --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=malmon/brvm-market-data", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "BRVM Market Data — West African Stock Exchange API", "description": "The only API for BRVM equity data — delayed quotes, 25+ years of price history, indices, and company fundamentals for all ~47 stocks across 8 West African nations (WAEMU).", "version": "1.1", "x-build-id": "ACibSQKykDApUrdli" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/malmon~brvm-market-data/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-malmon-brvm-market-data", "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~brvm-market-data/runs": { "post": { "operationId": "runs-sync-malmon-brvm-market-data", "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~brvm-market-data/run-sync": { "post": { "operationId": "run-sync-malmon-brvm-market-data", "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": "Data mode", "enum": [ "quotes", "indices", "historical", "company", "announcements" ], "type": "string", "description": "Which type of market data to fetch.", "default": "quotes" }, "tickers": { "title": "Tickers (optional filter)", "type": "array", "description": "Leave empty to fetch all ~47 listed equities. Enter BRVM ticker symbols to filter, e.g. SNTS, SGBC, ETIT. Not used in 'indices' mode.", "items": { "type": "string" } }, "dateFrom": { "title": "Start date (historical mode only)", "type": "string", "description": "First date to fetch, inclusive. ISO 8601 format, e.g. 2025-01-01. Defaults to 30 days ago." }, "dateTo": { "title": "End date (historical mode only)", "type": "string", "description": "Last date to fetch, inclusive. ISO 8601 format, e.g. 2025-12-31. Defaults to today." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Hard cap on the number of output records. Use this to control cost on large historical pulls — e.g. set 250 to get one full trading day across all tickers.", "default": 1000 } } }, "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 } } } } } } } } } } ```