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

# Asset and Balance Changes

> Access token data and dollar value changes from the asset_changes object returned by Simulation API and Transaction Trace.

Both the RPC and API simulation responses provide information about the asset and balance changes that have occurred converted into dollar values. The displayed dollar value represents the **current dollar value** and reflects the most recent market data sourced from [CoinGecko](https://www.coingecko.com/).

Supported token standards: **ERC20** and **ERC721**.

### RPC response

Asset and balance changes are always returned as part of the response when you call both the `tenderly_simulateTransaction` (single simulation) and the `tenderly_simulateBundle` (bundled simulations) RPC methods. See the [RPC Reference](/node-rpc/rpc-reference).

```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
https://mainnet.gateway.tenderly.co/${TENDERLY_NODE_ACCESS_KEY}
```

Follow these paths to access this information:

* **Asset Changes**: Look under `result.assetChanges`. This will provide a breakdown of how assets have been altered or moved during the transaction.
* **Balance Changes**: Find these under `result.balanceChanges`. This offers insights into the balance fluctuations in token and dollar values.

**Example response**

```json title="example.json" showLineNumbers theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{
  "assetChanges": [
    {
      "assetInfo": {
        "standard": "ERC20",
        "type": "Fungible",
        "contractAddress": "0xc02...c2",
        "symbol": "weth",
        "name": "WETH",
        "logo": "https://assets.coingecko.com/coins/images/2518/large/weth.webp?1696503332",
        "decimals": 18,
        "dollarValue": "2195.8701171875"
      },
      "type": "Transfer",
      "from": "0xd8...45",
      "to": "0x20...d6",
      "rawAmount": "0x1",
      "amount": "0.000000000000000001",
      "dollarValue": "10.0071875"
    }
  ],
  "balanceChanges": [
    {
      "address": "0x20...1d6",
      "dollarValue": "0.0000021958701171875",
      "transfers": [
        0
      ]
    },
    {
      "address": "0xd8...045",
      "dollarValue": "0.00021958701171875",
      "transfers": [
        0
      ]
    }
  ]
}
```

### API response

Asset and balance changes are also returned as part of the API response when you call the `simulate` (single simulations) endpoint:

```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
https://api.tenderly.co/api/v1/account/${TENDERLY_ACCOUNT_SLUG}/project/${TENDERLY_PROJECT_SLUG}/simulate
```

and `simulate-bundle` (bundled simulations) endpoint:

```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
https://api.tenderly.co/api/v1/account/${TENDERLY_ACCOUNT_SLUG}/project/${TENDERLY_PROJECT_SLUG}/simulate-bundle
```

In the API response, the structure is similarly intuitive:

* **Asset Changes**: Find `transaction.transaction_info.asset_changes`. Here, you'll find details like the type of change (transfer, mint, burn), involved addresses, and the amount in both the token and its dollar value.
* **Balance Changes**: Find `transaction.transaction_info.balance_changes`. This section will show you how balances have shifted as a result of the transaction in token and dollar terms.

**Example response**

```json title="example.json" showLineNumbers theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{
  "asset_changes": [
    {
      "token_info": {
        "standard": "ERC20",
        "type": "Fungible",
        "contract_address": "0xc02...c2",
        "symbol": "weth",
        "name": "WETH",
        "logo": "https://assets.coingecko.com/coins/images/2518/large/weth.webp?1696503332",
        "decimals": 18,
        "dollar_value": "2195.8701171875"
      },
      "type": "Transfer",
      "from": "0xd8...045",
      "to": "0x20...d6",
      "amount": "0.000000000000000001",
      "raw_amount": "1",
      "dollar_value": "0.0000000000000021958701171875"
    }
  ],
  "balance_changes": [
    {
      "address": "0x20...d6",
      "dollar_value": "0.0000000000000021958701171875",
      "transfers": [
        0
      ]
    },
    {
      "address": "0xd...045",
      "dollar_value": "-0.0000000000000021958701171875",
      "transfers": [
        0
      ]
    }
  ]
}
```

For more information, consult the [API reference](/api-reference) and [RPC references](/node-rpc/rpc-reference?network=ethereum-mainnet\&method=tenderly_simulateTransaction).