Skip to main content
API · 5-10 min · Spot · Futures · Deposits · Withdrawals · 100+ countries

​
What’s covered

Spot trades

Buy, sell, and conversions.

Futures and Derivatives

Futures positions and derivatives trading.

Deposits and Withdrawals

On-chain deposits and withdrawals.

Trading Fees and Rebates

Fee records and trading rebates.

​
Before you start

BitMEX account

Active account with transaction history.

KoinX account

Free account - no credit card needed.

​
Connect BitMEX to KoinX

API Key syncs your full BitMEX transaction history automatically - no file exports needed.

​
Generate your BitMEX API key

1

Log in to BitMEX

Go to bitmex.com and sign in to your account.
2

Open API Keys

Click the profile icon in the top right corner and select API Keys.
3

Set permissions and create the key

In the API Keys section, select Orders under Key Permissions and click Create API Keys.
Select Orders (read-only) permission only. Never enable withdrawal or broader permissions on an API key connected to a third-party service.
4

Confirm via email

BitMEX will send a confirmation email. Click the confirmation button in the email to activate your API key.
5

Copy your API key and Secret Key

Copy both your API Key and Secret Key and store them securely. The Secret Key is shown only once.

​
Connect BitMEX to KoinX

1

Open KoinX Integrations

Log in to app.koinx.com -> Integrations -> Add Integration.
2

Select BitMEX

Search for BitMEX and select it.
3

Paste your keys and import

Paste your API Key and Secret Key into the respective fields and click Import Now.
Done. KoinX begins syncing your BitMEX history. Large accounts may take a few minutes.
Once your BitMEX data is in, head over to Tax Reports on KoinX - your capital gains, income breakdown, and country-specific crypto tax report are ready for you there.

​
API key notes

  • Email confirmation is required - BitMEX sends a confirmation email after key creation. The key will not work until you click the confirmation link.
  • Secret Key is shown once only - copy it immediately at the time of creation and store it securely.
  • Orders permission is required - this is BitMEX’s read-only configuration for transaction data access.

​
Frequently asked questions

Orders permission only. This is BitMEX’s read-only configuration and gives KoinX access to your full transaction history without the ability to place trades or move funds. Never enable withdrawal or broader permissions on a third-party API key.
BitMEX sends a confirmation email as an additional security step after creating an API key. You must click the confirmation button in the email before the key becomes active. The key will not work in KoinX until this confirmation is completed.
No. BitMEX displays the Secret Key only once at the time of creation. Copy it immediately and store it securely. If lost, delete the key from API Keys and generate a new one.
No. BitMEX does not provide tax-ready reports. By connecting your BitMEX account to KoinX via API key, your full transaction history is imported automatically and a compliant, country-specific tax report is generated within minutes.
Yes. KoinX supports 100+ countries with dedicated report formats for India, the US, UK, Australia, Canada, Germany, and more. After importing your BitMEX data, select your country to generate the correct report.

​
Troubleshooting

Confirm the Orders permission is selected and the email confirmation link was clicked in BitMEX -> Profile -> API Keys. Delete the credentials in KoinX and re-enter both values carefully - copy directly from BitMEX to avoid invisible characters.
Check your registered email inbox for the BitMEX confirmation email and click the confirmation button. The API key will not activate until this step is completed. Check your Spam or Junk folder if the email has not arrived.
Ensure the transaction history covers the full period from your BitMEX account creation date with no gaps. Trigger a manual re-sync from KoinX -> Integrations -> BitMEX. If records are still missing, disconnect and reconnect with a fresh API key.
Check the BitMEX platform for ongoing maintenance. If the platform is operational, verify the key is still active under Profile -> API Keys. Regenerate if expired, re-enter credentials in KoinX, and trigger a fresh sync.
BitMEX API keys can become inactive following account security changes. Log in to BitMEX, check the key status under Profile -> API Keys, and regenerate if inactive. Update the new credentials in KoinX under Integrations -> BitMEX -> Edit.
Check KoinX -> Integrations for duplicate BitMEX connections and remove any extras. If a file was previously uploaded for the same period, delete those transactions before re-syncing via API.

Bybit Integration

Connect Bybit via API key or file upload.

Binance - File Upload

Export Binance CSVs for Spot, P2P, Earn, and Options.

Bitget - API Upload

Connect Bitget via Tax API Key or Normal API Key.

OKX Integration

Sync OKX trades and earn history via API or CSV.

Ready to generate your BitMEX crypto tax report?

Create a free KoinX account - no credit card required. Import your BitMEX transactions and generate a country-specific tax report in minutes.
Last modified on June 18, 2026