Recebendo ativos na sua carteira

Este guia mostra como consultar sua carteira e obter o endereço público para que outras pessoas possam enviar ativos para você.

🔐 Pré-requisitos

Antes de realizar as chamadas, tenha em mãos:

  • Seu token de autenticação (Bearer Token)

  • Um terminal com curl instalado

  • Permissão de acesso ao endpoint da API

🔁 Passo 1: Listar suas carteiras

Execute o seguinte comando para listar todas as carteiras associadas à sua conta:

curl https://d3puficnw2.us-east-2.awsapprunner.com/v1/wallet \
  --header 'Authorization: Bearer <token>'

📌 Resultado esperado: Uma lista em JSON com suas carteiras. Cada item terá um id, address, network, currency e outras informações.

Exemplo de resposta:

[
  {
    "id": "123abc456",
    "address": "0xabcdefabcdefabcdefabcdefabcdefabcdef",
    "network": "ETH",
    "currency": "USDT"
  },
  ...
]

🧾 Passo 2: Consultar os detalhes de uma carteira específica

Copie o id da carteira que deseja consultar e use no endpoint abaixo:

curl https://d3puficnw2.us-east-2.awsapprunner.com/v1/wallet/{id} \
  --header 'Authorization: Bearer <token>'

Substitua {id} pelo valor obtido no passo anterior.

🔍 Isso retorna os detalhes completos da carteira, incluindo o endereço público (address) que você deverá fornecer a quem for enviar o ativo.

✅ Exemplo prático

  1. Você obteve este id: 123abc456

  2. Fez a requisição:

curl https://d3puficnw2.us-east-2.awsapprunner.com/v1/wallet/123abc456 \
  --header 'Authorization: Bearer eyJhbGciOi...'
  1. Obteve o seguinte resultado:

{
  "id": "123abc456",
  "address": "0xabcdefabcdefabcdefabcdefabcdefabcdef",
  "network": "ETH",
  "currency": "USDT"
}

📤 Endereço para recebimento:
0xabcdefabcdefabcdefabcdefabcdefabcdef

💡 Você deve compartilhar este endereço com quem vai te enviar o ativo. Verifique se a network e a currency estão corretas!

⚠️ Atenção

  • Sempre confirme a rede (network) correta antes de receber um ativo (ex: ETH, TRON, MATIC, etc.).

  • Enviar ativos para a rede ou moeda errada pode acarretar perda de fundos.