DEV Documentação técnica e contrato OpenAPI da Vexus Crypto

Plataforma Vexus Crypto

Uma base única para sua operação cripto.

Conecte carteiras, recebimentos, envios, liquidez e liquidação em reais a um Core que mantém estado financeiro, políticas operacionais e eventos no mesmo contrato.

HMAC v2 Escopos mínimos Operações rastreáveis
01 / CARTEIRAS

Endereços e saldos que acompanham o seu usuário.

O sistema de carteiras da Vexus relaciona cada endereço ao usuário, à rede e ao ativo corretos. Sua aplicação consulta uma visão consistente sem precisar transformar particularidades de cada blockchain em regras de produto.

  • Segregação lógica. Endereços e saldos vinculados à identidade da sua operação.
  • Visão multirrede. Um contrato uniforme para os ativos habilitados no Core.
  • Fonte contábil. Saldo apresentado a partir do ledger, não de inferências no navegador.
Por usuárioPor redePor ativo
Identidade do usuárioContexto externo associado à contacustomer_ref
Carteira custodialEndereço emitido conforme rede e políticaREADY
Saldo no ledgerDisponível, reservado e pendente3 ESTADOS
Ciclo de um recebimentodeposit.lifecycle
Transação observadaA rede detecta a movimentação para o endereçoSEEN
Confirmações acompanhadasA política considera a finalização exigidaPENDING
Crédito contabilizadoLedger atualizado e evento emitidoCREDITED
02 / RECEBIMENTOS

Crédito somente quando a rede confirma.

Os indexadores observam depósitos, normalizam a transação e acompanham confirmações. O saldo só avança quando a política operacional é satisfeita, mantendo a experiência alinhada ao estado real da rede.

  • Observação contínua. Entradas encontradas pelos serviços responsáveis por cada rede.
  • Crédito idempotente. Reprocessamentos não devem duplicar o efeito financeiro.
  • Evento rastreável. A integração recebe a mudança de estado por webhook assinado.
03 / ENVIOS E SAQUES

Previsibilidade antes de transmitir uma transação.

O fluxo separa intenção, cotação, reserva e execução. A aplicação conhece os custos e o estado da operação antes de comunicar sucesso ao usuário.

  • Prévia de taxa. A estimativa é vinculada à operação e à rede selecionada.
  • Reserva atômica. O ledger protege o saldo durante a execução.
  • Estados explícitos. Aceito, processando, confirmado e falho não são tratados como equivalentes.
Cotação de redeValor, taxa e expiraçãoQUOTE
Reserva no ledgerSaldo protegido para a execuçãoRESERVED
Transmissão e confirmaçãoHash e estado terminal rastreadosON-CHAIN
Cotação de swapPar disponível no catálogo autenticado Válida
₮USDTAtivo de origem1.000,00
Preço e validadeCotação vinculada à execuçãoQUOTE ID
$USDCAtivo de destinoESTIMADO
04 / SWAPS

Trocas com preço, prazo e estado definidos.

Os pares executáveis são publicados pelo Core. Cada cotação tem validade e identificador próprios, permitindo que a confirmação seja idempotente e auditável.

  • Pares habilitados. Sua interface apresenta apenas combinações disponíveis.
  • Cotação vinculada. Preço, prazo e montantes permanecem associados.
  • Replay seguro. A mesma intenção não cria duas operações.
05 / CONVERSÕES EM BRL

Uma jornada coordenada entre ativos digitais e reais.

A Vexus orquestra os estados da conversão conforme os mercados e provedores contratados. A operação preserva evidências, referências externas e conciliação do início ao estado terminal.

  • Mercado configurado. Disponibilidade e direção dependem da operação habilitada.
  • Rastreabilidade ponta a ponta. Referências do provedor permanecem ligadas à conversão.
  • Conciliação. O resultado externo é verificado antes da conclusão financeira.
BRLOrigem ou destino fiduciárioFIAT
Orquestração VexusCotação, execução e evidênciasCORE
$USDC ou USDTConforme mercado contratadoCRYPTO
Visão contábildouble-entry ledger
DisponívelSaldo apto para uma nova operaçãoAVAILABLE
ReservadoMontante protegido durante a execuçãoRESERVED
PendenteEfeito aguardando confirmação terminalPENDING
06 / LEDGER

Movimentos que fecham dos dois lados.

O ledger de dupla entrada registra débitos, créditos e reservas sem depender do saldo exibido por uma blockchain. Isso permite reconciliar a operação interna com seus efeitos externos.

  • Dupla entrada. Cada movimento mantém sua contrapartida.
  • Separação de estados. Disponível, reservado e pendente são saldos distintos.
  • Reconciliação operacional. Divergências podem ser investigadas sem reescrever o histórico.
07 / WEBHOOKS

Seu produto informado a cada mudança importante.

Eventos assinados comunicam mudanças de estado sem exigir consultas contínuas. Cada entrega mantém identificador, tentativas e evidências para deduplicação no sistema consumidor.

  • Assinatura verificável. O consumidor valida a origem do payload.
  • Event ID estável. Sua aplicação deduplica entregas repetidas.
  • Histórico de tentativas. Falhas de entrega permanecem rastreáveis.
deposit.credited
{
  "event_id": "evt_uuid",
  "type": "deposit.credited",
  "resource_id": "deposit_uuid",
  "occurred_at": "2026-09-30T18:00:00Z"
}
POST /v1/wallets
X-Vexus-Key: $API_KEY
X-Vexus-Timestamp: $UNIX_TIMESTAMP
X-Vexus-Nonce: $UNIQUE_NONCE
X-Vexus-Signature: $HMAC_SIGNATURE
Idempotency-Key: $REQUEST_UUID
08 / API B2B

Segurança e previsibilidade em cada chamada.

A API B2B usa contrato versionado, autenticação HMAC v2, credenciais com escopos e chaves de idempotência nos fluxos transacionais.

  • Privilégio mínimo. Cada credencial recebe apenas os escopos necessários.
  • Assinatura canônica. Método, caminho, timestamp, nonce e corpo integram a autenticação.
  • Contrato versionado. Schemas, respostas e erros ficam documentados no OpenAPI.
Abrir documentação

Escolha os módulos. A Vexus conecta a operação.

Desenhamos com sua equipe os fluxos, redes, escopos e responsabilidades antes da entrada em produção.