Infraestrutura de Carteiras Digitais para Bancos e Fintechs

// Criar carteira Bitcoin para cliente
POST /api/wallets
{
  "user_id": "cliente_12345",
  "network": "bitcoin",
  "label": "João Silva - Conta BTC"
}

// Resposta - Endereço SegWit nativo
{
  "address": "bc1qxy2kgdygjrsw3k4hx8rnqf7v5m2n8p4t6u9w2x",
  "user_id": "cliente_12345",
  "network": "bitcoin",
  "balance": 0.00000000,
  "balance_fiat": "R$ 0,00",
  "derivation_path": "m/84'/0'/0'/0/12345",
  "created_at": "2024-01-15T10:30:00Z"
}

// Processar saque Bitcoin
POST /api/withdraw/user/cliente_12345
{
  "amount": 0.0015,
  "to_address": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq",
  "priority": "high",
  "memo": "Saque para cold wallet"
}

// Webhook recebido quando há depósito
{
  "event": "deposit_confirmed",
  "user_id": "cliente_12345",
  "txid": "2f5e8a3b9c1d4e7f8a2b5c9e6d3f1a4e7b8c5d2f9e6a3b7c4f1e8d5a2b9c6e3f",
  "amount": 0.00250000,
  "confirmations": 3,
  "block_height": 825847,
  "fee_rate": "15 sat/vB",
  "timestamp": "2024-01-15T11:45:30Z"
}

// Criar carteira USDT Solana para cliente
POST /api/wallets
{
  "user_id": "cliente_67890",
  "network": "solana",
  "token": "USDT",
  "label": "Maria Santos - Conta USDT"
}

// Resposta - Endereço Solana
{
  "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgHyrG",
  "user_id": "cliente_67890",
  "network": "solana",
  "token": "USDT",
  "token_address": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
  "balance": 0.000000,
  "balance_fiat": "R$ 0,00",
  "created_at": "2024-01-15T10:30:00Z"
}

// Processar saque USDT Solana
POST /api/withdraw/user/cliente_67890
{
  "amount": 100.50,
  "to_address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
  "network": "solana",
  "token": "USDT",
  "priority": "medium"
}

// Webhook - Depósito USDT Solana confirmado
{
  "event": "deposit_confirmed",
  "user_id": "cliente_67890",
  "signature": "4fz8VK8YG2mNvHd5xJ9Lp3kR7wQ2nM8bS6tC1vX4yE3rA9qW5uI7oP1lK8fD2sG6",
  "amount": 250.000000,
  "token": "USDT",
  "network": "solana",
  "slot": 234567890,
  "block_time": 1705316730,
  "fee_sol": 0.000005,
  "timestamp": "2024-01-15T11:45:30Z"
}

// Saque em lote (batch) para mesa OTC
POST /api/batch/withdraw
{
  "transactions": [
    {
      "user_id": "trader_001",
      "amount": 0.5,
      "to_address": "bc1qxy2kgdygjrsw3k4hx8rnqf7v5m2n8p4t6u9w2x",
      "network": "bitcoin",
      "memo": "OTC Trade #1001"
    },
    {
      "user_id": "trader_002",
      "amount": 1000.00,
      "to_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgHyrG",
      "network": "solana",
      "token": "USDT",
      "memo": "OTC Trade #1002"
    }
  ],
  "priority": "high",
  "batch_id": "otc_batch_20240115_001"
}

// Resposta - Status do lote
{
  "batch_id": "otc_batch_20240115_001",
  "status": "processing",
  "total_transactions": 2,
  "estimated_completion": "2024-01-15T11:50:00Z",
  "transactions": [
    {
      "user_id": "trader_001",
      "status": "pending",
      "txid": null,
      "estimated_fee": "0.00001500 BTC"
    },
    {
      "user_id": "trader_002",
      "status": "pending",
      "signature": null,
      "estimated_fee": "0.000005 SOL"
    }
  ]
}

// Webhook automático para bots de trading
{
  "event": "batch_completed",
  "batch_id": "otc_batch_20240115_001",
  "completed_transactions": 2,
  "failed_transactions": 0,
  "total_volume_btc": 0.5,
  "total_volume_usdt": 1000.00,
  "completion_time": "2024-01-15T11:48:30Z",
  "bot_signal": "ready_for_next_batch"
}