API do Bifrost Crypto

Referência completa da API Bifrost Crypto V1. Integre pagamentos cripto multi-chain na sua plataforma em minutos.

ᚱ
"Através da ponte arco-íris do Bifrost, nove reinos digitais se conectam, cada um guardando segredos ancestrais da tecnologia blockchain. Heimdall vigia as passagens entre mundos, permitindo apenas aos dignos cruzar os portais sagrados."

Autenticação

Todas as rotas requerem o header com sua chave API privada: X-Bifrost-Invoke

URL Base

Todas as requisições são feitas para:

https://bridge.bifrostcrypto.com

Formato

Todos os corpos de requisição e resposta usam formato JSON: Content-Type: application/json

Início Rápido

Cada requisição da API deve incluir sua chave privada no header:

bash
curl -X GET "https://bridge.bifrostcrypto.com/v1/balances" \
  -H "X-Bifrost-Invoke: YOUR_API_KEY"
ᚱ
"Nas névoas de Niflheim, apenas portadores do selo dourado podem cruzar as pontes digitais do arco-íris."
Odin, O Pai de Todos

Especificação OpenAPI

A referência completa num arquivo OpenAPI 3.1. Importe no Postman ou no Insomnia para testar os endpoints, ou gere um cliente na sua linguagem. Ela é gerada da mesma fonte desta documentação.

Datas e horários

Campos de data e hora (created_at, updated_at, expires_at e os demais) vêm como YYYY-MM-DD HH:MM:SS em UTC−03:00, sem o offset no valor. Os filtros de data (date_from, date_to) são lidos no mesmo offset. Duas exceções: o limite diário de payout de uma chave de API reinicia às 00:00 UTC, e os webhooks de endereço fixo enviam timestamp em ISO 8601 com o offset incluído.

Redes Suportadas

Valores aceitos no campo network, sem diferenciar maiúsculas na criação. Na criação também são aceitos apelidos comuns (erc20, bsc, trc20, matic…), convertidos para estes nomes; veja Network aliases nos endpoints de criação. Respostas, webhooks e filtros de listagem usam sempre os nomes abaixo. Quais tokens estão disponíveis em cada rede é informado por GET /v1/summary/tokens.

BitcoinEthereumBinanceSmartChainTronSolanaRippleCardanoDogecoinPolygonAvalancheArbitrumOneCeloOptimismArbitrumCronosBaseBitcoinCashBitcoinSVBitcoinGoldMoneroOpBnbXlayerLitecoinTON

Códigos de Status HTTP

CódigoSignificado
200Sucesso
201Criado - endereço fixo atribuído
207Multi-Status - lote de payout com itens recusados
400Requisição Inválida - parâmetros inválidos
401Não Autorizado - chave de API ou assinatura ausente ou inválida
403Proibido - sem permissão para este recurso
404Não Encontrado - recurso ou rota inexistente
409Conflito - pedido ainda em andamento ou limite atingido
422Não Processável - type não suportado
429Muitas Requisições - cota ou limite de falhas de autenticação
500Erro do Servidor
502Bad Gateway - um serviço do qual dependemos falhou. Tente novamente mais tarde.
503Serviço Indisponível - tente mais tarde

Categorias da API

Pagamentos (Payout)

3 endpoints

Crie e gerencie saques cripto. Até 50 por lote.

Depósitos (Payin)

3 endpoints

Gere carteiras de depósito e rastreie pagamentos recebidos.

Consultas

6 endpoints

Verifique saldos, extratos, tokens e informações da conta.

Preços

2 endpoints

Obtenha taxas de conversão em tempo real e moedas disponíveis.

Endereços Fixos

5 endpoints

Atribua e gerencie endereços de depósito permanentes por cliente.