All
Filtrar por:
¿Cómo deposito efectivo en mi cuenta?
Necesito ayuda con la verificación de la cuenta
¿Por qué no puedo acceder a mi cuenta?
¿Existen comisiones por retirar criptomonedas?
Necesito ayuda para iniciar sesión en mi cuenta
Claves API
Las claves de API otorgan acceso programático a las cuentas de tu Organización a sistemas automatizados, bots de trading, scripts operativos, pipelines de informes y sesiones de trading FIX. Este artículo explica el modelo de permisos de las claves de API, cómo se asignan las claves a las cuentas, cómo se aplica la gobernanza de la Organización a las operaciones iniciadas por claves y cómo se administran las propias claves.
Las claves de API no son Miembros con credenciales. Tienen su propio modelo de permisos, más sencillo:
Miembro | Clave API | |
|---|---|---|
Autenticación | Inicio de sesión individual con 2FA | Credenciales de clave de API |
Acceso a la interfaz | Sí | No, solo API |
Modelo de permisos | Perfil de flujo de trabajo + Roles de cuenta | Permisos de clave de API aplicados a las cuentas seleccionadas |
Variación por cuenta | Sí, los roles pueden otorgar permisos distintos en cuentas diferentes | No, los permisos de la clave se aplican de forma uniforme a todas las cuentas seleccionadas |
Puede iniciar solicitudes de retiro y transferencia | Sí, cuando está permitido | Sí, cuando está permitido |
Puede aprobar solicitudes | Sí, excepto las propias | Nunca |
Flujos de trabajo administrativos | Sí, según su Perfil de flujo de trabajo | Nunca |
Los dos modelos están deliberadamente separados. Los Miembros tienen roles, perfiles y granularidad por cuenta porque las personas acumulan responsabilidades diversas. Las claves utilizan un modelo plano de ámbito más cuentas porque la automatización debe ser acotada, uniforme y fácil de auditar de un vistazo.
Una clave de API combina dos selecciones: qué puede hacer (sus permisos) y dónde (sus cuentas).
Permisos
Agrupar | Permiso | Qué permite |
|---|---|---|
Fondos | Consultar fondos | Ver balances y estado de depósito y retiro |
Depositar | Generar direcciones de depósito y ver el historial de depósitos | |
Retirar | Iniciar solicitudes de retiro (ver "Gobernanza y claves API") | |
Earn | Asignar y desasignar productos Earn | |
Órdenes | Consultar órdenes de apertura | Ver órdenes de apertura y operaciones activas |
Consultar órdenes cerradas | Ver el historial de órdenes y operaciones completadas | |
Crear y modificar órdenes | Colocar y modificar órdenes | |
Cancelar y cerrar órdenes | Cancelar órdenes de apertura y cerrar posiciones | |
Direcciones | Añadir dirección de retiro | Iniciar solicitudes para añadir direcciones en lista blanca |
Actualizar dirección de retiro | Iniciar solicitudes para modificar direcciones en lista blanca | |
Datos | Consultar el libro mayor | Ver el historial de transacciones y del libro mayor |
Exportar datos | Exportar datos de cuenta para informes y conciliación |
Asignación de cuentas
Cada clave se asigna a una o varias cuentas, seleccionadas al crearla y modificables posteriormente. Los permisos de la clave se aplican de forma uniforme a todas las cuentas seleccionadas:
- Una clave con los permisos Consultar fondos y Crear y modificar órdenes en dos cuentas seleccionadas puede leer balances y operar en ambas, sin acceder a nada más.
- No existe variación por cuenta dentro de una clave. Si tu automatización necesita operar en una cuenta pero solo leer otra, usa dos claves. Así el radio de acción de cada clave queda perfectamente delimitado.
Conectividad FIX
Las claves con permisos de órdenes son compatibles con la conectividad FIX para trading spot, junto con las APIs REST y WebSocket. Una sesión FIX hereda los mismos permisos y la misma asignación de cuentas que la clave subyacente: opera únicamente en las cuentas seleccionadas para esa clave, dentro de sus permisos. Las empresas que canalizan flujo de órdenes por FIX suelen dedicar una clave por sesión, con alcance limitado a las cuentas que gestiona ese escritorio.
Nota:
El trading por WebSocket en cuentas distintas a la cuenta principal aún no está disponible para las claves API; por ahora es una función exclusiva del Propietario. El flujo automatizado de órdenes en cuentas adicionales debe utilizar REST o FIX. Consulta Disponibilidad y limitaciones.
Configuración de seguridad
Configuración | Descripción |
|---|---|
Vencimiento de la clave | Fecha opcional a partir de la cual la clave deja de funcionar |
Fecha de inicio / fin de consulta | Limita las consultas de datos a un intervalo de fechas |
Conexiones WebSocket | Activa o desactiva el streaming en tiempo real |
Personalizar nonce window | Ajuste de protección contra repetición de solicitudes para uso de alta frecuencia |
Restricciones de IP | Limita el uso de la clave a direcciones IP o rangos CIDR específicos |
Consejo:
Asigna a cada clave los permisos más restrictivos, el menor número de cuentas y las restricciones de IP más estrictas que le permitan cumplir su función. Usa claves independientes por sistema (una para el bot de trading, otra para los informes) y mantén la revocación quirúrgica.
La gobernanza de la Organización se aplica tanto a lo que hacen las claves como a cómo se gestionan.
Qué hacen las claves
La regla de dos categorías para los Miembros se aplica a las claves del mismo modo:
- Las operaciones directas se ejecutan de inmediato. El trading, Earn, las consultas de balance, las consultas al libro mayor y las exportaciones de datos se completan al instante, dentro de los permisos y cuentas de la clave.
- Las operaciones gobernadas generan solicitudes. Un retiro o cambio de dirección iniciado por una clave entra en el mismo flujo que uno iniciado por un Miembro: la política del flujo de trabajo decide si se completa de inmediato o queda en la cola de aprobación para revisión humana.
Una clave solo puede iniciar solicitudes gobernadas. Las claves no pueden aprobar nunca: la separación de funciones exige un Miembro humano para cada aprobación, y un script no puede sustituir ese criterio. Cuando la política de Solicitud de retiro requiere dos aprobaciones, un retiro iniciado por una clave espera la confirmación de dos Miembros, exactamente igual que uno iniciado por un Miembro.
Diseña la automatización teniendo en cuenta esa asincronía: una llamada a la API correcta confirma que la solicitud se creó, no que los fondos se hayan transferido. Haz seguimiento de la solicitud hasta su finalización y ten en cuenta la limitación actual: una solicitud pendiente no reserva fondos. Si el balance cambia durante la revisión, la solicitud aprobada fallará y deberá enviarse de nuevo. Consulta Mantener los fondos disponibles hasta la aprobación.
Las claves tampoco tienen acceso a los flujos de trabajo administrativos. La gestión del acceso del equipo, las claves API, las cuentas, las direcciones (más allá de iniciar solicitudes de dirección) y las políticas está reservada a los Miembros.
Cómo se gestionan las claves
Crear, editar y revocar claves API es una operación gobernada dentro del flujo de trabajo específico Manage API Keys, independiente de Manage Team & Access. Esta separación tiene dos implicaciones:
- Administradores distintos. Puedes permitir que un ingeniero de operaciones gestione las claves sin ninguna capacidad de modificar el acceso de los Miembros, y viceversa.
- Políticas distintas. La gestión de claves puede tener sus propios requisitos de aprobación. Muchas Organizaciones exigen aprobación independiente para crear o modificar una clave – una nueva credencial es una nueva vía de acceso a tus cuentas –, a la vez que mantienen la revocación como un proceso ágil.
- Ve a Claves API y selecciona Crear clave.
- Ponle a la clave un nombre que refleje su finalidad: el sistema al que sirve y lo que hace, para que su función sea evidente en revisiones y eventos de seguridad.
- Selecciona los permisos de la clave.
- Selecciona las cuentas en las que operará la clave. Los permisos se aplican de forma uniforme a todas ellas.
- Configura los ajustes de seguridad: caducidad, restricciones de IP y ventana nonce.
- Revisa y confirma. Si la política Gestionar claves API requiere aprobación, la solicitud quedará en espera hasta recibir las aprobaciones necesarias antes de emitir la clave.
Precaución:
El secreto de la clave se muestra una única vez, en el momento de su creación. Guárdalo en un lugar seguro antes de salir de la pantalla; no podrá recuperarse después.
Editar los permisos o las cuentas de una clave, así como revocarla, sigue el mismo proceso regulado por gobernanza.
Resolución de problemas
La llamada ha creado una solicitud de retiro, y la política de solicitudes de retiro la retiene para su aprobación. Consulta la página Solicitudes: la solicitud aparece allí con la clave como iniciadora, pendiente de las aprobaciones de los miembros requeridas. Así es como funciona el modelo de gobernanza: la automatización propone, las personas aprueban.
Si la solicitud fue aprobada pero los fondos no se transfirieron, comprueba si el balance de origen cubría el importe en el momento de la ejecución: una solicitud pendiente no reserva fondos, por lo que la actividad durante la revisión puede provocar que una solicitud ya aprobada falle. Vuelve a enviarla cuando el balance se haya recuperado.
La cuenta con errores no está incluida en el mapeo de cuentas de la clave. Una clave actúa únicamente sobre las cuentas seleccionadas. Edita la clave para añadir la cuenta. Ten en cuenta que se aplicará el conjunto completo de permisos de la clave, ya que las claves no admiten variación por cuenta. Si el alcance es demasiado amplio, crea una segunda clave limitada a la nueva cuenta.
Una sola clave no puede variar los permisos por cuenta. Crea dos claves: una de trading asignada a la cuenta A y una de solo lectura asignada a la cuenta B. Las claves con un alcance más reducido son más fáciles de auditar y más seguras de revocar.
Es probable que el flujo de trabajo Manage API Keys requiera aprobación y que la solicitud siga pendiente. La clave se emite, y su secreto se muestra, únicamente una vez recopiladas las aprobaciones necesarias. Comprueba el estado de la solicitud en la página Solicitudes.
No. La aprobación siempre requiere la intervención de un miembro humano. Es una norma del sistema, no una política configurable: es lo que da sentido a la aprobación multifirma cuando la automatización inicia movimientos de fondos.