Guía de inicio rápido para usuarios con asistentes de codificación con IA.
Resumen
Este documento es una recopilación de funciones de la API de BingX para asistentes de programación de IA, que incluye 15 módulos de funciones y abarca Futuros Perpetuo, spot trading, Futuros Estándar M-Moneda, copy trading y gestión de cuentas.
Después de la instalación, puedes interactuar directamente en lenguaje natural con AI consultar datos del mercado, realizar trades y administrar cuentas, sin escribir manualmente ningún código de solicitud API.
Asistentes con soporte de IA: Claude Code,Cursor y otros asistentes de codificación de IA que admiten el mecanismo de funciones.
Instalar
- Instalación general (Claude Code / Cursor / Otros)
| npx skills add BingX-API/api-ai-skills |
- Claude Code Instalación dedicada (permite actualizaciones automáticas)
| /plugin add BingX-API/api-ai-skills |
Para instrucciones más detalles de instalación, lee README.md
Resumen de funciones
- Perpetuo M-USDT
| Nombre de función | Propósito | Autorización requerida |
| bingx-swap-market | Datos del mercado: Precio, profundidad, línea K, tasa de financiación, interés abierto, etc. | Incompleto |
| bingx-swap-trade | Operaciones de trading: Realizar órdenes, cancelar órdenes, establecer apalancamiento, modo de activos, etc. | Sí |
| bingx-swap-account | Información de la cuenta: Saldos, posiciones actuales, tasas de tarifas, flujos de fondos, etc. | Sí |
- Spot
| Nombre de función | Propósito | Autorización requerida |
| bingx-spot-market | Datos de mercado: Precio, profundidad, línea K, historial de trading, etc. | Incompleto |
| bingx-spot-trade | Operaciones de trading: Colocar órdenes, cancelar órdenes, consultar órdenes, órdenes OCO, etc. | Sí |
| bingx-spot-account | Información de la cuenta: Saldos, resumen de activos, transferencia de activos, etc. | Sí |
| bingx-spot-wallet | Operaciones de la billetera: Depósitos, retiros, registros de transferencias, etc. | Sí |
- Perpetuo M-Moneda
| Nombre de función | Propósito | Autorización requerida |
| bingx-coinm-market | Datos del mercado: Precio, profundidad, línea K, tasa de financiación, etc. | Incompleto |
| bingx-coinm-trade | Operaciones de trading: Realizar órdenes, cancelar órdenes, apalancamiento, modo de activos, etc. | Sí |
- Copy Trading
| Nombre de función | Propósito | Autorización requerida |
| bingx-copytrade-spot | Copy Trading Spot: Cerrar posiciones de copia, consultar ganancias, etc. | Sí |
| bingx-copytrade-swap | Copy Trading de Futuros: Cerrar posiciones, establecer TP/SL, fijar comisiones, etc. | Sí |
- Gestión de cuenta
| Nombre de función | Propósito | Autorización requerida |
| bingx-fund-account | Cuenta de Fondos: Consulta de saldo, resumen de activos, transferencia interna, etc. | Sí |
| bingx-sub-account | Gestión de subcuentas: Crear/congelas subcuentas, gestión de clave API, etc. | Sí |
| bingx-agent | Socio/Broker: Invitar a usuarios, consultar comisiones, revisar datos de socios, etc. | Sí |
- Futuros Estándar
| Nombre de función | Propósito | Autorización requerida |
| bingx-standard-trade | Futuros estándar: Consulta de posiciones, historial de órdenes, saldo, etc. | Sí |
Explicación de la autorización
- Funciones que no requieren autorización
Las siguientes funciones relacionadas con los datos de mercado pueden ser usadas sin configurar la llave API :
- bingx-swap-market (datos de mercado de Futuros Perpetuo)
- bingx-spot-market (datos de mercado Spot)
- bingx-coinm-market (datos de mercado de Futuros Estándar M-Moneda)
- Funciones que requieren autorización
Todas las demás habilidades relacionadas con el trading y las cuentas requieren la configuración de las siguientes variables de entorno:
- BINGX_API_KEY — tu clave API
- BINGX_SECRET_KEY — tu clave secreta
La clave API se crea en el Centro de Usuarios de BingX → Gestión de API .
- Entornos operativos
| Entorno | Descripción | URL base |
| prod-live | Producción (en vivo) | https://open-api.bingx.com |
| prod-vst | Demo (no se necesitan fondos reales) | https://open-api-vst.bingx.com |
Para obtener información técnica detallada sobre la firma de autenticación, consulta skills/references/authentication.md.
Mecanismo de seguridad
- Escribe la confirmación de operación
En el entorno de producción prod-live, todas las operaciones de escritura (realizar órdenes, cancelar , transferencias, etc.) requieren que el usuario incluya CONFIRM antes de la ejecución. No se requiere confirmación en el entorno de demostración.
- Enmascaramiento de claves
La IA ocultará automáticamente las claves al mostrarlas:
- Clave API: Muestra los primeros 5 y los últimos 4 caracteres, por ejemplo, su1Qc...8akf.
- Clave secreta: completamente oculta, solo muestra los últimos 5 caracteres, por ejemplo, ***...aws1
Escenarios de uso común
Una vez completada la instalación, puedes interactuar directamente con la IA de manera normal. A continuación se muestran algunos ejemplos comunes:
- Consulta de datos de mercado
| Consultar el precio actual de BTC-USDT |
| Ver los datos de la línea K de la última hora para ETH-USDT |
| ¿Cuál es la tasa de financiamiento actual para BTC-USDT? |
- Operaciones de trading
| Realiza una orden de compra de mercado con BTC-USDT con un importe de 0.01 |
| Realiza una orden límite de venta con ETH a un precio de 4000 USDT con un importe de 0.1 |
| Cancela todas las órdenes abiertas de BTC-USDT |
- Gestión de cuenta
| Ver el saldo de mi cuenta de futuros y las posiciones actuales |
| Consultar el saldo de mi cuenta spot |
| Transferir 100 USDT de mi cuenta spot a mi cuenta de futuros |
- Otras operaciones
| Ver mi lista de subcuentas |
| Consultar mi lista de invitaciones de socios |
Flujo de trabajo multifuncional
Se pueden combinar múltiples habilidades para completar procesos comerciales completos:
- Flujo de trabajo de trading de futuros
| swap-market (ver los datos de mercado y profundidad de BTC-USDT) ↓ swap-account (ver el saldo de la cuenta y el margen disponible) ↓ swap-trade (realizar orden) |
- Flujo de trabajo de gestión de posiciones
| swap-account (ver las posiciones actuales y el PnL) ↓ swap-market (ver el último precio) ↓ swap-trade (cierra o ajusta la posición) ↓ swap-account (confirmar cerrar resultado) |
- Flujo de trabajo de trading en spot
| spot-market (consultar el precio spot y la profundidad) ↓ spot-account (revisar el saldo de la cuenta spot) ↓ spot-trade (realiza una orden de compra o de venta) |
- Transferencia de activos entre cuentas
| spot-account (ver saldo spot) ↓ spot-account / fund-account (transfiere activos a la cuenta de futuros) ↓ swap-trade (opera futuros con los fondos transferidos) |
Estructura de archivos
Cada módulo de funciones consta de dos archivos:
| skills/<skill-name>/ ├── SKILL.md # Descripción del uso del agente └── api-reference.md # Documentación total de la API |
- SKILL.md: Define el propósito de la función, tabla de referencia rápida, ejemplos de código TypeScript, reglas de interacción del agente (autorización, mecanismo de confirmación, etc.).
- api-reference.md: Documentación completa de los puntos finales de la API, incluyendo detalles de los parámetros, campos de respuesta, ejemplos JSON y códigos de error.
La documentación de referencia general se puede encontrar en funciones/referencias/ directorio:
- authentication.md — Implementación de la firma HMAC SHA256
- base-urls.md — Configuración de la URL base del entorno
