Communitygithub.com

Superior-Trade/superior-skills

Habilidades abertas de agentes e esquemas de ferramentas para Superior Trade — construa, faça backtest e implante estratégias de trading na Hyperliquid

O que é superior-skills?

Esta habilidade permite que agentes de IA autentiquem-se na API da Superior Trade e façam requisições autenticadas à plataforma Superior Trade, uma infraestrutura de trading para estratégias em Hyperliquid, Aerodrome e Binance. Ela gerencia todo o fluxo de onboarding de chaves de API — solicitando o e-mail do usuário, enviando uma requisição de magic link para a API, e instruindo o usuário a recuperar a chave de seu e-mail e configurá-la como variável de ambiente ou credencial segura. A habilidade também define regras operacionais claras: sempre preferir `SUPERIOR_TRADE_API_KEY` do ambiente, usar a URL base `https://api.superior.trade`, tratar chaves de API como segredos sem nunca exibi-las, e nunca fabricar o status de autenticação — em vez disso, fazer chamadas reais à API para verificar. É compatível com agentes de linha de comando como Claude Code, Cursor e Codex, e funciona em conjunto com as habilidades `superior-trade-hyperliquid` para backtests e implantações de estratégias, e `polymarket` para descoberta de mercados na Polymarket.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add Superior-Trade/superior-skills

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Autenticação Superior Trade

Use esta habilidade para obter uma chave de API da Superior Trade e fazer requisições autenticadas para https://api.superior.trade.

Onboarding da Chave de API

Se o usuário ainda não possui uma chave de API da Superior Trade, peça o endereço de e-mail que deve receber a chave. Não peça chaves de carteira, frases-semente, chaves privadas, senhas ou outros segredos.

Solicite a chave com:

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

A API envia a chave diretamente para a caixa de entrada do usuário. Informe ao usuário que ele deve recuperar a chave do e-mail e configurá-la em seu repositório normal de credenciais ou ambiente, geralmente como SUPERIOR_TRADE_API_KEY.

Não cole a chave recebida em chat, arquivos de código, logs ou exemplos. Se o usuário fornecer uma chave no chat, trate-a como um segredo e evite repeti-la.

Requisições Autenticadas

Use a chave no cabeçalho x-api-key:

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

O e-mail é verificado assim que a chave de API for usada com sucesso em uma requisição autenticada, como a verificação de status acima. Se a primeira requisição autenticada falhar com 401 ou 403, peça ao usuário para confirmar que copiou a chave completa do e-mail mais recente e que a credencial está sendo passada como cabeçalho x-api-key.

Regras Operacionais

  • Prefira SUPERIOR_TRADE_API_KEY do ambiente ou gerenciador de credenciais quando disponível.
  • Use https://api.superior.trade como URL base da API de produção.
  • Use Content-Type: application/json para corpos de requisição JSON.
  • Nunca invente o status de autenticação. Verifique fazendo uma chamada real à API quando as credenciais estiverem disponíveis.
  • Nunca solicite ou manipule chaves privadas, frases-semente ou credenciais de carteira.
  • Nunca inicie trading ao vivo, depósitos ou outras ações que movimentem fundos sem as confirmações explícitas exigidas pela habilidade de trading relevante da Superior Trade.

Habilidades Relacionadas

  • Use a habilidade superior-trade-hyperliquid para backtests, implantações, carteiras, financiamento e fluxos de trading ao vivo na Hyperliquid, Aerodrome e Binance.
  • Use a habilidade polymarket para descoberta de mercados, backtests, implantações e fluxos de financiamento na Polymarket.

Habilidades Relacionadas