What are Contacts?
Contacts are your address book for blockchain addresses. Instead of seeing:
Benefits of Using Contacts
Readable Transactions
Instantly recognize who you’re transacting with.
Better Reports
Exports and charts show names instead of addresses.
Quick Filtering
Filter transactions by contact name.
Pattern Recognition
Spot trends with specific partners over time.
Managing Contacts
Creating a Contact
1
Navigate to Contacts
Click Contacts in the sidebar.
2
Click Add Contact
Click the Add Contact button.
3
Enter contact details
The address can be from any supported network (TRON or Ethereum).
4
Save
Click Create to add the contact.
The contact name now appears everywhere this address is referenced.
Editing a Contact
- Go to Contacts
- Find the contact you want to edit
- Click the Edit button (pencil icon)
- Update the name or address
- Click Save
Changing a contact’s name updates it throughout all historical transactions.
Deleting a Contact
- Go to Contacts
- Find the contact to remove
- Click the Delete button (trash icon)
- Confirm deletion
Where Contacts Appear
Once you create a contact, the name replaces the address in:Contact Organization Tips
Naming Conventions
Use consistent naming patterns: For businesses/exchanges:Important Addresses to Add
Consider adding contacts for:- Exchanges - Your deposit/withdrawal addresses
- DeFi protocols - Router and pool addresses
- Clients/Customers - People who pay you
- Vendors - Services you pay
- Your other wallets - Wallets not tracked in Chainbook
- Team members - Colleagues’ wallet addresses
Multi-Network Contacts
The same entity might have addresses on different networks:Create separate contacts for each network, even for the same entity.
Filtering by Contact
Once contacts are set up, filter your view:1
Open Transactions
Navigate to the Transactions page.
2
Click the Contact filter
Find the Contact dropdown in the filter bar.
3
Select a contact
Choose from your contact list.
Only transactions involving this contact are displayed.
- Track all payments to/from a client
- Review your exchange activity
- Monitor transactions with a specific vendor
Contacts in Reports
Dashboard Charts
The “Chart by Contacts” shows:- Transaction volume per contact
- Your top transaction partners
- Distribution of activity
Exports
When you export transactions:- The “From” column shows contact names (when available)
- The “To” column shows contact names (when available)
- Raw addresses appear for unknown addresses
Bulk Import
For importing many contacts at once:Bulk import is available for Team plan users. Contact support for assistance with CSV imports.
Privacy Considerations
Contact information is private to your account. Team members you invite can see contacts for shared wallets.
- ✅ Visible to you and your team members
- ✅ Included in exports you download
- ❌ Not shared publicly
- ❌ Not visible to the address owner
Frequently Asked Questions
Can I add any address as a contact?
Can I add any address as a contact?
Yes, you can add any valid wallet address as a contact, even if you don’t track it or own it. This helps identify counterparties in your transactions.
What if the same address has multiple purposes?
What if the same address has multiple purposes?
An address can only have one contact name. Choose the most relevant name, or use a generic description like “Binance - Mixed Use”.
Do contacts sync across wallets?
Do contacts sync across wallets?
Yes, contacts are account-wide. A contact created in one wallet appears in all your wallets that interact with that address.
Can I see an address's full history from the contact?
Can I see an address's full history from the contact?
The contact page shows all transactions involving that address across all your wallets. Use the Contact filter on the Transactions page for a detailed view.
Are exchange deposit addresses safe to add?
Are exchange deposit addresses safe to add?
Yes. Adding an exchange address as a contact just labels it for your reference. It doesn’t affect the exchange or expose any information.