Skip to main content
Assets are the core data source in Chainbook. Each asset you add is synced automatically to import all historical and new transactions.

Adding Assets

Assets are added through wallets. Each asset belongs to exactly one wallet and inherits the wallet’s network type.
1

Open your wallet

Navigate to Wallets and click on the wallet where you want to add an asset.
2

Click Add Asset

Click the Add Asset button.
3

Enter the asset address

Paste your asset address.
TRON addresses start with T and are 34 characters long.
TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7
Chainbook validates the address format before adding.
4

Start syncing

Click Add to save the asset. Syncing begins automatically.

Asset Syncing

Initial Sync

When you first add an asset, Chainbook performs a full historical sync:
  1. Fetches all transactions - Every transaction involving this address
  2. Processes token transfers - Identifies TRC-20/ERC-20 token movements
  3. Calculates balances - Determines current and historical balances
  4. Indexes data - Makes transactions searchable and filterable
Initial sync time depends on the asset’s transaction history. An asset with thousands of transactions may take several minutes.

Ongoing Sync

After initial sync, assets are updated automatically:
Sync TypeFrequencyWhat’s Updated
RegularEvery 5 minutesNew transactions since last sync
ManualOn demandFull refresh of recent transactions

Manual Sync

To force an immediate sync:
  1. Open the wallet containing the asset
  2. Click the Sync button next to the asset
  3. Wait for sync to complete
Manual sync is useful if you’re expecting a transaction that hasn’t appeared yet.

Asset Information

Each asset displays:
FieldDescription
AddressThe full blockchain address
NetworkTRON or Ethereum
Last SyncWhen the asset was last updated
StatusCurrent sync status
Transaction CountTotal number of transactions

Sync Status Indicators

IconStatusMeaning
🟢SyncedFully up to date
🔵SyncingCurrently importing transactions
🟡QueuedWaiting to sync
🔴ErrorSync failed, will retry

Handling Sync Errors

If an asset shows an error status:
  1. Wait for automatic retry - Chainbook retries failed syncs automatically
  2. Check the address - Ensure the asset address is correct
  3. Manual sync - Try forcing a manual sync
  4. Contact support - If errors persist, reach out to support
Rate limit exceeded
  • Too many requests to blockchain API
  • Automatically resolved within minutes
Network timeout
  • Temporary network connectivity issue
  • Will retry automatically
Invalid address
  • Address format is incorrect
  • Remove and re-add with correct address
If you notice missing transactions:
  1. Wait for sync to complete (check status indicator)
  2. Try a manual sync
  3. Verify the transaction exists on the blockchain explorer
  4. Contact support if the issue persists

Removing Assets

Removing an asset permanently deletes all its transaction data from Chainbook. This action cannot be undone.
To remove an asset:
1

Open the wallet

Navigate to the wallet containing the asset.
2

Find the asset

Locate the asset in the asset list.
3

Click Remove

Click the trash icon or Remove button.
4

Confirm deletion

Click Confirm in the confirmation dialog.

Best Practices

Asset Organization

Group related assets in the same wallet for easier management and reporting.
Good organization:
  • All personal assets in “Personal” wallet
  • All business assets in “Business” wallet
  • Trading assets in “Trading” wallet
Avoid:
  • Mixing personal and business assets
  • Creating too many small wallets

Address Security

Chainbook only tracks public asset addresses. We never ask for or store private keys.
  • Only add addresses you own or have permission to track
  • Asset addresses are visible to anyone with access to the wallet
  • Shared wallets show all asset addresses to all members

Monitoring Multiple Addresses

If you have many addresses to track:
  1. Use consistent naming for wallets
  2. Group by purpose rather than by address
  3. Consider using tags via categories for additional organization
  4. Review limits - Check your plan’s asset limits

Frequently Asked Questions

Yes, you can track any valid public asset address on supported networks. You don’t need to own the asset - Chainbook reads public blockchain data.
No. Chainbook only reads public blockchain data. There’s no connection to the actual asset, and no notification is sent to the asset owner.
Chainbook imports the complete transaction history of each asset, from the first transaction to present.
Currently, you cannot move assets between wallets. You would need to remove the asset from one wallet and add it to another, which means re-syncing the transaction history.