Guía de integración
Cómo usar BingX con VeloTape
Conecta una API key de BingX de solo lectura para sincronizar USD-M Perpetual, o sube Order History CSV para rellenar historial antiguo.
Resumen
VeloTape importa solo fills de BingX USD-M Perpetual Futures (no Spot). El historial por API es ~3 meses — usa Order History CSV para lo más antiguo. Crea siempre claves con permiso Read only.
Importar trades con API de solo lectura
Crea una API key de BingX de solo lectura, pégala en VeloTape y sincroniza fills de USD-M Perpetual Futures. Nunca actives trade ni withdraw.
El historial por API es ~3 meses para perpetuos. Importa Order History CSV para trades más antiguos y mantén auto-sync para lo nuevo. Spot no está soportado.
Crear una API key de solo lectura en BingX
- Inicia sesión en BingX en escritorio y abre User Center → API Management.
- Crea una API y activa solo el permiso Read.
- No actives Trade ni Withdraw.
- Copia la API Key y Secret Key (el secret se muestra una sola vez).
Si BingX pide restringir la clave por IP, déjalo vacío u off para que VeloTape pueda sincronizar.
Conectar en VeloTape
- Inicia sesión en VeloTape y abre Ajustes → Cuentas.
- Pulsa Añadir cuenta → Exchange → BingX → Auto-sync.
- Introduce nombre, divisa (normalmente USDT), API key y secret.
- Pulsa Crear cuenta y conectar — VeloTape cifra el secret y sincroniza fills USD-M Perpetual.
Mantener el diario al día
- Usa Sync now en Ajustes tras nuevos fills, o espera el sync programado.
- Si cambian las credenciales, abre Configure en la cuenta BingX y pega una nueva clave Read-only.
| Problema | Qué probar |
|---|---|
| Error de firma o auth | Recrea una clave Read-only, pega key y secret sin espacios y comprueba que el reloj del sistema sea correcto. |
| Pocos o ningún trade importado | Pulsa Sync now tras reconectar — VeloTape lee órdenes filled de perpetuos (incluye Autonomous Orders). Fuera del lookback de ~3 meses de la API, importa el CSV de Order History. |
| Errores de permiso o IP | Confirma que la clave es Read-only. Si activaste restricción por IP en BingX, desactívala e inténtalo de nuevo. |
Importar trades desde CSV de BingX
Exporta Order History de BingX para USD-M Perpetual Futures, convierte Excel a CSV si hace falta, y súbelo a VeloTape para rellenar historial más allá del límite de la API.
Exportar Order History desde BingX
- Inicia sesión en BingX en escritorio.
- Abre Perfil → Data Export.
- Elige Order History (recomendado) para tu rango de fechas.
- Selecciona USD-M Perpetual Futures — no uses exports de Spot.
Order History incluye precios y cantidades de fill. Es el formato CSV preferido en VeloTape.
Guardar como CSV si hace falta
- Si BingX te dio Excel, ábrelo y guárdalo como CSV (UTF-8).
- No renombres columnas requeridas antes de subir.
Subir el CSV en VeloTape
- Abre Ajustes → Cuentas → Añadir cuenta (o Import CSV en una cuenta BingX existente).
- Elige Exchange → BingX → File upload si creas una cuenta nueva.
- Introduce nombre, divisa y saldo inicial.
- Selecciona el CSV de Order History, revisa la vista previa y confirma.
Se omiten transfers y funding. Direcciones como Buy, Sell, Open Long y Close Short están soportadas.
| Problema | Qué probar |
|---|---|
| CSV no reconocido | Sube un export de Order History de USD-M Perpetual Futures con Trading Pair, Direction, Filled Quantity y Average Price. |
| XLSX rechazado | Convierte el archivo a CSV UTF-8 antes de subirlo. |
| 0 trades importados | Confirma que el archivo tiene filas filled de Order History (USD-M Perpetual), no solo depósitos, transfers o Spot. |
Preguntas frecuentes
- ¿Debo usar API sync o CSV?
- Usa Order History CSV para historial antiguo y luego conecta una API key Read-only para sync continuo de USD-M Perpetual. El lookback de la API es ~3 meses.
- ¿Qué mercados están soportados?
- Solo USD-M Perpetual Futures. Spot no se importa por API ni es el camino CSV recomendado.
- ¿Qué permisos de API hacen falta?
- Solo Read. Nunca actives trading ni withdrawal en claves que pegues en VeloTape.
- ¿Se importan funding fees?
- No. Funding, depósitos, withdrawals y transfers no se importan como trades del diario.
- ¿El re-sync duplica trades?
- No. Los fills usan IDs externos estables; un re-sync actualiza filas existentes en lugar de duplicarlas.
- ¿Hay soporte de copy trading?
- No en v1. Se soportan fills de cuenta USD-M perpetual; los feeds de copy trading quedan aplazados.
Integraciones relacionadas
Importa trades de otros brokers y plataformas con el mismo flujo guiado.