⚡ Quickstart: Sua Primeira Chamada em 15 Minutos

Siga este guia simples para fazer sua primeira requisição autenticada usando o terminal.

Pré-requisitos

• Obter seu Client ID e Client Secret (B2B no Painel Admin ou Usuário no app).

• Terminal com curl instalado.

Passo 1 — Obter o Token de Acesso (JWT)

Execute a requisição contendo suas chaves:

curl -s -X POST "https://api.dexkey.finance/v1/auth/api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "SEU_CLIENT_ID",
    "clientSecret": "SEU_CLIENT_SECRET"
  }'

Resposta:

{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiresIn": 3600
}

Copie o valor do accessToken.

Passo 2 — Consultar o Status das Suas Carteiras

Insira o token obtido no cabeçalho de autorização:

curl -s -X GET "https://api.dexkey.finance/v1/users/wallets-status" \
  -H "Authorization: Bearer COLE_O_ACCESS_TOKEN_AQUI"

Resposta (carteiras já criadas):

{
  "walletsCreated": true,
  "status": "READY",
  "wallets": [
    { "currency": "BTC", "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh" },
    { "currency": "ETH", "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb" }
  ]
}

Se as carteiras ainda estiverem sendo criadas (processo assíncrono), a resposta vem sem o array wallets:

{
  "walletsCreated": false,
  "status": "CREATING"
}

Passo 3 — Consultar Seus Saldos Disponíveis

curl -s -X GET "https://api.dexkey.finance/v1/ledger/balance" \
  -H "Authorization: Bearer COLE_O_ACCESS_TOKEN_AQUI"

Resposta:

{
  "balances": [
    { "currency": "BRT", "amount": "150000", "formatted": "R$ 1.500,00" },
    { "currency": "BTC", "amount": "150000", "formatted": "0.00150000 BTC" }
  ],
  "totalValueBRL": "1500.00",
  "totalValueBRLFormatted": "R$ 1.500,00"
}

• amount: Valor na menor unidade da moeda (centavos para BRT, satoshis para BTC) — nunca use direto em telas sem converter, use formatted para exibição.

• formatted: Valor já formatado, pronto para mostrar ao usuário.