API · 5-10 min · Spot · Perpetual Futures · Deposits · Withdrawals · 100+ countries
What’s covered
Spot trades
Buy, sell, and conversions across 400+ pairs.
Perpetual Futures
Perpetual futures contracts and positions.
Deposits and Withdrawals
On-chain deposits and withdrawals.
Trading Fees and Rebates
Fee records and trading rebates.
Before you start
Bitfinex account
Active account with transaction history.
KoinX account
Free account - no credit card needed.
Connect Bitfinex to KoinX
API Key syncs your full Bitfinex transaction history automatically - no file exports needed.- API Key
Generate your Bitfinex API key
Log in to Bitfinex
Go to bitfinex.com and sign in to your account.
Create a new API key and set permissions
Click Create New API Key and set the required read-only permissions.
Confirm via email
Bitfinex will send a confirmation email. Click the confirmation button in the email to activate your API key.
Connect Bitfinex to KoinX
Open KoinX Integrations
Log in to app.koinx.com -> Integrations -> Add Integration.
Done. KoinX begins syncing your Bitfinex history. Large accounts may take a few minutes.
API key notes
- Email confirmation is required - Bitfinex 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.
- Read Only is required - keys with broader permissions may be rejected by KoinX as a security measure.
Frequently asked questions
What permissions does the Bitfinex API key need for KoinX?
What permissions does the Bitfinex API key need for KoinX?
Read Only permissions only. This gives KoinX access to your full transaction history without the ability to place trades or move funds. Never generate an API key with broader permissions for a third-party service.
Why does Bitfinex require email confirmation for API key creation?
Why does Bitfinex require email confirmation for API key creation?
Bitfinex 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 step is completed.
Will Bitfinex show my Secret Key again after I leave the page?
Will Bitfinex show my Secret Key again after I leave the page?
No. Bitfinex 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.
Does Bitfinex provide tax reports directly?
Does Bitfinex provide tax reports directly?
No. Bitfinex does not provide tax-ready reports. By connecting your Bitfinex account to KoinX via API key, your full transaction history is imported automatically and a compliant, country-specific tax report is generated within minutes.
Does KoinX support my country's crypto tax rules?
Does KoinX support my country's crypto tax rules?
Yes. KoinX supports 100+ countries with dedicated report formats for India, the US, UK, Australia, Canada, Germany, and more. After importing your Bitfinex data, select your country to generate the correct report.
Troubleshooting
API key error on connection
API key error on connection
Confirm read-only permissions are set and the email confirmation link was clicked in Bitfinex -> Profile -> API Keys. Delete the credentials in KoinX and re-enter both values carefully - copy directly from Bitfinex to avoid invisible characters.
API key is not working after creation
API key is not working after creation
Check your registered email inbox for the Bitfinex 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.
Transactions are missing after sync
Transactions are missing after sync
Ensure the transaction history covers the full period from your Bitfinex account creation date with no gaps. Trigger a manual re-sync from KoinX -> Integrations -> Bitfinex. If records are still missing, disconnect and reconnect with a fresh API key.
API sync keeps failing
API sync keeps failing
Check the Bitfinex 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.
API connection worked before but stopped syncing
API connection worked before but stopped syncing
Bitfinex API keys can become inactive following account security changes. Log in to Bitfinex, check the key status under Profile -> API Keys, and regenerate if inactive. Update the new credentials in KoinX under Integrations -> Bitfinex -> Edit.
KoinX is showing duplicate Bitfinex transactions
KoinX is showing duplicate Bitfinex transactions
Check KoinX -> Integrations for duplicate Bitfinex connections and remove any extras. If a file was previously uploaded for the same period, delete those transactions before re-syncing via API.
Related integrations
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 Bitfinex crypto tax report?
Create a free KoinX account - no credit card required. Import your Bitfinex transactions and generate a country-specific tax report in minutes.