Communitygithub.com

Superior-Trade/superior-skills

Habilidades abiertas de agente y esquemas de herramientas para Superior Trade: construye, prueba y despliega estrategias de trading en Hyperliquid.

¿Qué es superior-skills?

Este skill proporciona flujos de trabajo completos de autenticación y solicitudes para la API de Superior Trade, permitiendo a los agentes de IA gestionar de forma segura claves API, ejecutar backtests y desplegar estrategias de trading en Hyperliquid. Es compatible con plataformas como Claude Code, Cursor y Codex, y está diseñado para desarrolladores y operadores algorítmicos que necesitan interactuar con la infraestructura de trading descentralizada de Superior Trade. El skill gestiona la obtención de claves API mediante enlaces mágicos (magic links) por correo electrónico, evitando la exposición de secretos, y utiliza esas credenciales para realizar solicitudes autenticadas a los endpoints de la API. Incluye reglas operativas claras para evitar el manejo de claves privadas, frases semilla o credenciales de wallet, y delega las acciones que implican fondos (trading en vivo, depósitos) a skills específicos como 'superior-trade-hyperliquid' o 'polymarket'. De esta forma, los agentes pueden integrar de manera segura flujos de trading automatizados sin comprometer la seguridad ni la integridad de los activos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add Superior-Trade/superior-skills

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Autenticación de Superior Trade

Usa este skill para obtener una clave API de Superior Trade y realizar solicitudes autenticadas a https://api.superior.trade.

Obtención de clave API

Si un usuario aún no tiene una clave API de Superior Trade, solicita la dirección de correo electrónico que debe recibirla. No pidas claves de wallet, frases semilla, claves privadas, contraseñas ni otros secretos.

Solicita la clave con:

curl -sS https://api.superior.trade/auth/sign-in/magic-link \
  -X POST \
  -H 'Content-Type: application/json' \
  -d '{"email":"[email protected]"}'

La API envía la clave directamente a la bandeja de entrada del usuario. Indícale al usuario que recupere la clave de su correo y la configure en su gestor de credenciales habitual o en el entorno, normalmente como SUPERIOR_TRADE_API_KEY.

No pegues la clave recibida en el chat, archivos de código, registros o ejemplos. Si el usuario proporciona una clave en el chat, trátala como un secreto y evita repetirla.

Solicitudes autenticadas

Usa la clave en el encabezado x-api-key:

curl -sS https://api.superior.trade/v2/account \
  -H "x-api-key: $SUPERIOR_TRADE_API_KEY"

El correo electrónico se verifica una vez que la clave API se usa correctamente en una solicitud autenticada como la comprobación de estado anterior. Si la primera solicitud autenticada falla con 401 o 403, pídele al usuario que confirme que copió la clave completa del último correo y que la credencial se está pasando como el encabezado x-api-key.

Reglas de operación

  • Prefiere SUPERIOR_TRADE_API_KEY del entorno o del gestor de credenciales cuando esté disponible.
  • Usa https://api.superior.trade como URL base de la API de producción.
  • Usa Content-Type: application/json para los cuerpos de las solicitudes JSON.
  • Nunca inventes el estado de autenticación. Verifícalo realizando una llamada API real cuando las credenciales estén disponibles.
  • Nunca solicites ni manejes claves privadas, frases semilla o credenciales de wallet.
  • Nunca inicies trading en vivo, depósitos u otras acciones que muevan fondos sin las confirmaciones explícitas requeridas por el skill de trading correspondiente de Superior Trade.

Skills relacionados

  • Usa el skill superior-trade-hyperliquid para backtests, despliegues, wallets, financiación y flujos de trading en vivo en Hyperliquid, Aerodrome y Binance.
  • Usa el skill polymarket para descubrimiento de mercados en Polymarket, backtests, despliegues y flujos de financiación.

Skills relacionados