Skip to main content

Export Trade History

A guide on how to export your trades on Matcha

Updated over a month ago

You can export your trade history from Matcha directly as a CSV file. This is useful for portfolio tracking, accounting, or tax reporting.

Step-by-Step Instructions

  1. Connect your wallet

    • Visit matcha.xyz and connect the wallet you used to trade.

  2. Open Trade History

    • Click the “Trade History” button in the top-right corner of the page.

  3. Export your trades

    • In the Trade History view, click the “Export” button in the top-right corner.

Your trade history will download automatically as a CSV (.csv) file.

Export File Details

  • File format: CSV

  • Maximum records: 12,000 trades per export

  • Timezone: All timestamps are in local time

CSV File Fields Explained

The exported CSV includes the following fields:

  • state – Status of the trade

  • chainID – Blockchain where the trade occurred

  • destinationChainID – Destination chain for cross-chain trades (if applicable)

  • liquiditySource – Liquidity provider used for the trade

Buy details

  • makerAmount – Amount of tokens bought

  • makerToken – Token contract address that was bought

  • makerTokenSymbol – Symbol of the token bought

Sell details

  • takerAmount – Amount of tokens sold

  • takerToken – Token contract address that was sold

  • takerTokenSymbol – Symbol of the token sold

Transaction details

  • timestamp – Time of the transaction (your time zone)

  • transactionHash – On-chain transaction hash

  • volumeUSD – Trade volume denominated in USD

Using Your Trade Export for Tax Reporting

The exported CSV file can be used with many crypto tax and accounting tools, or shared directly with your tax professional. It includes key details commonly required for tax reporting, such as:

  • Tokens bought and sold

  • Trade amounts

  • Transaction timestamps (in local time)

  • Transaction hashes

  • USD-denominated trade volume

Because the export includes both on-chain identifiers and USD volume estimates, it can help simplify capital gains calculations, trade reconciliation, and historical record-keeping.


⚠️ Important: Matcha does not provide tax advice nor does it guarantee the accuracy of the trade records. Always consult a qualified tax professional to ensure your reporting complies with local regulations.

Conclusion

Exporting your trade history from Matcha is a quick and easy way to access detailed records of your activity across supported blockchains. Whether you’re tracking performance, managing accounting records, or preparing for tax season, the CSV export gives you the flexibility to use your data however you need.
​
If you run into any issues exporting your trades or have questions about your history, the Matcha team is here to help.

Did this answer your question?