GET /wallets/by-address

Atalho para consultar uma wallet pelo endereço cripto raw, evitando precisar conhecer o wallet_id UUID interno.

Request

GET /api/v1/wallets/by-address/:address/:blockchain
Authorization: Bearer $SENTINEX_JWT

Exemplo concreto:

GET /api/v1/wallets/by-address/bc1qexample0demoaddress0000000000000000/BITCOIN
Authorization: Bearer $SENTINEX_JWT

Path params

Param	Required	Notas
`address`	✅	Endereço raw de qualquer chain suportada (URL-encode caracteres especiais)
`blockchain`	✅	`BITCOIN`, `ETHEREUM`, `TRON`, `SOLANA`, `POLYGON`, `BSC` (case-insensitive)

Query params (opcionais)

Param	Notas
`include_screening`	`true` para incluir resultado do último screening

Response 200

{
  "success": true,
  "data": {
    "id": "9c2a1b3e-1d0a-4b7f-8e2c-7a1b3c5d7e9f",
    "address": "bc1qexample0demoaddress0000000000000000",
    "blockchain": "BITCOIN",
    "risk_tier": "GREEN",
    "customer_id": "a1b2c3d4-…",
    "label": "Hot wallet principal",
    "first_seen_at": "2026-05-18T14:32:11Z",
    "last_activity_at": "2026-05-18T18:01:42Z"
  }
}

Response 404

Wallet não encontrada no tenant (ou em outro tenant: isolamento estrito).

{
  "success": false,
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Wallet com endereço bc1qexample… não encontrada.",
    "request_id": "req_01HVZ…"
  }
}