Clave de API de solo lectura: los permisos que tenés que tildar 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 colocar 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 nombre. Si esa clave se filtra, entrega sus permisos, y solo esos. Coinbase advierte sobre su permiso Transfer: quien consiga 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 vos mismo.
Los permisos en cada plataforma
| Plataforma | Permisos que tenés que dar | Permisos que tenés que rechazar |
|---|---|---|
| Kraken | Query Funds, Query Open Orders & Trades, Query Closed Orders & Trades, Query Ledger Entries, Export Data | Depósito, retiro y cualquier permiso que cree, modifique o cancele órdenes |
| Kraken Futures | General API de 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, de retiro y de órdenes actúan sobre la cuenta.
- Kraken Futures: una clave aparte. En solo lectura, solo abre los endpoints que no escriben nada en el servidor. El acceso completo la convierte en una clave maestra, y los retiros dependen de un permiso separado, la Withdrawal API.
- Coinbase: View consulta la cuenta, Trade coloca órdenes, Transfer envía fondos.
- OKX: Read consulta la cuenta y su historial; Trade coloca y cancela órdenes, transfiere fondos y cambia configuraciones; Withdraw retira.
Limitar la clave a una dirección IP
Una clave también se puede limitar a ciertas direcciones IP: la plataforma la rechaza si la llamada viene de otro lado, aunque tenga el secreto correcto.
- Kraken ofrece, para cada clave, una lista de direcciones IP autorizadas y una fecha de vencimiento.
- Coinbase recomienda su lista de direcciones IP autorizadas, sin exigirla.
- OKX acepta hasta 20 direcciones IP por clave. Una clave que puede operar o retirar sin estar vinculada a una dirección IP vence después de 14 días sin uso.
Hyperliquid: ninguna clave
El endpoint info de Hyperliquid responde para cualquier dirección, indicada en texto plano en la solicitud: para seguir una cuenta, alcanza con su dirección. Hyperliquid aclara que hay que dar la dirección de la cuenta misma, no la de una API wallet, que devuelve un resultado vacío.
Revisar una clave después
- Revisá sus permisos: la página de API de la plataforma muestra los de cada clave.
- Borrá una clave que no usás: una clave borrada ya no sirve para nada, aunque su secreto se haya filtrado.
- Reemplazá una clave de la que dudes: creá la nueva, ponela en la aplicación, verificá que funcione y después borrá la anterior.
Cómo trata CentraFIN tu clave
- Verificada antes de guardarse: CentraFIN les pide 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 agregarla enumera los permisos que hay que tildar.
- Cifrada: la clave y su secreto se cifran (AES-256-GCM) apenas llegan y nunca se vuelven a mostrar.
- Una sola dirección: las llamadas salen de nuestro servidor de retransmisión, 130.110.240.91, la dirección que tenés que autorizar en tu clave.
Para cada plataforma, paso a paso: Kraken, Kraken Futures, Coinbase, OKX y Hyperliquid.
Fuentes
- Kraken: cómo crear una clave de API
- Kraken Futures: cómo crear una clave de API
- Coinbase: autenticación con clave de API
- OKX: creación de una clave de API
- Hyperliquid: el endpoint info
Preguntas frecuentes
¿Una clave de solo lectura puede vaciar mi cuenta?
No. No puede colocar órdenes, ni transferir, ni retirar. En cambio, sí le muestra tus saldos y tu historial a quien la tenga.
¿Conviene usar una clave por aplicación?
Es preferible: así podés borrar una sin tocar las demás.
¿Por qué limitar la clave a una dirección IP?
Porque una clave robada se vuelve inútil en cualquier otro lado: la plataforma rechaza toda 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 nada más.
Tomá el control de tu patrimonio
Tu cuenta está lista en un minuto, sin contraseña.