Bank Negara Malaysia Open Data Getting Started: Accessing Data (2026)

Getting started overview

The Bank Negara Malaysia (BNM) Open Data portal offers a collection of economic and financial datasets for public use. Unlike many other API services, the BNM Open Data portal does not require account creation, API keys, or any form of authentication to access its resources. This direct access model simplifies the process of retrieving data for research, analysis, and application development.

Data is primarily available through web-based downloads in CSV format or via direct API endpoints that return data in JSON format. Each dataset page on the BNM Open Data portal includes specific documentation for its associated API, detailing available parameters, request structures, and expected response formats. This integration of documentation within the dataset itself aims to streamline the developer experience.

To begin, users typically identify the specific dataset they need, navigate to its dedicated page, and then either download the CSV file directly or utilize the provided API endpoint instructions to make programmatic requests. The absence of an authentication layer means that developers can immediately construct requests using standard HTTP client libraries or command-line tools without prior setup beyond understanding the API's structure.

This guide will walk through the process of identifying a dataset, understanding its API documentation, and making a first request to retrieve data from the Bank Negara Malaysia Open Data portal.

Create an account and get keys

The Bank Negara Malaysia Open Data portal does not require users to create an account or obtain API keys to access its data. All datasets and their corresponding API endpoints are publicly accessible without any authentication. This means there is no signup process, no dashboard to manage credentials, and no keys to generate or rotate.

This approach significantly lowers the barrier to entry for developers and researchers, allowing immediate access to financial statistics and economic data. Users can directly integrate the provided API endpoints into their applications or scripts without any preliminary registration steps. The lack of an authentication layer simplifies development and deployment, removing the need to manage secrets or implement complex authorization flows typical of many commercial APIs.

Consequently, the typical steps involved in creating an account, generating API keys, and managing credentials are not applicable when working with the Bank Negara Malaysia Open Data. Users can proceed directly to identifying the desired dataset and formulating their API requests based on the specific endpoint documentation.

Your first request

To make your first request to the Bank Negara Malaysia Open Data API, you need to identify a specific dataset and its corresponding API endpoint. This process involves navigating the BNM Open Data portal to locate the data of interest and then extracting the API URL and any necessary parameters from its dedicated documentation.

Identify a dataset

1. Navigate to the Bank Negara Malaysia Open Data portal.
2. Browse the available categories or use the search function to find a dataset relevant to your needs. For this example, we will look for a common dataset like "Key Interest Rates".
3. Click on the chosen dataset (e.g., "Key Interest Rates") to view its detailed page.

Locate API endpoint and documentation

On the dataset's dedicated page, you will typically find sections for data download (CSV) and API access. The API section will provide the base URL for the API endpoint and describe any available query parameters, such as date ranges, data formats, or specific indicators.

For instance, if the documentation for "Key Interest Rates" provides an endpoint like https://www.bnm.gov.my/api/v1/data/interest-rates and specifies parameters for start_date and end_date, you would use this information to construct your request.

An example API endpoint for retrieving data might look like this (note: specific endpoints vary by dataset; this is illustrative):

GET https://www.bnm.gov.my/api/v1/data/interest-rates?start_date=2023-01-01&end_date=2023-12-31

Make the API call

You can make the API call using various methods:

Using a web browser

For simple GET requests, you can paste the full API URL directly into your web browser's address bar and press Enter. The browser will display the JSON response in a readable format, often with syntax highlighting if a browser extension for JSON viewing is installed.

Using curl (command line)

curl is a command-line tool for making HTTP requests and is suitable for quick tests and scripting. Open your terminal or command prompt and execute:

curl "https://www.bnm.gov.my/api/v1/data/interest-rates?start_date=2023-01-01&end_date=2023-12-31"

This command will print the JSON response directly to your terminal.

Using Python (requests library)

For programmatically interacting with the API, Python's requests library is a common choice. First, ensure you have it installed (pip install requests).

import requests
import json

api_url = "https://www.bnm.gov.my/api/v1/data/interest-rates"
params = {
    "start_date": "2023-01-01",
    "end_date": "2023-12-31"
}

try:
    response = requests.get(api_url, params=params)
    response.raise_for_status()  # Raise an HTTPError for bad responses (4xx or 5xx)
    data = response.json()
    print(json.dumps(data, indent=2))
except requests.exceptions.RequestException as e:
    print(f"An error occurred: {e}")

This script constructs the URL with parameters, makes the GET request, and prints the pretty-formatted JSON response. For more information on using Python's requests library, consult the Requests library documentation.

A successful request will return a JSON object containing the requested data, typically an array of records with various fields depending on the dataset. For example, the Key Interest Rates data might include fields like date, oPR (Overnight Policy Rate), and interest_rate_type.

Common next steps

After successfully making your first request to the Bank Negara Malaysia Open Data API, several common next steps can enhance your data utilization and application development:

1. Explore More Datasets: Investigate other datasets available on the BNM Open Data portal. Different datasets cover various aspects of Malaysia's economy and financial sector, from banking statistics to monetary policy indicators.

2. Understand Data Structures: Familiarize yourself with the JSON response structures for different endpoints. This is crucial for correctly parsing and utilizing the data within your applications. Pay attention to data types, field names, and nested objects if present.

3. Implement Error Handling: While the BNM Open Data API does not require authentication, requests can still fail due to network issues, incorrect parameters, or server-side problems. Implement robust error handling in your code to gracefully manage HTTP status codes (e.g., 404 Not Found, 500 Internal Server Error) and network exceptions. The MDN Web Docs on HTTP status codes provide a comprehensive reference.

4. Data Processing and Storage: Decide how you will process and store the retrieved data. For analytical purposes, you might load it into a database, a data warehouse, or a spreadsheet. For real-time applications, you might process it in memory. Consider data cleaning, transformation, and aggregation steps relevant to your use case.

5. Parameterization and Dynamic Requests: Instead of hardcoding parameters, make your API requests dynamic. Allow users to specify date ranges, indicators, or other filters through your application's interface. This involves reading user input and constructing the API URL accordingly.

6. Rate Limiting (Self-Imposed): Although the BNM Open Data portal does not explicitly publish rate limits, it is good practice to implement self-imposed rate limiting in your applications. Avoid making an excessive number of requests in a short period to prevent overloading the server and ensure fair access for all users. Introduce delays between requests if fetching large volumes of data.

7. Visualization and Reporting: Once you have processed the data, consider how to visualize it effectively. Tools like Matplotlib, Seaborn (for Python), D3.js (for web), or business intelligence platforms can help in creating charts, dashboards, and reports from the economic and financial statistics.

Troubleshooting the first call

Encountering issues during your first API call is common. Here's a guide to troubleshooting potential problems when interacting with the Bank Negara Malaysia Open Data API:

1. Incorrect URL or Endpoint:

   • Symptom: HTTP 404 Not Found error or an unexpected response.
   • Solution: Double-check the API endpoint URL against the specific dataset's documentation on the BNM Open Data portal. Ensure there are no typos, extra slashes, or missing components in the URL.

2. Malformed Parameters:

   • Symptom: HTTP 400 Bad Request error or empty/unexpected data.
   • Solution: Verify that all query parameters (e.g., start_date, end_date) are correctly formatted and adhere to the requirements specified in the dataset's API documentation. For dates, ensure the format (e.g., YYYY-MM-DD) is correct. Ensure parameter names match exactly.

3. Network Connectivity Issues:

   • Symptom: Connection timed out, host unreachable, or no response.
   • Solution: Check your internet connection. Try accessing other websites or APIs to confirm general connectivity. Firewalls or proxy settings might be blocking outgoing HTTP requests; consult your network administrator if you are in a corporate environment.

4. JSON Parsing Errors:

   • Symptom: Your programming language's JSON parser fails or throws an error.
   • Solution: This often indicates that the response received was not valid JSON. First, examine the raw response body. If it contains HTML (e.g., an error page) or plain text instead of JSON, the issue is likely with the request itself (e.g., incorrect URL leading to a non-API page). If it appears to be JSON but still fails, ensure your parsing library is correctly used and that the response is fully received before parsing attempts.

5. Endpoint Returns Empty Data:

   • Symptom: A successful HTTP 200 OK response, but the data array is empty.
   • Solution: Review your date range or other filtering parameters. The specified range might not contain any available data for that particular dataset, or your filters might be too restrictive. Adjust the date range to cover a broader period to check if data exists.

6. SSL/TLS Certificate Issues:

   • Symptom: Connection errors related to certificate validation.
   • Solution: While rare for public APIs, ensure your system's root certificates are up to date. If using curl or a programming library, ensure SSL verification is not explicitly disabled unless absolutely necessary for testing (and never in production). Most modern HTTP clients handle this automatically.

By systematically checking these points, you can typically identify and resolve issues preventing a successful API call to the Bank Negara Malaysia Open Data portal.