Exporting your transaction history from the CoinEx exchange
If you use CoinEx and you need to export your history so your CryptoImpuestos specialist can work out your crypto tax, this guide explains what to download and how.
We cover two methods: downloading the CSV files by hand, and connecting through a read-only API key.
Important: for a complete tax review, the ideal is to hand over both the CSV files and the read-only API key. The CSV carries the history as CoinEx exports it; the API key helps us verify the data and the balances.
Why you need your CoinEx history
To work out the gains and losses on your tax return correctly, you have to reconstruct every transaction:
- the date of each purchase, sale, conversion or swap
- the amount of crypto received and given
- the market value at the time of the transaction
- the fees paid
- deposits, withdrawals and transfers between accounts
CoinEx operates as an international exchange. If you hold crypto on CoinEx, it should be reviewed as a foreign exchange for Modelo 721 purposes, particularly if your combined value on foreign exchanges exceeds €50,000 on 31 December.
Which files you need
For a complete, Koinly-style extraction, you need to download these files from CoinEx:
| File | Path in CoinEx | When it is needed |
|---|---|---|
| Deposit Records | Assets > Spot > Deposit Records | Always |
| Withdrawal Records | Assets > Spot > Withdrawal Records | Always |
| Spot history | Assets > History > Spot Trades | If you have bought or sold on spot |
| Margin history | Assets > History > Margin | If you have used margin trading |
| Futures history | Assets > History > Futures | If you have used futures |
Important: the date range has to cover your entire history on CoinEx, not just the year you are declaring. If an earlier year is missing, the FIFO calculation may come out incomplete.
CoinEx also offers a general tax export under Assets > History > Export Data, which produces a ZIP with CSV files for Spot, Margin, Futures and the Financial Account. It is useful as a backup, but for tax reconciliation you should also download the specific deposit, withdrawal and trade files.
Method 1: CSV export
Step 1: sign in to CoinEx
- Open your browser and go to coinex.com
- Sign in to your account
- Complete the security check if CoinEx asks for it
Step 2: export your deposits
- In the top right-hand corner, choose “Assets”
- In the left-hand menu, under Overview, open Spot
- Select “Deposit Records”
- Choose a date range covering your entire history on CoinEx
- Click “Export” and save the file
Step 3: export your withdrawals
Repeat the same process for withdrawals:
- Go to Assets > Spot
- Open “Withdrawal Records”
- Select the same full date range
- Click “Export”
- Save the file without opening or modifying it
Step 4: export your spot history
- In the top right-hand corner, open “Assets”
- In the dropdown, choose “History”
- CoinEx takes you to the history. By default you will usually land on the Spot Trades section
- Choose a date range covering your entire history
- Click “Export”
- Save the CSV file it produces
Step 5: export margin and futures if you have used them
If you have traded on margin or futures, the spot history alone is not enough.
- From Assets > History, use the left-hand menu
- Switch the history type to Margin or Margin History
- Select the full range and export the file
- Repeat the process for Futures or Futures History
Note: if you have never used margin or futures, there is no need to generate empty files. If you are not sure, check both sections in case there are old movements.
Step 6: CoinEx’s general tax export
As an extra check, CoinEx lets you export tax data under Assets > History > Export Data.
On that screen you can select:
- Time Range: your entire history
- Account Type: every account available
- Asset Type: every asset
- Export the file
Once CoinEx finishes generating the export, you get a notice by email and as a message inside the platform. Download the ZIP and send it along with the earlier CSV files if your specialist asks for it.
Important: do not open or modify the CSV files before sending them to us. Opening them in Excel can alter dates, decimals or symbols.
Limits worth knowing
| Limit | Detail |
|---|---|
| Records available | CoinEx keeps up to the 50,000 most recent entries in the exportable history |
| Monthly exports | Six exports per calendar month at most |
| Link validity | The download link is valid for seven days |
| Files needed | Deposits, withdrawals, spot, margin and futures have to be downloaded separately if you used those sections |
| General tax export | CoinEx’s official ZIP separates Spot, Margin, Futures and the Financial Account |
| Dormant accounts | These can produce empty CSV files |
| CoinSet / LP | CoinSet or liquidity transactions may need manual reconstruction if the file does not report the number of shares |
Plan your exports before requesting them, especially if you have many years of activity or a high volume of transactions.
Method 2: connecting by API
A read-only API key allows account and trading information to be read without granting any permission to trade or withdraw funds.
Step 1: open API Management
- Sign in at coinex.com
- In the top right-hand corner, choose “Account” or your account icon
- In the dropdown, open “API Management”
Step 2: create a new API key
- Click “Create API”
- Add a recognisable name, for example “CryptoImpuestos”
- Enter your TOTP code or whichever verification code CoinEx asks for
- Confirm the creation
Security: do not switch on trading or withdrawal permissions. A tax review needs read access and nothing else.
Step 3: copy the credentials
Once CoinEx has created the key, copy the following securely:
- API Key or Access ID
- API Secret or Secret Key
Send those credentials to your CryptoImpuestos specialist through the secure channel they point you to.
Note: newly created API keys can take a few minutes to become active. If an error appears right after creating them, wait and try again.
Limits of the CoinEx API
The API does not always deliver the full tax history. According to the limitations Koinly lists for CoinEx, some transactions may fail to import because CoinEx does not supply them over the API:
- instant swaps
- airdrops
- referral commissions
If you have had any of those movements, let your specialist know so they can be added by hand from whatever documentation is available.
Screenshots of your balances
Besides the CSV files and the API key, screenshots of your balances may be needed if you hold funds across several accounts or subaccounts:
- Spot Account
- Margin Account
- Futures Account
- Financial Account / Earn
- AMM or any other section holding a balance
- Subaccounts, if you use them
Take screenshots where the amounts, the currencies and the date are clearly visible. This helps us review your holdings, closing balances and any possible Modelo 721 obligation.
Frequently asked questions
Does CoinEx let you export the whole history?
CoinEx allows exports from several sections, but its general tax export states a limit of the 50,000 most recent entries. If your account exceeds that volume, tell your specialist so they can weigh up section-by-section exports, partial ranges or a request to CoinEx support.
How many times can I export data?
CoinEx allows up to six exports per calendar month. Once you hit the limit, you have to wait for the following month.
How long does the download link last?
The download link lasts seven days. Download the ZIP as soon as CoinEx notifies you.
Do I need the CSV or the API?
Whenever possible, hand over both. The CSV preserves the official export as downloaded, and the API key allows the information to be cross-checked automatically.
Which files must not be missing?
At the very least, download Deposit Records, Withdrawal Records and the spot history. If you have used margin or futures, add the margin history and the futures history too.
Can a read-only API key move funds?
No. A key set up in read-only mode allows data to be read, but it cannot trade or withdraw crypto.
What about instant swaps, airdrops or referrals?
Koinly notes that the CoinEx API does not supply instant swaps, airdrops or referral commissions. If you have had those movements, they will have to be added by hand using statements, screenshots or your own records.
What do I do about CoinSet or liquidity transactions?
If the file does not report the number of shares, those transactions may not import correctly and will have to be reconstructed by hand. Send us any additional CoinEx screenshot or statement so we can review it.
Is CoinEx a foreign exchange for Modelo 721?
In practice, CoinEx should be reviewed as a foreign exchange. If your combined holdings on foreign exchanges exceed €50,000 on 31 December, check whether you are required to file Modelo 721.
Summary
| Step | Action |
|---|---|
| 1 | Go to coinex.com and sign in |
| 2 | Open Assets > Spot > Deposit Records and export your entire history |
| 3 | Repeat under Assets > Spot > Withdrawal Records |
| 4 | Go to Assets > History and export the spot history |
| 5 | If you have used margin or futures, export the margin history and the futures history too |
| 6 | Optionally, download the tax ZIP from History > Export Data |
| 7 | Create a read-only API key under Account > API Management if your specialist asks for one |
| 8 | Send the CSV files, the API key and the balance screenshots without modifying anything |
Need help with your CoinEx history?
At CryptoImpuestos we help you obtain your CoinEx history — walking you through it step by step if you get stuck — then process it, work out every gain and loss using the FIFO method and prepare your tax return.
Get in touch and we will take it from there.
Víctor Lázaro
Tax adviser, Cryptoimpuestos.es
