BitMart Exchange API Key Creation Guide: Steps, Permissions, and Security Settings

Introduction to the BitMart API

BitMart Exchange has made its Application Programming Interface (API) available to the public since August 1, 2018, allowing users to programmatically access market data, execute trades, and manage accounts. The BitMart API supports REST API and WebSocket subscription services and can be integrated with a variety of third-party trading platforms and tools, providing advanced users and developers with flexible solutions for automated trading.

Detailed Steps for Creating a BitMart API Key

1. Log in to Your Account: First, log in to your BitMart account via a web browser. Please note that the mobile app currently does not support API key management.
2. Access the API Management Page: After logging in, click the account icon in the top-right corner of the page and select the “API Management” option from the drop-down menu.
3. Create an API Key:

   On the API Management page, you will see the option to create a new API key. Please fill in the following information:

   • Memo (Note): Enter a short label or note to help you identify the purpose of this API key. When connecting to certain third-party platforms, this note may be required as a “passphrase.”
   • Permissions: Check the required permissions based on your specific needs. Typically, “Read Only” permissions are enabled by default. Other common permissions include “Spot-Trade,” “Futures-Trade,” and “Margin-Trade.”For account security, it is strongly recommended that you enable only the necessary permissions.
   • Bind IP Address: This is a recommended security measure. You can enter one or more whitelisted IP addresses; only these IP addresses will be able to access your account via this API key. If you use a third-party trading tool, you’ll need to obtain its server IP address from that tool. If left blank, any IP address can access your account, but this offers lower security.

   Once you have completed the form, click the “Add” or “Submit” button.

   

4. Security Verification: The system will prompt you to complete security verification, such as entering a verification code received via email or through the Google authenticator. Complete the verification to continue.
5. Copy the API Key and Secret Key: Once the API key has been successfully created, the page will display the Access Key (API Key) and Secret Key. Be sure to copy and securely store the Secret Key immediately, as it will only be displayed once and cannot be viewed again afterward.
6. Confirm and Exit: Click the “Confirm” button to complete the API key creation process.

API Key Usage and Security Tips

• Key Limit: Each BitMart account can create up to 5 sets of API keys. Each set can be configured with different permission combinations to meet the needs of various use cases.
• Historical Data Retrieval: Through the API, you can typically only retrieve spot trading and futures trading data from the past 3 months, as well as the most recent 100 withdrawal records. If you need complete historical data, we recommend manually syncing or exporting it periodically.
• Third-Party Integrations: The BitMart API can be integrated with various third-party trading tools and platforms, such as Bitsgap, Cryptohopper, and uTrading, to enable automated trading and data analysis.
• Security Best Practices:
  • Grant API keys only the minimum permissions required to perform their tasks.
  • Use the IP address whitelist feature whenever possible to restrict the sources of API access.
  • Treat your Secret Key as your account password; keep it secure and never disclose it to others.
  • Regularly review and update your API keys, and delete them promptly when they are no longer needed.