# API de Bifrost Crypto

> Versión en Markdown de la documentación pública de la API v1 de Bifrost Crypto, para agentes de IA y generadores de código. El mismo contenido de las páginas HTML, generado de la misma fuente, sin navegación ni estilos.
>
> Versión HTML: https://bifrostcrypto.com/es/docs
> Archivos relacionados: [ai.md](https://bifrostcrypto.com/ai/es.md) · [Postman](https://bifrostcrypto.com/postman-collection.json) · [OpenAPI](https://bifrostcrypto.com/openapi.json) · [llms.txt](https://bifrostcrypto.com/llms.txt)
> Otros idiomas: [Português](https://bifrostcrypto.com/ai/pt-BR/introduction.md) · [English](https://bifrostcrypto.com/ai/en/introduction.md) · [Français](https://bifrostcrypto.com/ai/fr/introduction.md)
> API v1 · último cambio de contrato el 2026-10-10

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

## 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"
```

## 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.

https://bifrostcrypto.com/openapi.json

## 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.

`Bitcoin`, `Ethereum`, `BinanceSmartChain`, `Tron`, `Solana`, `Ripple`, `Cardano`, `Dogecoin`, `Polygon`, `Avalanche`, `ArbitrumOne`, `Celo`, `Optimism`, `Arbitrum`, `Cronos`, `Base`, `BitcoinCash`, `BitcoinSV`, `BitcoinGold`, `Monero`, `OpBnb`, `Xlayer`, `Litecoin`, `TON`

## 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 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.