API de BitcoinVN - Guía de integración y casos de uso

BitcoinVN ofrece una API REST que permite a los desarrolladores integrar el intercambio instantáneo de criptomonedas en sus propias aplicaciones. La documentación interactiva completa está disponible en bitcoinvn.io/api/doc.

Primeros pasos

  1. Prepara el acceso a la API: Lee Cómo gestionar las claves API de forma segura y genera una clave desde la página de claves API si tu integración utiliza endpoints privados.
  2. Explora los endpoints: Navega por la interfaz Swagger interactiva en bitcoinvn.io/api/doc o descarga la especificación OpenAPI en bitcoinvn.io/api/doc.json
  3. Ir en vivo: Crea cotizaciones, envía órdenes y recibe notificaciones webhook

Autenticación

Los endpoints públicos no requieren una clave API. Para los endpoints privados, envía tu clave en el encabezado de solicitud X-API-KEY. Consulta Cómo gestionar las claves API de forma segura para obtener instrucciones sobre cómo crear, restringir, usar y revocar claves.

Flujo de trabajo principal

  1. GET /api/info - Descubrir activos y métodos de transferencia soportados
  2. POST /api/quotes - Fijar una tasa de cambio por 15 minutos
  3. POST /api/orders - Crear una orden con el ID de cotización y detalles de liquidación
  4. El cliente envía el depósito a la dirección indicada en la respuesta de la orden
  5. GET /api/orders/{shortId} - Rastrear el estado de la orden o escuchar callbacks webhook

Casos de uso

  • Agregadores de swaps: Listar BitcoinVN como proveedor de intercambio para 100+ activos
  • Pagos de comerciantes: Aceptar pagos en criptomonedas de clientes de todo el mundo
  • Wallets y apps: Integrar funcionalidad de intercambio directamente en tu wallet o app
  • Trading automatizado: Construir bots que monitoreen tasas y ejecuten swaps programáticamente
  • Contabilidad y reporting: Usar endpoints de saldo y libro mayor para historial de transacciones
  • Dashboards de staking: Consultar ofertas de staking actuales y gestionar preferencias de auto-stake

Características clave

  • 100+ activos soportados en múltiples redes
  • Cotizaciones vinculantes con precios garantizados por 15 minutos
  • Notificaciones webhook para actualizaciones de estado de orden en tiempo real
  • Sin datos personales requeridos para intercambios simples cripto a cripto
  • Especificación OpenAPI 3.0 para generación fácil de código de cliente

Soporte para desarrolladores

Para preguntas de integración, únete a nuestro chat de Telegram para desarrolladores o contáctanos en [email protected].