Important Note Before Reading: Some portions of this article may become out of date as TokenTax is always making improvements and updating our software in order to provide the best possible user experience for our clients. If you encounter a situation that may be out of date please reach out to our support via online chat or email ([email protected]) for the most up to date UI information.
The TokenTax web app allows clients to easily maintain and update their crypto data for tax purposes. With our intuitive user interface (UI) they can import their data, review and easily edit your taxable events (reconciliation) across tax years if needed, as well as view their PnL using a variety of specific ID accounting methods, among a number of other useful features and tools. Read further to help ensure maximum savings and filing with absolute confidence.
Table Of Contents:
II a. Tax Guide
III. Documents
IV. Transactions
V. Imports
VI. Profile (For Advanced Reconciliation Plans)
VII. Upgrade
VIII. Settings
Tax Dashboard
The Year Drop Down Menu: "20xx Tax Report"
This menu shows the years for which a user has purchased TokenTax plan(s), along with years they may not have purchased as well. To view the dashboard for a particular year, just click the downward-facing arrow icon and select the year. If a user has not purchased a plan for a particular year the dashboard will be blank.
Main Tax Dashboard Box
The top section of the Tax Dashboard shows the following information, based on the data you currently have imported:
Estimated Tax Liability: The estimated amount you owe based on the crypto data you currently have imported and the general tax rates applied from your settings. Please note that your other (non-crypto) filing information would not be included in this estimate.
Capital Gains/P&L (Profit and Loss): The net profit you have accumulated or loss you have incurred over the course of the tax year.
Short Term Gains: The total amount of gains accumulated throughout the tax year when the sold capital asset’s holding period was a year or less.
Long Term Gains: The total amount of gains accumulated throughout the tax year when the sold capital asset’s holding period was over a year or more
Mining, Staking, & Farming Income: The total amount of crypto income received over the course of the tax year.
Tax Dashboard "Settings" Box
The numbers on your dashboard are calculated using the settings displayed in the “Settings” box on the right hand side of the dashboard:
Home country
Base currency
Short term tax rate
Long term tax rate
Accounting method
These categories will be set based upon the initial intake information we gather about you and your tax year; but you can edit them to reflect your tax bracket and the rules particular to your tax jurisdiction.
The "Recalculate Data” Icon and Button
Located on the top menu bar, and another button on the top right hand side of the Main Tax Dashboard and Settings boxes. When you recalculate your dashboard, you update your dashboard with any recently synced imports, as well as any recent edits or changes that you have made to your data. Certain functions will automatically trigger a recalculation, however, manually triggering a recalculation regularly will ensure that your data displayed is up to date, and it will allow you to successfully generate accurate tax reports.
The colored dot icon in the top bar of your TokenTax account page: If this icon is colored green then you're account is up to date. If it's yellow then that means you will need to recalculate your data. You may engage the recalculation by hovering over or clicking the colored dot and then clicking the “Recalculate" button. This panel will also display the last time your account was recalculated. The other option to recalculate is to click the "Recalculate Data" button located on the main Tax Dashboard page only.
Please note that using this feature will not “refresh” or resync any of the currently imported API’s - this will need to be done in the Imports page.
"Taxable Events" Box
The bottom box of the Tax Dashboard shows a list of the transactions from the selected tax year that have constituted taxable events and triggered capital gains/losses. These are the transactions that will show on your Gain/Loss Report (Form 8949 if you are filing in U.S. tax jurisdictions).
You can filter the transactions on your Taxable Events dashboard by the following criteria:
Date Sold
Date Acquired
Account
Currency
If you click the "+" icon that appears to the right of these filters, you can also select to filter your taxable events by:
Transactions showing a missing cost basis error. Although in some conservative cases it is permissible to file with missing cost basis, for the most accurate (and lowest) P&L and tax liability you should resolve any transactions showing a missing cost basis error.
For more information about the causes of missing cost basis errors, please see our article “How To Fix Missing or $0 Cost Basis”.
Transactions showing zero proceeds. Proceeds are defined as the fiat value of the assets you received from the sale or trade of a cryptocurrency. Zero proceeds are sometimes expected (for example, if you have Margin- perps/derivatives/futures data in your account), but sometimes those transactions need a quick and easy fix (such as fetching the price for a particular token). If you have a question about a transaction that are showing zero proceeds, please reach out to support for assistance.
Beneath the filters panel you will see the total count of your taxable events from the tax year. Here you can click on the arrow at the right hand side to expand each event in order to view more detailed information about the event including your realized gains or losses.
If you’d like for one of our recon specialists to handle your full year's reconciliation and ensure that everything is attributed correctly, please contact support to ask about upgrading to the VIP Plan or Enterprise Plans - depending on your data and needs.
Holdings (Formerly the Tax-Loss Harvesting Dashboard)
The Holdings Dashboard has been improved to show your holdings (according to what is reconciled and imported), while also still being able to list all of your unrealized gains and losses in one place - this way, you can easily tax loss harvest before the end of the calendar year! Please note that in order to tax loss harvest your current year will need to be using the "Minimization" accounting method set. Access to this feature is available with the purchase of any TokenTax Plan for the current year. Please note that, because losses are set at the end of the calendar year, the Tax-Loss Harvesting feature for a prior year will not be achievable after the end of that calendar year and will require a plan for the next calendar year (for example, tax-loss harvesting for the tax year 2023 would be set and unavailable after December 31, 2023).
You can access the Holdings Dashboard by hovering over the dropdown menu next to the word “Tax” at the top left of the web app and selecting “Tax Loss Harvesting”. Once on the Tax-Loss Harvesting Dashboard, you can use the filters to search for losses only, gains only, or to search by token; as well as review your overall imported and reconciled holdings.
Tax-Loss Harvesting Dashboard Columns
The Tax-Loss Harvesting Dashboard shows a list of your unrealized gains and losses from the tax year. This means that you will need to trade these assets away in order to realize losses, which may have the potential to offset your capital gains and lower your tax liability. The following information for each gain - and each loss that you are able to harvest - is shown in the list:
Token
Amount
Total Cost Basis
Price Paid Per Unit
Total Market Value
Current Unit Price
Unrealized Gain/Loss
Amount of Unrealized Losses
Tax Lots
Tax Lots
The Tax Lots column on the far right links to a page showing all tax lots available for the selected token that is imported and reconciled. This list allows you to easily choose the most advantageous tax lot to dispose of, which may allow you to reduce your tax liability as much as possible.
Once you click into a tax lot, you can see the following information:
Token
Amount
Date Acquired
Unit Price
Cost Basis
Unrealized Gain/Loss
Potential Savings
Account
Time to Long Term - Amount of time until the specific token becomes a long-term holding (i.e., 1 month, 9 days).
For general guidance and to learn more about how Crypto Tax-Loss Harvesting, please see our article “Guide To Crypto Tax-Loss Harvesting”. If you are filing in a tax jurisdiction outside of the U.S. and are unsure of how to use this feature, please contact TokenTax support.
Tax Guide
You can access the Tax Guide Dashboard by hovering over the dropdown menu next to the word “Tax” at the top left of the web app and selecting “Tax Guide”. The Tax Guide Dashboard help clients by organizing a list of general 'todos' to work through in order to get their final accurate tax reports.
Documents
In the Document Center you can generate new tax reports for any year for which you have purchased a plan. You may also review prior years generated tax reports as well as review CSV upload history, and securely import your 1099-DA forms.
Generate: To generate your tax report select the report you want from this section and then choose the year, then click generate. The generated report will be in your "History" section.
Overview of reports:
Gains/Loss Report (Form 8949 for those filing in U.S. tax jurisdictions)
We also provide specific formats for certain filing software's such as TurboTax
Form 8949 (CSV version)
Form 8949 (PDF version) - this option will be available early in the year following the year for which you are generating the report (i.e., your 2023 Form 8949 will be available for download in PDF format in early 2024)
Important Note: You cannot generate a PDF version if you have a large volume of taxable events for the year. This would result in a file with 100's of pages and not something you would be able to use to file with. In this case the 8949 CSV version should be used instead.
International Clients: will receive have the CSV report option only
Income Report (mining, staking, airdrops, or other forms of crypto income)
FBAR (Included with the Pro Plan, the VIP Plan, and custom engagement plans. If you are a Basic Plan or Premium Plan user, you can purchase an FBAR report for $49) .
History: This section provides users with a list of all their generated reports from every tax year they've ever generated a report with a TokenTax plan.
CSV Uploads: All of the CSV's that have been imported into your Imports page can be found here.
1099-DA: Secure portal to import your form 1099-DA's that exchanges may have sent you. To compare these proceeds to your TokenTax account proceeds, to ensure they match up, you will want to visit your Recon page, under the last section: Proceeds > Compare Form 1099-DA.
If you have a question about our tax reports, or anything else mentioned in this section, please reach out to TokenTax Support via live chat or email ([email protected]).
Transactions
This page displays all of the historical transactions imported into your account, including taxable events, transfers (deposits and withdrawals) and other transactions.
Filters
There are several filters you can use to narrow down the types of transactions displayed on the All Transactions page, some examples of these are:
Currency
Transaction type
Transaction hash
Contract (to)
From address
Location
Date
Additional filters are viewable if you click the "+" icon to the right of the displayed filters. You may also use several filters at a time in order to accomplish a desired result.
Columns
There are several columns visible on the All Transactions page that display by default.
You also have the option of enabling/disabling columns by clicking the dropdown menu that says “Columns” on the far right and selecting those you would like to have automatically displayed, or deselecting those you would like to have removed.
Other Functions:
Other functions available in this page include
Transaction count: Located underneath the filters is your total transaction that has been imported. Note- this number changes depending on the filters set.
Create New: Located in the top right of this page, this feature option allows users to add in a single transaction manually. This option is for single transaction addition only. For multiple transactions please use our manual CSV instead. You may import that into your Imports page.
Examples of situations where you would add in a transaction would be if you did an OTC trade.
This function is not how you would resolve a Missing Cost Basis issue.
For more information on using or creating a manual CSV along with our template see: Creating a Manual CSV.
Reconciliation
In some circumstances reconciliation may be needed in order to complete your tax report and transactions to be accurately categorized and represented. While TokenTax automatically reconciles a large percentage of your transactions automatically during importing, it is impossible to automate every smart contract or highly complex trades. For information on reconciliation using the Transaction page please review related articles or reach out to support for more information on specific reconciliation needs.
If you’d like for one of our recon specialists to handle your full year's reconciliation and ensure that everything is attributed correctly, please contact support to ask about upgrading to the VIP Plan or Enterprise Plans - depending on your data and needs.
Imports
The Imports page shows all of the imported data, across exchanges and DeFi wallets, currently in your TokenTax account. This is where clients will not only import their data but update their data as well.
You can add a new import by clicking the “Add Import” button in the top right corner. After that you may search/select the platform name, then follow the next steps specific for that platform. Some will have API or CSV options. Some will be either CSV or API only. If your platform is not listed you may import that account using our Manual CSV option.
CSV's:
When importing a CSV, U.S. Filers will also need to select/create an "Account" after choosing the platform, as well. This is to ensure the tax calculations comply with updated IRS regulations.
The majority of CSV files, if properly collected, will sync automatically and show a green dot along with "Synced" in the "Status" column, but it's possible that a file may show a yellow dot with “In Review” as the status. If this is the case, it means that you may need to double check if you've collected a supported CSV; or you may use our Manual CSV option to import those transactions.
If your CSV goes "In Review": In some cases a platform may have changed some part of their export or is an unknown platform, and our CSV team may need to review and format the CSV file. In this case the CSV file must contain the data points that are essential to properly import and calculate your taxes with. For this option you will need to reach out to our support team and they will verify the file and explain the next steps. TokenTax will format a limited number of CSV files per plan year per account for clients. Formatting will typically be processed and synced to your account within 5 business days, and may take longer during peak tax seasons.
For additional guidance on importing your data, please see our article “Importing Your Crypto Data to TokenTax”.
Manage Accounts Button
Mainly for U.S. filers - This button will open a section where users may review the different "Accounts" they've set during importing. In some cases users may need to review/edit their "Accounts" after importing. For example if they have two separate Coinbase accounts, they will need to designate one account as "Coinbase1" and the other as "Coinbase2" for example, since these are two different accounts they would need to be notated and assigned their own "Account" name so that our software can properly track cost basis movements for each account.
For more information on "Accounts" for U.S. filers and how it is essential to filing starting in 2025 and forward please review: "Calculate By Account"
Import 1099-DA Button
This takes you to our secure portal to import form 1099-DA. This form is not the same as your standards imports, but is still needed in order to get the most accurate reporting accomplished. It's important to note that importing this form does not take the place of importing the full transaction dataset into your imports page.
Profile (For Advanced Reconciliation Plans)
If you've purchased the VIP Plan or higher-tier plan, you're required to completely fill out this short questionnaire about your data and tax situation(s) as soon as possible and to the best of your knowledge. It will need to be 100% completed. Once completed the information will be stored.
In addition to the initial completion please be aware that if you purchase our Advanced Reconciliation Plan services again for another tax year then you will need to update your Profile for the new year even If you've filled this out for prior tax years. It would only need to be updated to include newer information.
Completing this is one of the things that will ensure your place in our reconciliation queue and the fastest turnaround time for your reconciliation completion.
Additional Dropdown Options
You can access the Upgrades, Account Settings, and FAQ pages, or sign out of your account by clicking the the downward arrow icon in the upper right hand corner of your account next to the account email address.
Upgrades
On this page you may upgrade any of your existing plans, purchase add-ons for your existing plan(s), or purchase plans or add-ons for other years.
To purchase a plan or add-on from this page, please first make sure to select the tax year for which you need the plan or add-on service. Next, choose the level of plan you would like to purchase. You can see the features included with each plan near the top of the page, and please be sure to click “See All Features” and hover over any "i" icons (at the end of a line item) to ensure that the plan you are purchasing will support all of your transaction types and data complexities. If you aren’t sure which plan you should choose, please contact support and we will be happy to perform a complimentary data assessment and recommend the best plan for you!
The following add-ons are available for purchase once per tax year:
Adding 20,000 Transactions: To your plan limit for the year being purchased only. Please note this is only available for purchase once per tax year.
FBAR Report: This report is included with the Pro Plan, the VIP Plan, and custom engagements. It is available for purchase for $49 for Basic Plan or Premium Plan holders.
To determine whether you need to file an FBAR report, please see our article “FBAR for Crypto”.
Have TokenTax File Your Return: With the purchase of this add-on (starting at $999), our crypto expert tax team will file your state and federal taxes for you. This service is only available for U.S.-based clients with a VIP Plan or above.
If you need a free evaluation, have a complex personal return, or have a business return to file please contact support before purchasing the Full Filing add-on service.
Settings:
Profile - Account Information
Here you will find basic account information inputs such as first and last name, account email address, password, theme- switching to/from Dark Mode, and some other account inputs/settings options.
Tax Details
This page is where you may Lock/Unlock Prior tax years, and update/input the filing accounting methods you've used and other information.
Your Tax Details are important to include, especially the accounting methods, as the methods you have previously used determine how tax lots are allocated from year to year. Keeping track of this information will prevent tax lots from erroneously being used more than once.
For more information on accounting methods, please see our article “Crypto Accounting Methods”.
Locking and Unlocking tax years: Locking your account should be one of the final steps you take after you've completed all updates, recon needs, and generated your reports for the year. Locking a tax year prevents that year’s (and all prior years’) data from being edited or changed. This feature prevents any new or resynced imports from changing the numbers on the dashboard/reports that you may have already filed with in previous years. It will also prevent any edits from being made in prior years.
You are able to lock/unlock any tax year for which you have purchased a plan by checking the box for “enable account locking” then selecting the tax year you would like to lock from the drop down menu. This will also lock all prior years to the year selected as well.
Version History
TokenTax automatically saves account changes after a period of inactivity. To view these save points, or to save a version, clients may head to this area to do this. If you end up making errors in your data accidentally you may review the saved versions and restore your account back to that save point.
Please feel free to reach out to TokenTax Support either via chat or email ([email protected]) if you have any questions or are interested in a free plan assessment!

