> ## Documentation Index
> Fetch the complete documentation index at: https://help.chainbook.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Transactions

> View, filter, and manage your crypto transactions

The Transactions view is your central hub for viewing and managing all blockchain activity across your assets.

## Transaction List

The transactions page displays all synced transactions from your assets in a sortable, filterable table.

<Frame>
  <img src="https://mintcdn.com/chainbook/aC-1_m7_TPtV0hLw/images/transactions-list.png?fit=max&auto=format&n=aC-1_m7_TPtV0hLw&q=85&s=9eae1a8a2f60390fee6f54fbab6cfbd6" alt="Transactions list view with filters" width="1920" height="2740" data-path="images/transactions-list.png" />
</Frame>

### Transaction Information

Each transaction shows:

| Column        | Description                                          |
| ------------- | ---------------------------------------------------- |
| **Date**      | When the transaction was confirmed on the blockchain |
| **Amount**    | Transaction value with token symbol                  |
| **Direction** | Incoming (↓) or Outgoing (↑)                         |
| **From/To**   | Sender and recipient addresses or contact names      |
| **Category**  | Assigned category (if any)                           |
| **Wallet**    | Which wallet the transaction belongs to              |

### Transaction Details

Click any transaction to view full details:

* **Transaction Hash** - Unique blockchain identifier
* **Block Number** - Block in which the transaction was confirmed
* **Asset Address** - Which of your assets was involved
* **Network** - TRON or Ethereum
* **Description** - Custom notes you've added
* **Category** - Classification for reporting

## Filtering Transactions

Use filters to find specific transactions quickly.

### Available Filters

<CardGroup cols={2}>
  <Card title="Wallet" icon="folder">
    Show transactions from a specific wallet only.
  </Card>

  <Card title="Category" icon="tag">
    Filter by assigned category.
  </Card>

  <Card title="Contact" icon="user">
    Show transactions involving a specific contact.
  </Card>

  <Card title="Date Range" icon="calendar">
    Filter by custom date range.
  </Card>
</CardGroup>

### Filter by Wallet

To view transactions from a single wallet:

1. Click the **Wallet** dropdown
2. Select the wallet name
3. The list updates to show only that wallet's transactions

### Filter by Date Range

<Steps>
  <Step title="Click the date picker">
    Click the date range selector in the filter bar.
  </Step>

  <Step title="Choose a preset or custom range">
    Select from presets:

    * Today
    * Last 7 days
    * Last 30 days
    * This month
    * Last month
    * Custom range
  </Step>

  <Step title="Apply the filter">
    Click **Apply** to filter the transaction list.
  </Step>
</Steps>

### Filter by Contact

Show transactions involving a specific address:

1. Click the **Contact** dropdown
2. Select a contact from your contact book
3. Transactions with that address as sender or recipient are displayed

### Exclude Small Transactions

<Tip>
  Toggle "Exclude small transactions" to hide dust transactions and focus on significant activity.
</Tip>

Small transactions (below a threshold) can be hidden to reduce noise in your transaction list.

## Editing Transactions

You can add descriptions and categories to any transaction.

### Adding a Description

<Steps>
  <Step title="Click the transaction">
    Select the transaction you want to edit.
  </Step>

  <Step title="Edit the description">
    Click on the description field and enter your notes.

    Example descriptions:

    * "Monthly subscription payment"
    * "Withdrawal to exchange"
    * "Client payment - Invoice #1234"
  </Step>

  <Step title="Save">
    Press Enter or click outside the field to save.
  </Step>
</Steps>

### Assigning a Category

<Steps>
  <Step title="Click the transaction">
    Select the transaction to categorize.
  </Step>

  <Step title="Select a category">
    Click the category dropdown and choose from your categories.

    <Note>
      Create custom categories in Settings → Categories before assigning them.
    </Note>
  </Step>

  <Step title="Category is applied">
    The transaction now shows the assigned category.
  </Step>
</Steps>

## Understanding Transaction Direction

Transactions are classified by direction:

| Direction | Icon    | Meaning                         |
| --------- | ------- | ------------------------------- |
| **IN**    | ↓ Green | Funds received into your wallet |
| **OUT**   | ↑ Red   | Funds sent from your wallet     |

### Internal Transfers

When you transfer between your own tracked assets:

* The sending asset shows an **OUT** transaction
* The receiving asset shows an **IN** transaction
* Both appear in your transaction list

<Tip>
  Use the same category (e.g., "Internal Transfer") for both sides to clearly identify these movements in reports.
</Tip>

## Exporting Transactions

Export your transactions as CSV for accounting or further analysis.

<Steps>
  <Step title="Apply filters (optional)">
    Set any filters to export only specific transactions.
  </Step>

  <Step title="Click Export">
    Click the **Export** button in the top right corner.
  </Step>

  <Step title="Download CSV">
    Your browser downloads the CSV file with all filtered transactions.
  </Step>
</Steps>

### CSV Format

The exported CSV includes:

| Column      | Description                        |
| ----------- | ---------------------------------- |
| Date        | Transaction timestamp              |
| Amount      | Value with sign (+/-) and currency |
| From        | Sender address or contact name     |
| To          | Recipient address or contact name  |
| Description | Your custom notes                  |
| Category    | Assigned category name             |
| Wallet      | Wallet name                        |
| Asset       | Your asset address                 |
| Hash        | Blockchain transaction hash        |

<Info>
  See the [Exporting Data Guide](/guides/exporting-data) for detailed export workflows.
</Info>

## Pagination

Transactions are paginated for performance:

* **50 transactions per page** by default
* Navigate using **Previous** and **Next** buttons
* Page indicator shows current position

<Tip>
  Apply filters to reduce the number of transactions and find what you need faster.
</Tip>

## Transaction States

| State         | Description                                                                               |
| ------------- | ----------------------------------------------------------------------------------------- |
| **Confirmed** | Transaction is finalized on the blockchain                                                |
| **Pending**   | Transaction is not yet confirmed (rare in Chainbook, as we import confirmed transactions) |

<Note>
  Chainbook only imports confirmed transactions. Pending transactions from your wallet are not shown until confirmed.
</Note>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Why are some transactions missing?">
    Possible reasons:

    * Asset is still syncing (check status)
    * Transaction hasn't been confirmed yet
    * Transaction is below the "small transaction" filter threshold
    * Asset address was recently added

    Try a manual sync or wait for the next automatic sync.
  </Accordion>

  <Accordion title="Can I delete transactions?">
    No, transactions cannot be deleted individually. They represent actual blockchain activity. However, you can remove an asset to remove all its transactions.
  </Accordion>

  <Accordion title="How do I find a specific transaction?">
    Use filters to narrow down:

    1. Filter by date when the transaction occurred
    2. Filter by the wallet/asset involved
    3. Filter by contact if you know the other party
    4. Use the search function if available
  </Accordion>

  <Accordion title="Why do amounts look different from my wallet?">
    Chainbook displays raw blockchain amounts with proper decimal handling. Slight differences may occur due to:

    * Different decimal precision display
    * Token decimal configuration
    * Rounding in display vs. actual value
  </Accordion>
</AccordionGroup>