Skip to main content
In a nutshell
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.

​
Prerequisites

1

API Key

Get your API key from the Blockradar Dashboard. Navigate to Developers to generate one.
2

Wallet Created

You’ll need a walletId to manage assets. Create one via the dashboard or API.
3

Asset IDs

Get the assetId for the token you want to add from Assets in the dashboard or via the Get Assets API.

​
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.

Add an Asset

Enable a new stablecoin on your wallet to start accepting deposits and executing withdrawals in that token.

Remove an Asset

Disable a token to stop monitoring it. Existing balances are unaffected — you can re-enable it at any time.

Update Settings

Adjust asset-level configuration such as auto-sweep thresholds and gasless transaction settings.

View Active Assets

Fetch all assets currently enabled on your wallet along with their IDs, symbols, and configuration.

​
Adding an Asset to Your Wallet

POST /v1/wallets/{walletId}/assets

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. 
GET /v1/wallets/{walletId}/assets
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.

​
Removing an Asset

Disabling an asset stops Blockradar from monitoring new deposits for that token. It does not affect existing balances or transaction history. 
DELETE /v1/wallets/{walletId}/assets/{assetId}
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.

​
Updating Asset Settings

You can update asset-level settings such as sweep thresholds and gasless configuration. 
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

EndpointDescription
Get Wallet AssetsList all active assets on a wallet
Add Asset to WalletEnable a new token on your wallet
Remove Asset from WalletDisable a token
Update Wallet AssetUpdate asset-level configuration