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

# Asset Management

> Control which tokens are active on your master wallet

<Note>
  In a nutshell<br />
  Asset Management lets you configure which stablecoins are enabled on your master wallet. Add a new token to start accepting it, remove one to stop, or update its settings. Your wallet only monitors and indexes assets that are explicitly enabled.
</Note>

## Prerequisites

<Steps>
  <Step title="API Key">
    Get your API key from the [Blockradar Dashboard](https://dashboard.blockradar.co). Navigate to **Developers** to generate one.
  </Step>

  <Step title="Wallet Created">
    You'll need a `walletId` to manage assets. Create one via the dashboard or API.
  </Step>

  <Step title="Asset IDs">
    Get the `assetId` for the token you want to add from **Assets** in the dashboard or via the [Get Assets API](/en/api-reference/miscellaneous/get-assets).
  </Step>
</Steps>

## How It Works

When you create a master wallet, it doesn't automatically track every supported stablecoin, only the ones you've explicitly enabled. This gives you precise control over what your wallet accepts and indexes.

Adding an asset to your wallet tells Blockradar to start monitoring incoming transactions for that token, include it in balance queries, and fire webhooks when deposits arrive. Removing an asset stops all of that.

<CardGroup cols={2}>
  <Card title="Add an Asset" icon="plus">
    Enable a new stablecoin on your wallet to start accepting deposits and executing withdrawals in that token.
  </Card>

  <Card title="Remove an Asset" icon="minus">
    Disable a token to stop monitoring it. Existing balances are unaffected — you can re-enable it at any time.
  </Card>

  <Card title="Update Settings" icon="pen">
    Adjust asset-level configuration such as auto-sweep thresholds and gasless transaction settings.
  </Card>

  <Card title="View Active Assets" icon="list">
    Fetch all assets currently enabled on your wallet along with their IDs, symbols, and configuration.
  </Card>
</CardGroup>

## Adding an Asset to Your Wallet

```bash theme={null}
POST /v1/wallets/{walletId}/assets
```

```javascript theme={null}
const asset = await fetch(
  `https://api.blockradar.co/v1/wallets/${walletId}/assets`,
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': apiKey
    },
    body: JSON.stringify({
      assetId: 'asset_usdc_base_mainnet'
    })
  }
).then(r => r.json());

console.log('Asset added:', asset.data);
```

Once added, Blockradar will immediately begin monitoring this token on your wallet.

## Viewing Active Assets

Fetch the list of all assets currently enabled on your wallet, useful for retrieving wallet-specific asset IDs for use in swaps, withdrawals, and other operations.

```bash theme={null}
GET /v1/wallets/{walletId}/assets
```

<Tip>
  Always use the asset IDs returned from this endpoint when calling other APIs. These are wallet-specific asset IDs, not global ones, and they are required for swaps, withdrawals, and balance queries.
</Tip>

## Removing an Asset

Disabling an asset stops Blockradar from monitoring new deposits for that token. It does not affect existing balances or transaction history.

```bash theme={null}
DELETE /v1/wallets/{walletId}/assets/{assetId}
```

<Warning>
  Removing an asset means incoming deposits of that token will no longer be detected or indexed. Make sure you've migrated any existing balance before removing an asset you plan to stop using.
</Warning>

## Updating Asset Settings

You can update asset-level settings such as sweep thresholds and gasless configuration.

```bash theme={null}
PATCH /v1/wallets/{walletId}/assets/{assetId}
```

## Best Practices

* **Only enable what you need** — a focused asset list keeps your wallet clean, reduces noise in webhooks, and makes balance queries faster.
* **Always fetch asset IDs from your wallet** — use `GET /v1/wallets/{walletId}/assets` to get the correct wallet-specific asset IDs before executing swaps or withdrawals.
* **Test on testnet first** — enable and configure assets on testnet before replicating the setup on mainnet.

## API Reference

| Endpoint                                                                     | Description                        |
| ---------------------------------------------------------------------------- | ---------------------------------- |
| [Get Wallet Assets](/en/api-reference/asset/get-wallet-assets)               | List all active assets on a wallet |
| [Add Asset to Wallet](/en/api-reference/asset/add-asset-to-wallet)           | Enable a new token on your wallet  |
| [Remove Asset from Wallet](/en/api-reference/asset/remove-asset-from-wallet) | Disable a token                    |
| [Update Wallet Asset](/en/api-reference/asset/update-wallet-asset)           | Update asset-level configuration   |