API de Bifrost Crypto

Referencia completa de la API Bifrost Crypto V1. Integra pagos cripto multi-cadena en tu plataforma en minutos.

ᚱ
"A través del puente arcoíris de Bifrost, nueve reinos digitales se conectan, cada uno guardando secretos ancestrales de la tecnología blockchain. Heimdall vigila los pasajes entre mundos, permitiendo solo a los dignos cruzar los portales sagrados."

Autenticación

Todas las rutas requieren el header con tu clave API privada: X-Bifrost-Invoke

URL Base

Todas las solicitudes se realizan a:

https://bridge.bifrostcrypto.com

Formato

Todos los cuerpos de solicitud y respuesta usan formato JSON: Content-Type: application/json

Inicio Rápido

Cada solicitud de la API debe incluir tu clave privada en el header:

bash
curl -X GET "https://bridge.bifrostcrypto.com/v1/balances" \
  -H "X-Bifrost-Invoke: YOUR_API_KEY"
ᚱ
"En las nieblas de Niflheim, solo los portadores del sello dorado pueden cruzar los puentes digitales del arcoíris."
Odin, El Padre de Todos

Especificación OpenAPI

La referencia completa en un archivo OpenAPI 3.1. Impórtela en Postman o Insomnia para probar los endpoints, o genere un cliente en su lenguaje. Se genera desde la misma fuente que esta documentación.

Fechas y horas

Los campos de fecha y hora (created_at, updated_at, expires_at y los demás) son YYYY-MM-DD HH:MM:SS en UTC−03:00, sin el offset en el valor. Los filtros de fecha (date_from, date_to) se leen en el mismo offset. Dos excepciones: el límite diario de payout de una clave de API se reinicia a las 00:00 UTC, y los webhooks de dirección fija envían timestamp en ISO 8601 con el offset incluido.

Redes Soportadas

Valores aceptados en el campo network, sin distinguir mayúsculas al crear. Al crear también se aceptan alias comunes (erc20, bsc, trc20, matic…), que se convierten a estos nombres; vea Network aliases en los endpoints de creación. Las respuestas, los webhooks y los filtros de listado usan siempre los nombres de abajo. Qué tokens están disponibles en cada red lo indica GET /v1/summary/tokens.

BitcoinEthereumBinanceSmartChainTronSolanaRippleCardanoDogecoinPolygonAvalancheArbitrumOneCeloOptimismArbitrumCronosBaseBitcoinCashBitcoinSVBitcoinGoldMoneroOpBnbXlayerLitecoinTON

Códigos de Estado HTTP

CódigoSignificado
200Éxito
201Creado - dirección fija asignada
207Multi-Status - lote de payout con ítems rechazados
400Solicitud Inválida - parámetros inválidos
401No Autorizado - clave de API o firma ausente o inválida
403Prohibido - sin permiso para este recurso
404No Encontrado - recurso o ruta inexistente
409Conflicto - solicitud aún en curso o límite alcanzado
422No Procesable - type no soportado
429Demasiadas Solicitudes - cuota o límite de fallos de autenticación
500Error del Servidor
502Bad Gateway - falló un servicio del que dependemos. Reintente más tarde.
503Servicio No Disponible - reintente más tarde

Categorías de API

Pagos (Payout)

3 endpoints

Crea y gestiona retiros cripto. Hasta 50 por lote.

Depósitos (Payin)

3 endpoints

Genera billeteras de depósito y rastrea pagos entrantes.

Consultas

6 endpoints

Verifica saldos, extractos, tokens e información de cuenta.

Precios

2 endpoints

Obtén tasas de conversión en tiempo real y monedas disponibles.

Direcciones Fijas

5 endpoints

Asigna y gestiona direcciones de depósito permanentes por cliente.