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.comFormato
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:
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.
Códigos de Estado HTTP
| Código | Significado |
|---|---|
200 | Éxito |
201 | Creado - dirección fija asignada |
207 | Multi-Status - lote de payout con ítems rechazados |
400 | Solicitud Inválida - parámetros inválidos |
401 | No Autorizado - clave de API o firma ausente o inválida |
403 | Prohibido - sin permiso para este recurso |
404 | No Encontrado - recurso o ruta inexistente |
409 | Conflicto - solicitud aún en curso o límite alcanzado |
422 | No Procesable - type no soportado |
429 | Demasiadas Solicitudes - cuota o límite de fallos de autenticación |
500 | Error del Servidor |
502 | Bad Gateway - falló un servicio del que dependemos. Reintente más tarde. |
503 | Servicio No Disponible - reintente más tarde |
Categorías de API
Pagos (Payout)
3 endpointsCrea y gestiona retiros cripto. Hasta 50 por lote.
Depósitos (Payin)
3 endpointsGenera billeteras de depósito y rastrea pagos entrantes.
Consultas
6 endpointsVerifica saldos, extractos, tokens e información de cuenta.
Precios
2 endpointsObtén tasas de conversión en tiempo real y monedas disponibles.
Direcciones Fijas
5 endpointsAsigna y gestiona direcciones de depósito permanentes por cliente.