All Collections
Getting started with TokenTax
The TokenTax User Interface Guide
The TokenTax User Interface Guide

Keep reading to learn more about how our software can help you reduce your crypto tax liability and file with absolute confidence.

Oat avatar
Written by Oat
Updated over a week ago

The TokenTax web app allows you to easily maintain and update your crypto data. With our intuitive UI you can review and easily edit your taxable events across tax years, as well as easily view your PnL using a variety of specific ID accounting methods. Our unique features, such as our proprietary Minimization algorithm, help to ensure you maximize savings and file with absolute confidence.

Table Of Contents:

VI. Recon Profile (For Advanced Reconciliation Plans)


Tax Dashboard

The Year Drop Down Menu: "20xx Tax Report"

This menu shows the years for which you have purchased TokenTax plans. To view your dashboard for a particular year, just click the downward-facing arrow and select the year you would like to see.

Accounting Method/Cost Basis Method Tabs

The Tax Dashboard allows you to toggle through the following accounting methods. Each treats your crypto data in a fundamentally different manner:

  • FIFO (First In, First Out)

  • LIFO (Last In, First Out)

  • Minimization (TokenTax proprietary algorithm)

  • Average Cost (For some international clients)

For more information on accounting methods, please see our article “Crypto Accounting Methods: FIFO, LIFO, HIFO, & More”.

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 information we gather about your situation, but you can edit them to reflect your tax bracket and the rules particular to your tax jurisdiction.

The "Recalculate Data” Button

Please bear in mind that you will need to recalculate your Tax Dashboard after any time you edit or import data by clicking the “Recalculate Data" button. When you Recalculate your dashboard, you bring in any recently synced imports, as well as any recent edits or changes that you have made to your data. Recalculating your dashboard regularly will ensure that your data displays correctly, and it will allow you to successfully generate your tax reports. Please note that using this feature will not “refresh” or resync your API’s - you will need to do this on your Imports page.

When a recalculation is needed you will see a small notification on your dashboard in the lower right hand corner. You can recalculate by either clicking this notification, or by clicking the “Recalculate” button at the top right of the 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:

  • Currency

  • Date Sold

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 it is permissible to file with missing cost basis, for the most accurate (and lowest) P&L and estimated 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”. You can also find step-by-step instructions for reconciling these transactions in our article “How To Add and Edit DeFi Transactions”.

  • 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/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 is 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 all of your manual reconciliation and ensure that everything is attributed correctly, please contact support to ask about upgrading to the VIP Plan.


Tax-Loss Harvesting Dashboard

The Tax-Loss Harvesting Dashboard lists all of your unrealized gains and losses in one place - this way, you can easily harvest any losses before the end of the calendar year! Access to this feature is only available starting with the purchase of a Premium Plan for the current year. Please note that, because losses are set at the end of the calendar year, the Tax-Loss Harvesting Dashboard for a particular year will not be visible 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 Tax-Loss Harvesting 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 filter feature to search for losses only, gains only, or to search by token.

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. This list allows you to easily choose the most advantageous tax lot to dispose of, which will 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

  • 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 2023”. 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.


Documents

In the Document Center you can generate tax documents for any year for which you have purchased a plan. To get started just choose the year, then select the type of document you would like to generate. The most commonly used documents are listed at the top:

  • Gains/Loss Report (Form 8949 for those filing in U.S. tax jurisdictions)

  • Income Report

  • 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)

You can also generate the following documents by clicking the “Generate Documents” button near the top of the page:

  • Form 8949 (CSV)

  • Form 8949 (PDF) - 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)

  • Form 8949 TurboTax (CSV) - For clients filing using TurboTax online

  • Income Report (CSV)

  • Other optional forms

If you have a question about our tax reports, please reach out to TokenTax Support via live chat or email ([email protected]).


All 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:

  • 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.

Columns

There are several columns visible on the All Transactions page that display by default:

  • Transaction type

  • Buy amount

  • Buy currency

  • Sell amount

  • Sell currency

  • Fee (if applicable)

  • Fee currency (if applicable)

  • Location

  • Credential (this is the import through which the transaction is being pulled in)

  • Date

  • Transaction hash (if applicable)

  • Method ID (if applicable)

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.

The "Export" Button

The “Export” button allows you to export all of the transactions on your All Transactions page (or a subset of them) in CSV format.


Imports

The Imports page shows all of the imports currently in your account. Each import shows:

  • Its label (if applicable)

  • Its address (if applicable)

  • The date range of the transactions it contains

  • The number of transactions it contains

  • Its syncing status

  • The date it was last updated

  • Its type (API, CSV, or manual entry)

You can add a new import by clicking the “Add New” button in the top right corner.

Adding a New API

If you are syncing an API, you can begin by typing the name of the platform in the search field and clicking it when it comes up. This will take you to a page where you can enter your credentials in order to sync the API. Please note that it is normal for some APIs to take a few moments (or more) to sync if the wallet address has a higher transaction volume.

Adding a New CSV

To add a new CSV, scroll down and click “Add CSV” - this will take you to a page where you can attach the file you would like to upload. Please note that we only accept CSV format and certain supported xlsx file formats.

The “Add a New CSV” page also shows a list of all of the files that have historically been uploaded into your account in the lower box. This list is different from the main Imports page. Only the main imports page will show imports that are currently pulling data into your account. The historical imports list will include all files that you have attempted to import.

Although many CSV files sync automatically, it is possible that a file may show a yellow dot next to the words “In Review”. If this is the case, it means that our CSV team needs to format the file, and we anticipate that it should be processed and synced to your account within 72 hours.

If you attempt to upload an unsupported CSV and receive an error message, this means that the file is not formatted correctly, or is not usable. If this is the case, do not worry - we can still support this data via our manual CSV template. Please use the template and guidelines in our article “Create a manual CSV report of your transactions” and upload the file by following the steps to add a new CSV outlined above.

Adding a New Manual Entry

If you just need to add one transaction or a few, you have the option of importing this data by manual entry. To create a manual entry, navigate to your Imports page, click “Add New” in the top right corner, scroll down below where it says “Add CSV”, and click the link that says “Add Manual Transaction”. This will open a window where you can enter the transaction details.

For additional guidance on importing your data, please see our article “Importing Your Crypto Data to TokenTax”.


Recon Profile (For Advanced Reconciliation Plans)

If you purchased a VIP Plan or higher-tier plan, we require that you thoroughly fill out this short questionnaire about your data as soon as possible. This will ensure your place in our queue and the fastest turnaround time for your reconciliation completion.

Once filled the information will be stored and the profile will not need to be completed again should you have an Advanced Reconciliation plan again in a future year. It would only need to be updated to include the updated information.


Settings

You can access the Upgrades, Account Settings, and FAQ pages by clicking the three white lines in the upper right hand corner of your account (next to your account email address).

Upgrades

On the Upgrades page you can 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 select the tax year for which you need the plan. 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” to ensure that the plan you are purchasing will support all of your data. 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:

  • Margin Processing: This service is $399 and includes processing of margins, derivatives, and futures data. Please note that support for processing of certain complex data platforms may require an upgrade to the Pro Plan or VIP Plan. For example: dYdX and other on-chain margin/derivatives/futures data will require the VIP Plan at minimum. If you have any questions, or need a free evaluation, please contact support.

  • 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: Regulations for 2023”.

  • 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.

  • 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.

Account Details

Here you will find your first and last names as entered in your account, along with the email address associated with your account. For peak performance of our login security features, we recommend that you change your password as few times as possible.

Tax Details

The Tax Details page is also where you will enter the filing accounting methods you used in previous years. It is important to include this information, as the filing 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.

This page also shows which tax years are currently locked. Locking a tax year prevents that year’s (and all prior years’) data from being changed. This feature prevents any new or resynced imports from changing the numbers on the dashboard or reports that you may have already filed with in previous years.

Locking years/method

You are able to lock/unlock any tax year for which you have purchased a plan by clicking “Update” next the tax year you would like to change, selecting/deselecting the checkbox, and clicking the “Update” button at the bottom of the pop up window. This step should also be completed once you have generated your forms to file for the year.

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!

Did this answer your question?