This guide takes you from your first login to your tax report: what Finbooks does for Portuguese users, how to add your first connection and how to check your data before you generate the reports for your IRS return.
If you are on the free trial, you have 7 days, so we suggest you have your API keys or exported files ready before you start.
What Finbooks does and doesn't do
Finbooks does:
import your transactions from exchanges, wallets and brokers
calculate your capital gains and losses and your crypto income following Portuguese rules
produce precompiled reports with the figures you need to fill in the annexes of your Modelo 3 IRS declaration and, where it applies, your Stamp Duty (DMIS) declaration
apply the FIFO (First In, First Out) method, separately for each asset and for each wallet or exchange, and the 365-day holding rule: crypto sold after being held for at least 365 days is generally exempt from capital gains tax
Finbooks doesn't:
file your tax return for you or send anything to the Portuguese Tax Authority: you use the reports to complete and submit your own declarations
replace tax advice
To learn which crypto transactions are taxable in Portugal, read the Portugal Tax Guide. To see how gains are calculated, read Portugal Cashout methods.
ℹ️ Reports need a paid plan
Tax reports are not available during the free trial or on a free plan, and can only be generated with a paid plan. Everything else, from connections to portfolio, can be tested during the trial. The free trial lasts 7 days from the creation of your account and includes everything except downloading reports. You don't need to enter payment details and you are not charged. If you don't subscribe when the trial ends, your account moves to the free plan. The free plan allows up to 100,000 transactions per year, so in practice the limits are on features, for example you can't download reports. Read Free accounts limitations.
The free trial allows up to 20,000 transactions. The paid plans are Newbie, Enthusiast, Trader and Unlimited, and they differ in the number of transactions you can import. Read Transaction limit criteria and calculation for the limits, and Regular Plan Upgrade to subscribe or change plan.
Step 1: set up your account
Your tax country
Finbooks calculates your taxes according to your tax country. You set it during the initial onboarding of your account, so choose Portugal when you are asked.
Enable crypto and traditional finance
Crypto and traditional investments are managed in separate sections. If you only see one of them, enable the other:
hover your mouse over the name of your plan, then click on Account
click on the Settings tab
scroll down to Manage active investment type
on the line of the section you need, click on Enable
Learn more in How to enable the Crypto section.
Step 2: add your first connection
You can import your data in three ways. Which one you can use depends on the platform:
Method | When to use it | Guide |
API | the platform offers an API connection | |
Native file | Finbooks supports the CSV or Excel file exported by the platform | the connection guide of your platform |
Custom CSV | the platform is not supported natively |
To add a connection:
click on Connections in the left-hand menu
click on Add connection in the top right corner
type the name of your platform in the search field and select it
assign a unique name to the connection
follow the connection guide for your platform: enter the API key and secret, add the public address of your wallet, or upload your file
For files, read How to upload a CSV/Excel file. To see which platforms are supported, check All the connections available on Finbooks.
⚠️ Import your complete history
Import everything from the first day you used each platform, not just recent transactions. Without it, Finbooks can't work out your purchase prices and balances, and your gains can be wrong. In Portugal this also affects the holding period, because the 365-day rule depends on the purchase date. Read Why is it necessary to import the entire transaction history?
ℹ️ Something went wrong?
If your file is rejected, read Why was my CSV file rejected?. If your platform is not supported, read My platform isn't supported: what are my options?.
Step 3: check your data
Once your connections are imported, check that your data is complete before generating anything:
open Transactions and look at the imported transactions for each connection
for file imports, check the Check Import Result step: your files should be Accepted and the Rows count should show the transactions you expect
if you moved crypto between your own wallets or exchanges, link the transfers, otherwise they can show as taxable disposals. Read Why does moving crypto to my own wallet show as a taxable disposal?
check the Action required section for messages, such as Potential transfers, and resolve them
Large API imports can take some time to complete, so let them finish before checking your numbers.
Step 4: generate your report
When your data looks right, you can request the report. Reports require a paid plan, and all paid plans, including Human, can generate them. You can generate reports for any tax year that has transactions in your account.
click on Reports from the main menu on the left
click on the Download a report button at the top right
choose the type of report and the year/period. The reports available for Portuguese accounts are:
Tax return (IRS 3), the precompiled report with the figures for the annexes of your Modelo 3 IRS declaration
Stamp Duty, the precompiled report for the Stamp Duty DMIS declaration
Fees, read Fees report
Capital Gain, read Capital Gain report
Explanatory Notes, read Financial Statement Report
Income, read Income Report
Stock, read Stock report
Transactions, read All Transactions report
choose the format, PDF or CSV
enter the email address where you want to receive the report
click on the Request button, then click on Continue in the modal
when the report is ready, click on Download next to it in the report list
For the download rules, read How to request Finbooks reports.
🚨 Downloading a report ends your right of withdrawal
If you subscribe and then change your mind, you can ask for a refund within 14 days of your first payment, but only if you haven't downloaded any report. Once you download one, the service is considered delivered. Read Right of withdrawal.
Step 5: complete your IRS declaration
The precompiled figures for the annexes of the Modelo 3 IRS declaration come from the Tax return (IRS 3) report. Stamp Duty has its own report, Stamp Duty, which corresponds to the DMIS declaration. You can use the figures directly in your official filings.
Annex G, capital gains on crypto held for less than 365 days, through Portuguese platforms or non-custodial wallets
Annex G1, tax-exempt capital gains on crypto held for 365 days or more
Annex J, staking and mining income generated abroad, and capital gains on foreign platforms for crypto held for less than 365 days
Annex B, staking and mining income, for business or professional activity
Annex E, other crypto income, for example lending rewards received in fiat currency
Stamp Duty (DMIS), only in specific cases, such as fees paid to crypto service providers or crypto received for free, declared monthly
The IRS declaration must be submitted between 01 April and 30 June. Taxes are paid by 31 August.
Read Portugal - Tax Returns for the tables, the information you need to declare for each transaction and the Stamp Duty filing instructions.
Need help?
If you get stuck, contact Finbooks Support by chat or at customer.support@finbooks.com.
