跳转到主要内容
If you’ve ever sent tokens to the correct address but on the wrong blockchain, you know that gut-drop moment when it feels like your funds have vanished. With Blockradar Asset Recovery, getting your tokens back is possible and simpler than you might think. With Blockradar Asset Recovery, you can:
  • Recover native tokens on all supported blockchains
  • Recover custom tokens (ERC-20 and other compatible assets) on supported networks
  • Recover tokens on unsupported or custom networks by providing your own RPC endpoint
  • Recover tokens on Layer 2 networks (Arbitrum, Optimism, Base, and other EVM-compatible rollups)

Prerequisites

Before starting a recovery, have the following information ready:
FieldDescription
Recovery BlockchainThe blockchain where the lost tokens currently reside (e.g. Ethereum, BNB Chain, Polygon)
Token Contract AddressRequired only for custom (non-native) tokens
Recover From AddressThe Blockradar address that accidentally received the tokens
Recover To AddressThe address where recovered assets should be sent

Recovering via the Dashboard

Step 1: Retrieve Transaction Information

If you’re missing any recovery details, look up your transaction hash on the relevant blockchain explorer and note:
  • The blockchain network used
  • The receiving address (your Blockradar address)
  • The token contract address (for custom tokens)
  • The amount transferred
OpBNB custom token on BNB chain Bitcoin custom token on BNB chain

Step 2: Fill in Recovery Details

On your Blockradar dashboard, navigate to Asset Recovery and fill in the required fields. For native tokens: Native token recovery form For custom tokens: Custom token recovery form
Ensure your wallet has enough native token balance to cover gas fees for the recovery transaction.

Step 3: Submit Recovery

  1. Click Recover Assets
  2. Enter the OTP from your authenticator app
  3. Confirm the action
Once completed, verify the recovery by checking the destination address in your dashboard or searching the transaction hash on the block explorer for the selected chain.

Recovering via a Custom RPC or Layer 2 Chain

If your lost assets exist on a blockchain not officially supported by Blockradar, you can recover them using a custom RPC URL. Additional prerequisites:
FieldDescription
RPC EndpointA valid HTTPS RPC URL for the blockchain you’re recovering from. Free RPC endpoints are available from PublicNode.
Layer 2 NetworkEnable this toggle if the RPC URL points to an L2 chain (Arbitrum, Optimism, Base, etc.)
Steps:
  1. Enable Use Custom RPC
  2. Select the Master Wallet associated with your recovery address
  3. Paste your RPC URL
  4. Toggle Layer 2 Network if applicable
  5. Fill in all other fields as described above
  6. Click Recover Assets, verify OTP, and confirm
Custom RPC recovery form

Recovering via the API

You can also recover assets programmatically using the Asset Recovery API — ideal for building custom flows or integrating recovery into backend systems.

Required Parameters

ParameterDescription
walletIdYour Blockradar master wallet ID
blockchainIdThe unique ID of the blockchain the transaction was performed on
senderAddressThe Blockradar address holding the lost token
recipientAddressThe address to send the recovered token to
amountAmount of the token to recover
tokenAddressSmart contract address of the token (custom tokens only)
rpcUrlRPC endpoint for unsupported networks (optional)
isL2Whether the RPC points to a Layer 2 chain (optional)

Step 1: Estimate the Network Fee

Before initiating recovery, estimate the gas cost:
curl --request POST \
  --url "https://api.blockradar.co/v1/wallets/{walletId}/salvage/network-fee" \
  --header "Content-Type: application/json" \
  --header "x-api-key: <api-key>" \
  --data '{
    "amount": "2.5",
    "blockchainId": "<BLOCKCHAIN_ID>",
    "senderAddress": "0xYourBlockradarAddress",
    "recipientAddress": "0xRecipientAddress",
    "tokenAddress": null
  }'
Response:
{
  "data": {
    "balance": "0.1",
    "fee": "0.000021"
  },
  "message": "Salvage network fee fetched successfully",
  "statusCode": 200
}
For custom tokens, include "tokenAddress": "0xTokenContractAddress" in the request body.

Step 2: Execute the Recovery

After confirming the fee and available balance, initiate the recovery:
curl --request POST \
  --url "https://api.blockradar.co/v1/wallets/{walletId}/salvage" \
  --header "Content-Type: application/json" \
  --header "x-api-key: <api-key>" \
  --data '{
    "amount": "2.5",
    "blockchainId": "<BLOCKCHAIN_ID>",
    "senderAddress": "0xYourBlockradarAddress",
    "recipientAddress": "0xRecipientAddress",
    "tokenAddress": null
  }'

Step 3: Monitor Recovery Status

Listen for these webhook events to confirm the outcome:
EventDescription
salvage.successRecovery completed successfully
salvage.failedRecovery failed

Troubleshooting

If you run into issues, check the following:
  • Wrong wallet ID — make sure you’re using the master wallet ID, not a child address ID
  • Missing token contract address — required for all custom (non-native) tokens
  • Insufficient gas — ensure your master wallet has enough native token to cover the recovery fee
  • Custom RPC issues — verify the RPC URL is a valid HTTPS endpoint and that the L2 toggle matches the chain type

Security Notes

  • Blockradar is non-custodial — you control keys and policies
  • Every recovery is an on-chain transaction that requires gas on the source chain
  • OTP is required for all recovery actions on the dashboard

API Reference

EndpointDescription
Estimate Network FeeCalculate the gas cost before recovery
Execute RecoveryInitiate the asset recovery