Skip to main content
This guide walks you through importing assets into Chainbook and understanding the sync process.

​
Before You Start

Make sure you have:
Your asset address(es) ready to paste
A verified email address — wallet creation requires email verification
Verified the asset is on a supported network (TRON or Ethereum)

​
Step 1: Create a Wallet with Assets

Assets belong to wallets, and both are managed in the same dialog.
1

Go to Wallets

Click Wallets in the sidebar.
2

Click New Wallet

Click the New Wallet button.
3

Name the wallet

Give your wallet a descriptive name — for example “Personal”, “Business”, or “Trading”.
4

Add asset addresses

Each asset row has three fields:
  • Address — the blockchain address to track
  • Network — TRON or Ethereum
  • Token — USDT on TRON; USDT or USDC on Ethereum
Click Add Asset to add another row. A wallet can mix assets from both networks.
TRON addresses start with T and are 34 characters:
5

Create the wallet

Click Create Wallet. Syncing starts automatically.

​
Adding Assets to an Existing Wallet

  1. Go to Wallets
  2. Open the wallet’s edit dialog
  3. Click Add Asset, fill in the new row, and save

​
Address Validation

Chainbook validates each address as you type:
Changing an asset’s network resets its token selection, since each network has its own token list.

​
Step 2: Syncing

​
What Happens During Sync

  1. Initial fetch — Chainbook retrieves the address’s transaction history from the blockchain explorer
  2. Processing — Transactions are processed, classified, and stored
  3. Complete — the asset shows as active
While an asset is syncing, the Wallets page shows a progress percentage.
Assets with thousands of transactions may take a while. You can use other parts of Chainbook while waiting.

​
Sync Status

After the initial import, Chainbook checks for new transactions automatically every 10 minutes. There is no manual sync button — syncing is fully automatic.
Chainbook imports up to 10,000 transactions per wallet. Wallets over the limit pause syncing until the limit is lifted.

​
After Import

Once your assets are synced:

​
View Transactions

  1. Click Transactions in the sidebar
  2. All transactions from your assets appear
  3. Use filters to find specific transactions

​
Add Contacts

Label frequently seen addresses:
  1. Go to Contacts
  2. Click Add Contact
  3. Enter the address and a friendly name
  4. Transactions now show the contact name

​
Set Up Categories

Organize transactions by type:
  1. Go to Transactions and open the category selector
  2. Create categories that match your needs
  3. Assign categories to transactions

​
Troubleshooting

Large addresses with extensive history take longer to sync — blockchain explorer APIs are rate-limited, so history is imported in batches. Progress is shown on the Wallets page; you can leave and come back.
If some transactions don’t appear:
  1. Ensure the initial sync has finished (no progress bar shown)
  2. Check filters aren’t hiding transactions
  3. Verify the transaction is confirmed on the blockchain
  4. Remember that ongoing sync runs every 10 minutes — very recent transactions may not be in yet
  5. Note that only supported token transfers are imported (USDT on TRON; USDT/USDC on Ethereum) — native TRX/ETH transfers and other tokens won’t appear
  6. Contact support if issues persist
Chainbook imports up to 10,000 transactions per wallet. If a wallet reaches the limit, its assets show “Syncing paused”. Contact [email protected] if you need a higher limit.
To fix an incorrect address:
  1. Open the wallet’s edit dialog
  2. Remove the incorrect asset
  3. Add the correct address
Removing an asset deletes its transaction data.
Assets can’t be moved between wallets:
  1. Remove the asset from the wrong wallet
  2. Add it to the correct wallet
  3. Wait for re-sync
Transaction data will be re-imported.

​
Best Practices

​
Organize Before Importing

Plan your wallet structure before adding assets:

​
Verify Addresses

Double-check addresses before adding:
  • Copy directly from your wallet app
  • Verify first and last 4 characters
  • Use a blockchain explorer to confirm

​
Add Contacts Early

Add contacts for known addresses right after import:
  • Makes transaction review easier
  • Improves report readability
  • Enables auto-categorization via contact default categories

​
What’s Next?

After importing your assets:

Categorize Transactions

Organize your transactions with categories.

Add Contacts

Label addresses with friendly names.

View Dashboard

Get insights from your transaction data.

Export Data

Export for accounting or tax purposes.