Gestão de Ativos

Em resumo
A Gestão de Ativos permite configurar quais stablecoins estão habilitadas na sua carteira principal. Adicione um novo token para começar a aceitá-lo, remova um para parar, ou atualize suas configurações. Sua carteira só monitora e indexa ativos explicitamente habilitados.

Pré-requisitos

Chave de API

Obtenha sua chave de API no Dashboard do Blockradar. Acesse Developers para gerar uma.

Carteira Criada

Você precisará de um walletId para gerenciar ativos. Crie um no dashboard (veja Criar uma Carteira Principal).

IDs de Ativos

Obtenha o assetId do token que deseja adicionar em Ativos no dashboard ou via API de Obter Ativos.

Como Funciona

Quando você cria uma carteira principal, ela não rastreia automaticamente todos os stablecoins suportados — apenas os que você habilitou explicitamente. Isso lhe dá controle preciso sobre o que sua carteira aceita e indexa. Adicionar um ativo à sua carteira diz ao Blockradar para começar a monitorar transações de entrada para aquele token, incluí-lo em consultas de saldo e disparar webhooks quando depósitos chegarem. Remover um ativo interrompe tudo isso.

Adicionar um Ativo

Habilite um novo stablecoin na sua carteira para começar a aceitar depósitos e executar saques naquele token.

Remover um Ativo

Desabilite um token para parar de monitorá-lo. Saldos existentes não são afetados — você pode reabilitá-lo a qualquer momento.

Atualizar Configurações

Ajuste configurações a nível de ativo como limites de varredura automática e transações sem gas.

Ver Ativos Ativos

Busque todos os ativos habilitados na sua carteira com seus IDs, símbolos e configurações.

Adicionando um Ativo

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);

Depois de adicionado, o Blockradar começa imediatamente a monitorar esse token na sua carteira.

Visualizando Ativos Ativos

Busque a lista de todos os ativos habilitados na sua carteira, útil para obter os IDs de ativos específicos da carteira para uso em swaps, saques e outras operações.

GET /v1/wallets/{walletId}/assets

Sempre use os IDs de ativos retornados por este endpoint ao chamar outras APIs. Estes são IDs específicos da carteira, não globais, e são necessários para trocas, saques e consultas de saldo.

Removendo um Ativo

Desabilitar um ativo faz o Blockradar parar de monitorar novos depósitos daquele token. Isso não afeta saldos existentes nem o histórico de transações.

DELETE /v1/wallets/{walletId}/assets/{assetId}

Remover um ativo significa que depósitos de entrada daquele token não serão mais detectados ou indexados. Certifique-se de migrar qualquer saldo existente antes de remover um ativo que você pretende deixar de usar.

Atualizando Configurações de Ativos

Você pode atualizar configurações a nível de ativo, como limites de varredura e configuração sem gas.

PATCH /v1/wallets/{walletId}/assets/{assetId}

Melhores Práticas

Habilite apenas o que você precisa — uma lista de ativos focada mantém sua carteira limpa, reduz ruído nos webhooks e torna as consultas de saldo mais rápidas.
Sempre busque IDs de ativos da sua carteira — use GET /v1/wallets/{walletId}/assets para obter os IDs de ativos corretos e específicos da carteira antes de executar trocas ou saques.
Teste na testnet primeiro — habilite e configure ativos na testnet antes de replicar na mainnet.

Referência de API

Endpoint	Descrição
Obter Ativos	Listar todos os ativos ativos em uma carteira
Adicionar Ativo	Habilitar um novo token
Remover Ativo	Desabilitar um token
Atualizar Ativo	Atualizar configurações a nível de ativo

Começar

Carteiras

Receber Pagamentos

Enviar Pagamentos

Converter e Gerenciar

Conformidade e Recuperação

Integrações

Pré-requisitos

Como Funciona

Adicionar um Ativo

Remover um Ativo

Atualizar Configurações

Ver Ativos Ativos

Adicionando um Ativo

Visualizando Ativos Ativos

Removendo um Ativo

Atualizando Configurações de Ativos

Melhores Práticas

Referência de API

​Pré-requisitos

​Como Funciona

Adicionar um Ativo

Remover um Ativo

Atualizar Configurações

Ver Ativos Ativos

​Adicionando um Ativo

​Visualizando Ativos Ativos

​Removendo um Ativo

​Atualizando Configurações de Ativos

​Melhores Práticas

​Referência de API

Pré-requisitos

Como Funciona

Adicionando um Ativo

Visualizando Ativos Ativos

Removendo um Ativo

Atualizando Configurações de Ativos

Melhores Práticas

Referência de API