Clave de API de solo lectura: los permisos que marcar en Kraken, Coinbase y OKX
Una clave de API de solo lectura deja que una aplicación vea tu cuenta sin poder operar ni retirar. Los permisos exactos en Kraken, Kraken Futures, Coinbase y OKX, y el límite por IP.
Una clave de API de solo lectura es una clave de acceso a tu cuenta en una plataforma que permite consultar tus saldos, tus órdenes y tu historial, sin poder enviar una orden, transferir ni retirar.
Por qué importan los permisos de la clave
Una aplicación que sigue tu cartera guarda tu clave para llamar a la plataforma en tu lugar. Si esa clave se filtra, da sus permisos, y solo esos. Coinbase advierte sobre su permiso Transfer: quien obtiene el secreto de una clave así puede enviar todas tus criptomonedas fuera de tu cuenta. Una clave de solo lectura solo muestra lo que ves tú.
Los permisos en cada plataforma
| Plataforma | Permisos que dar | Permisos que rechazar |
|---|---|---|
| Kraken | Query Funds, Query Open Orders & Trades, Query Closed Orders & Trades, Query Ledger Entries, Export Data | Depósito, retirada y cualquier permiso que cree, modifique o cancele órdenes |
| Kraken Futures | General API en solo lectura | General API con acceso completo, Withdrawal API con acceso completo |
| Coinbase | View | Trade, Transfer |
| OKX | Read | Trade, Withdraw |
Qué permite cada permiso
- Kraken: los permisos de consulta leen los fondos, las órdenes abiertas y cerradas, el libro mayor y las exportaciones; los de depósito, retirada y órdenes actúan sobre la cuenta.
- Kraken Futures: una clave aparte. En solo lectura, solo abre los puntos de acceso que no escriben nada en el servidor. El acceso completo la convierte en una clave maestra, y las retiradas dependen de un permiso separado, la Withdrawal API.
- Coinbase: View consulta la cuenta, Trade envía órdenes, Transfer envía fondos.
- OKX: Read consulta la cuenta y su historial; Trade envía y cancela órdenes, transfiere fondos y cambia ajustes; Withdraw retira.
Limitar la clave a una dirección IP
Una clave también puede limitarse a direcciones IP: la plataforma la rechaza si la llamada viene de otro sitio, aunque lleve el secreto correcto.
- Kraken ofrece, para cada clave, una lista de direcciones IP autorizadas y una fecha de caducidad.
- Coinbase recomienda su lista de direcciones IP autorizadas, sin imponerla.
- OKX acepta hasta 20 direcciones IP por clave. Una clave que puede operar o retirar sin estar vinculada a una dirección IP caduca tras 14 días sin uso.
Hyperliquid: ninguna clave
El punto de acceso info de Hyperliquid responde para cualquier dirección, que se da en claro en la solicitud: para seguir una cuenta, basta con su dirección. Hyperliquid indica que hay que dar la dirección de la propia cuenta, no la de una API wallet, que devuelve un resultado vacío.
Revisar una clave después
- Repasa sus permisos: la página de API de la plataforma muestra los de cada clave.
- Borra una clave que no uses: una clave borrada ya no sirve para nada, aunque su secreto se haya filtrado.
- Sustituye una clave de la que dudes: crea la nueva, ponla en la aplicación, comprueba que funciona y luego borra la antigua.
Cómo trata CentraFIN tu clave
- Verificada antes de guardarla: CentraFIN pregunta a Coinbase y a OKX los permisos de una clave nueva, y la rechaza si puede operar, transferir o retirar. Kraken no permite esta verificación: la ventana para añadirla enumera los permisos que marcar.
- Cifrada: la clave y su secreto se cifran (AES-256-GCM) en cuanto llegan y no vuelven a mostrarse nunca.
- Una sola dirección: las llamadas salen de nuestro servidor de retransmisión, 130.110.240.91, la dirección que debes autorizar en tu clave.
Para cada plataforma, paso a paso: Kraken, Kraken Futures, Coinbase, OKX y Hyperliquid.
Fuentes
- Kraken: crear una clave de API
- Kraken Futures: crear una clave de API
- Coinbase: autenticación con clave de API
- OKX: creación de una clave de API
- Hyperliquid: el punto de acceso info
Preguntas frecuentes
¿Puede una clave de solo lectura vaciar mi cuenta?
No. No puede enviar órdenes, ni transferir, ni retirar. En cambio, sí muestra tus saldos y tu historial a quien la tenga.
¿Hace falta una clave por aplicación?
Es preferible: así puedes borrar una sin tocar las demás.
¿Por qué limitar la clave a una dirección IP?
Porque una clave robada deja de servir en otro sitio: la plataforma rechaza cualquier llamada que no venga de una dirección autorizada.
¿Qué ve CentraFIN con mi clave?
Lo que la clave permite consultar: saldos, posiciones, órdenes, ejecuciones y transferencias. Nada más, ya que no puede hacer otra cosa.
Toma el control de tu patrimonio
Tu cuenta está lista en un minuto, sin contraseña.