SHARKRULE / Aprender

API de Coinbase: configuración, permisos y seguridad

Prepara una cuenta apta de Coinbase Advanced para el lanzamiento Spot de SharkRule en Reino Unido. Revisa los activos admitidos, el acceso, los permisos y las reglas de compra y venta que apruebas. La nueva activación con dinero real todavía no está abierta; se mantiene la guía para conexiones existentes y recuperación.

SharkRule · Revisado

Comprueba primero la disponibilidad

Esta guía conserva las instrucciones de clave manual para conexiones existentes. Antes de abrir la activación en Reino Unido, el método de acceso para nuevos clientes requiere confirmación de Coinbase. Sigue solo el método ofrecido en tu cuenta; superar una comprobación técnica no demuestra autorización del proveedor para acceso alojado.

Antes de empezar: Necesitas tu propia cuenta de Coinbase. Si aún no tienes una, créala directamente en el exchange y completa las verificaciones y comprobaciones de cuenta que te pida antes de crear una clave API. SharkRule no crea una cuenta en el exchange por ti.

Puedes probar una simulación de SharkRule sin tener una cuenta en un exchange.

Preparamos el lanzamiento inicial en Reino Unido con Coinbase Advanced Spot. La lista incluye Bitcoin (BTC), Ethereum (ETH) y Solana (SOL), cada uno frente a GBP, USD o USDC cuando la cuenta Coinbase del cliente permita operar el par. Tú eliges y apruebas el activo, importe, entrada, salida y límites. Las estrategias existentes de solo compra no reciben venta automática.

La conexión preparada admite una cartera de tipo consumidor o predeterminada, con View y Trade activados y Transfer desactivado. También se aplican los requisitos de Coinbase y los productos disponibles en tu cuenta.

Si aparece «Verifica tu empresa»

El portal de Coinbase incluye varios productos. La tarjeta de verificación de empresa para las API de custodia corresponde a un proceso distinto del de la clave API de la cuenta personal que usa SharkRule.

Abre el menú (☰ en el teléfono) y ve a API Keys → Secret API Keys. También puedes volver a abrir el enlace directo a la página de claves después de iniciar sesión. Continúa con tu cuenta personal de Coinbase y selecciona la cartera que quieras usar; el nombre que aparece puede ser Primary.

Si no tienes acceso a Secret API Keys o a tu cartera personal, contacta con el soporte de Coinbase para comprobar el acceso de tu cuenta antes de continuar.

Crea tu clave API secreta

  1. Inicia sesión en Coinbase y abre la página oficial de claves: https://portal.cdp.coinbase.com/api-keys/secret. En API Keys, elige Secret API Keys y Create API key. Comprueba la dirección antes de introducir datos de acceso.
  2. En API key nickname, escribe SharkRule para reconocer la clave más adelante. Usa esta clave exclusivamente para este servicio, separada de las de otros programas.
  3. En IP allowlist, introduce solo las direcciones IP del servidor que aparecen en la página de conexión de SharkRule después de iniciar sesión. Deja Allow requests from any IP address sin marcar. Las direcciones de ejemplo de Coinbase, como 192.168.1.0/24 y 2001:db8::/32, son marcadores de posición, no direcciones de SharkRule. No uses la IP de tu casa o móvil. Si SharkRule no muestra direcciones del servidor, espera a que se habilite la configuración.
  4. Abre Advanced settings. En Coinbase App & Advanced Trade, selecciona la cartera que quieras usar; puede llamarse Primary. Marca View (read-only) y Trade (execute trades on your behalf). Deja Transfer (initiate transfer of funds) y Receive (receive inbound payments) sin marcar. En Account → Non-custodial, deja también Export (export private key) y Manage (modify policies) sin marcar. SharkRule no necesita esos permisos adicionales.
  5. En Signature algorithm, selecciona ECDSA (Legacy SDKs), aunque Ed25519 aparezca como Recommended. La conexión actual de SharkRule requiere ECDSA / ES256. La etiqueta Legacy SDKs no significa que debas usar las credenciales antiguas de Coinbase Pro.
  6. Selecciona Create y completa las verificaciones de seguridad de Coinbase. En la ventana Save your API key, copia API key ID y Secret en los campos correspondientes de SharkRule. API key ID es el valor completo que empieza por organizations/…/apiKeys/…; el apodo SharkRule es solo una etiqueta. Secret es tu clave privada ECDSA. Conserva sus líneas BEGIN y END y todos los saltos de línea. Guarda ambos valores de forma segura antes de cerrar esta ventana, que solo se muestra una vez; Coinbase también ofrece Download API key. Nunca incluyas el secreto en capturas, correos ni consultas de soporte.

Si no puedes seleccionar Trade, consulta con el soporte de Coinbase el acceso de tu cuenta y cartera antes de continuar. Una clave que solo tenga View no puede automatizar operaciones; activar otros permisos no lo solucionará.

Configúrala desde el móvil

Abre la misma dirección de CDP en el navegador del móvil. Si faltan controles, solicita la versión de escritorio o termina desde un ordenador. Este procedimiento no utiliza un botón de aprobación automática en la aplicación de Coinbase.

Al copiar Secret, conserva los saltos de línea de la clave privada y las líneas BEGIN y END. Evita enviarla por mensajería o mediante un portapapeles compartido.

Conectar y revisar en SharkRule

  1. Abre Mi exchange en SharkRule y elige Coinbase. Pega los valores completos de API key ID y Secret de la ventana Save your API key de Coinbase en los campos correspondientes. Verificar y conectar comprueba la cuenta y los permisos; no envía órdenes.
  2. Pares Spot preparados: BTC-GBP, BTC-USD, BTC-USDC, ETH-GBP, ETH-USD, ETH-USDC, SOL-GBP, SOL-USD y SOL-USDC. Solo podrás usar un par si está disponible para tu cuenta apta y se confirma durante la revisión. Mantén la moneda de cotización correspondiente en la cartera conectada.
  3. Elige una compra tras una bajada, con seguimiento durante 24 horas, o compras programadas con al menos una hora de separación. Define el presupuesto total con comisiones, el máximo por compra y hasta 100 compras programadas.
  4. Revisa el par exacto, importe, entrada, límites de compra y comisiones. Para vender automáticamente, indica tu objetivo de subida, porcentaje de stop loss o ambos antes de revisar. Deja ambos vacíos para solo comprar. Cada condición usa el precio medio de esa compra antes de comisiones y solo afecta al activo comprado por esta estrategia. Aprueba expresamente las reglas antes de iniciar cuando la activación esté disponible. La primera compra programada puede ocurrir después de iniciar.

SharkRule supervisa la venta automática; no es una orden stop o bracket pendiente en Coinbase. Necesita que el servicio, la conexión y los permisos sigan disponibles. Los saltos de precio, la liquidez, las comisiones, los mínimos del exchange y las interrupciones pueden impedir la venta o dejar un pequeño remanente. Un stop loss no garantiza una pérdida máxima. Las compras programadas respetan el número y presupuesto aprobados; los ingresos por ventas no aumentan esos límites.

Las órdenes deben ejecutarse por completo al precio límite o mejor, o se cancelan. Una compra sin ejecutar detiene nuevas compras; las salidas ya aprobadas siguen supervisándose. Tras confirmar una venta sin ejecutar, SharkRule puede volver a intentarlo, con un máximo de tres intentos de venta por compra y al menos 30 segundos entre intentos. El límite de compras cuenta intentos de compra. Los resultados desconocidos se verifican antes de cualquier otra orden.

Coinbase determina las comisiones reales. Si los costes comunicados superan el importe aprobado, las siguientes compras se detienen para revisión; la reserva para comisiones no es una garantía del exchange.

Conectar Coinbase con SharkRule

Resuelve los errores sin ampliar permisos

Comprueba si API key ID está incompleto, faltan líneas en Secret, elegiste Ed25519 en lugar de ECDSA, la lista de IP es incorrecta, Transfer está activo o seleccionaste otra cartera. Una clave válida puede pertenecer a un tipo de cuenta no admitido. Lee el error antes de crear más claves.

El saldo disponible puede ser menor que el valor total por órdenes abiertas o fondos en otra cartera. También cuentan los mínimos de orden y las comisiones. Para pedir ayuda, comparte únicamente el error sin datos sensibles y la hora.

Retirar el acceso en el proveedor

Detén la estrategia en SharkRule antes de desconectar. Detenerla impide nuevas compras y ventas automáticas; no vende los activos. Una orden ya enviada puede completarse y debe verificarse antes de desconectar. No envíes otra orden para adivinar un resultado desconocido. Si una clave se ha expuesto, revócala de inmediato en Coinbase y revisa la actividad.

Preguntas frecuentes

¿Debo introducir mi contraseña de Coinbase en SharkRule?

No. Utiliza solo los campos CDP de la conexión habilitada. No compartas contraseñas, códigos de verificación ni frases de recuperación.

¿Es una autorización con un solo clic?

No. Esta guía explica la preparación manual de una clave API. Cualquier otro flujo de autorización y su disponibilidad deben confirmarse por separado.

Fuentes oficiales

Elaborado con ayuda de IA a partir de la documentación oficial enlazada. Los ejemplos son hipotéticos; no se realizaron pruebas con cuentas reales ni comparaciones de rentabilidad.