Conta

Endpoints de leitura e edição da conta vinculada à API key. Permite obter dados básicos, atualizar perfil e listar carteiras Liquid cadastradas.

Requer chave de API com scope account. Headers Authorization, X-DF-Secret e X-DF-Passphrase são obrigatórios. PATCH não exige X-DF-Idempotency-Key.

• Scope: account
• Rate limit: 30 req/min, burst 5/5s

Retorna id, email, username, fullName, fase da conta (active/locked/quarantine) e timestamps.

curl https://api.deflow.exchange/v1/account/me \
  -H "Authorization: Bearer dfk_live_..." \
  -H "X-DF-Secret: sk_..." \
  -H "X-DF-Passphrase: minha-passphrase"

{
  "data": {
    "id": "699f2f39...",
    "email": "[email protected]",
    "username": "meu_username",
    "fullName": "Meu Nome",
    "phase": "active",
    "createdAt": "2026-05-15T12:00:00.000Z"
  },
  "meta": {
    "timestamp": "2026-05-15T12:00:00.000Z"
  }
}

• Scope: account
• Rate limit: 10 req/min, burst 3/5s

Permite atualizar username (3-30 chars alfanuméricos) e fullName (3-100 chars sem caracteres especiais).

curl -X PATCH https://api.deflow.exchange/v1/account/me \
  -H "Authorization: Bearer dfk_live_..." \
  -H "X-DF-Secret: sk_..." \
  -H "X-DF-Passphrase: minha-passphrase" \
  -H "Content-Type: application/json" \
  -d '{"username":"meu_username","fullName":"Meu Nome"}'

{
  "data": {
    "id": "699f2f39...",
    "email": "[email protected]",
    "username": "meu_username",
    "fullName": "Meu Nome",
    "updatedAt": "2026-05-15T12:00:00.000Z"
  },
  "meta": {
    "timestamp": "2026-05-15T12:00:00.000Z"
  }
}

• Scope: account
• Rate limit: 30 req/min, burst 5/5s

Lista carteiras Liquid cadastradas. Cada wallet tem id, address, label e flag isDefault.

curl https://api.deflow.exchange/v1/account/wallets \
  -H "Authorization: Bearer dfk_live_..." \
  -H "X-DF-Secret: sk_..." \
  -H "X-DF-Passphrase: minha-passphrase"

{
  "data": [
    {
      "id": "69c30088...",
      "address": "lq1qq...",
      "label": "Carteira Principal",
      "isDefault": true,
      "createdAt": "2026-05-15T12:00:00.000Z"
    }
  ],
  "meta": {
    "timestamp": "2026-05-15T12:00:00.000Z"
  }
}

Conta pode estar active, locked ou em quarantine. Eventos account:locked são disparados via webhook quando o estado muda.