MetaMask export format
parser live🔒 CSV conversion runs in your browser — files are not uploaded
This is the format reference for MetaMask wallet (Etherscan-family export) — where the file comes from, what each column means, and the export quirks that matter. Our parser reads the layout(s) below and converts it in your browser.
Layout evidence: MetaMask ships no CSV export — its docs direct users to explorer exports. The parsed layout is the Etherscan-family export (same engine as etherscan-csv) — see research/parser-fixture-validation-2026-10.md.
How to export the file
- There is no "Export CSV" inside MetaMask — open the block explorer for your chain (Etherscan for Ethereum mainnet, BscScan, PolygonScan, …).
- Paste your MetaMask 0x… address, open the Transactions or Token Transfers tab, and click "Download CSV Export" at the bottom of the table.
- Keep the 0x… address in the downloaded file name — direction is read from it.
Column reference
Explorer export (the file MetaMask users actually produce)
Four export kinds — transactions, internal txns, ERC-20 transfers, NFT transfers — share the Etherscan-family layout.
| Column | What it means |
|---|---|
Txhash / UnixTimestamp / DateTime | Txid and both timestamp shapes. |
From / To | Counterparties — direction resolved via the filename address. |
Value_IN(ASSET) / Value_OUT(ASSET) / TxnFee(ASSET) | Direction-split native value and gas (transactions export). |
TokenValue / ContractAddress / TokenSymbol | Token leg identity (transfers export). |
Status | Non-empty = failed tx → fee-only spend. |
Format quirks
- MetaMask has no native export — every "MetaMask CSV" is really an explorer CSV, so the format reference is the Etherscan-family layout.
- Direction comes from the filename: your wallet address must appear in the file name or transfer rows stay flagged "other".
- Failed transactions still cost gas — non-empty Status rows become fee-only spends.
- Swap-style multi-leg transactions arrive as separate explorer rows — correlatable by txid but not auto-merged (DeFi reconstruction is out of scope).
Convert this file (1)
| Convert a MetaMask export to the Koinly format | live |
All MetaMask converters · Format reference index · All converters