Agent skill

Superior Trade Auth

by Superior-Trade in Superior-Trade/superior-skills

A skill your agent uses when an agent needs to register a Superior Trade account, verify an email OTP, configure x-api-key authentication, or recover from missing or invalid credentials before using…

MITAuto-check passedBusiness, Finance & HR

Install Superior Trade Auth

skills CLI
$ npx skills add Superior-Trade/superior-skills --skill superior-trade-auth -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Superior-Trade/superior-skills superior-trade-auth --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
superior-trade-auth
GitHub stars
215
Token cost
~950 tokens
SKILL.md length
391 words
Files
24 (incl. scripts, references)
Skills in repo
31
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when an agent needs to register a Superior Trade account, verify an email OTP, configure x-api-key authentication, or recover from missing or invalid credentials before using…

  • An agent needs to register a Superior Trade account
  • SKILL.md covers API Key Onboarding, Authenticated Requests, Operating Rules and Next: the rest of the library
  • Calls curl and npx; reaches api.superior.trade; needs SUPERIOR_TRADE_API_KEY
  • Verify an email OTP

What it does

Superior Trade Auth is an agent skill from Superior-Trade/superior-skills. Use when an agent needs to register a Superior Trade account, verify an email OTP, configure x-api-key authentication, or recover from missing or invalid credentials before using the Unified API.

Its SKILL.md is about 950 tokens, which your agent loads only when the skill is triggered. The skill folder holds 30 other files, including scripts and reference files (for example `.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json` and `.turbo-upstream.json`).

It sits in Business, Finance & HR, covering Trading and backtesting and Authentication. The repository describes itself as: Open agent skills and tool schemas for Superior Trade — build, backtest, and deploy trading strategies on Hyperliquid. The licence is MIT.

When your agent uses it

  • An agent needs to register a Superior Trade account
  • Verify an email OTP
  • Configure x-api-key authentication
  • Recover from missing

Example prompts

  • “/superior-trade-auth”

Requirements

  • Node.js
  • A credential in SUPERIOR_TRADE_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 9d41db5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • curl
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.superior.trade

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • SUPERIOR_TRADE_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Superior Trade Auth loads about 950 tokens when it runs, and up to ~1.6k if it reads all its reference files. Until then it costs about 54 tokens; SKILL.md has 391 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~950
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from Superior-Trade/superior-skills at commit 9d41db5, republished under its MIT licence (© Superior-Trade). 391 words, ~950 tokens.

Download SKILL.mdSave it as .claude/skills/superior-trade-auth/SKILL.md (or your agent's skills folder). This skill also uses 23 other files; get the full folder from GitHub.
name
superior-trade-auth
description
Use when an agent needs to register a Superior Trade account, verify an email OTP, configure x-api-key authentication, or recover from missing or invalid credentials before using the Unified API.
license
see LICENSE
metadata.version
1.0.0

Superior Trade Authentication

Use this skill to get a Superior Trade API key and make authenticated requests to https://api.superior.trade.

API Key Onboarding

If a user does not already have a Superior Trade API key, ask for the email address that should receive the key. Do not ask for wallet keys, seed phrases, private keys, passwords, or other secrets.

Request a verification OTP with:

bash
curl -sS https://api.superior.trade/account/register \
  -X POST \
  -H 'Content-Type: application/json' \
  -d '{"email":"user@example.com"}'

Ask the user for the OTP sent to that inbox, then exchange it for an API key:

bash
curl -sS https://api.superior.trade/account/verify \
  -X POST \
  -H 'Content-Type: application/json' \
  -d '{"email":"user@example.com","otp":"123456"}'

Tell the user to configure the returned key in their normal credential store or environment, usually as SUPERIOR_TRADE_API_KEY.

Do not paste the received key into chat, source files, logs, or examples. If the user provides a key in chat, treat it as a secret and avoid repeating it.

Authenticated Requests

Use the key in the x-api-key header:

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

The email is verified once the API key is used successfully in an authenticated request such as the status check above. If the first authenticated request fails with 401 or 403, ask the user to confirm they copied the full key from the latest email and that the credential is being passed as the x-api-key header.

Show full SKILL.md (198 more words)Show less

Operating Rules

  • Prefer SUPERIOR_TRADE_API_KEY from the environment or credential manager when it is available.
  • Use https://api.superior.trade as the production API base URL.
  • Use only the unversioned Unified API contract from GET /openapi.json.
  • Use Content-Type: application/json for JSON request bodies.
  • Never fabricate authentication status. Verify by making a real API call when credentials are available.
  • Never request or handle private keys, seed phrases, or wallet credentials.
  • Never start live trading, deposits, or other fund-moving actions without the explicit confirmations required by the relevant Superior Trade trading skill.

Next: the rest of the library

This page covers authentication only. Everything past the API key — funding, strategy selection, backtesting, deployment — lives in the installable skill library.

Install it:

bash
npx skills add Superior-Trade/superior-skills

Then load skills/superior-trade, which owns the full path from an empty account to a running strategy and hands off to the venue skills.

  • skills/superior-trade — start here; the access → funding → backtest → deploy path
  • skills/hyperliquid — Hyperliquid perps and spot, including HIP-3 stocks and commodities
  • skills/polymarket — Polymarket discovery, backtests, and deployments
  • skills/lighter — Lighter market context, wallet checks, backtests, and contract-supported Nautilus deployments
  • skills/aerodrome — Aerodrome/Base spot-AMM workflows
  • skills/deposit-qr — QR code or payment URI to fund a Superior-managed wallet
  • skills/external-deposit — external bridge links, Relay quotes, MetaMask Mobile QR

© Superior-Trade, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 23 other files (scripts, references) in the repository root of Superior-Trade/superior-skills.

  • SKILL.md
  • .claude-plugin/marketplace.json
  • .claude-plugin/plugin.json
  • .clawhubignore
  • .gitignore
  • .turbo-upstream.json
  • AUTHORING.md
  • LICENSE
  • README.md
  • docs/superpowers/plans/2026-09-03-unified-api-skills-sync.md
  • docs/superpowers/specs/2026-09-03-unified-api-skills-sync-design.md
  • package.json
  • references/unified-runtime.md
  • scripts/api-contract
  • … and 10 more

Open the folder on GitHubat commit 9d41db5

Compare with similar skills

Superior Trade Auth next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Superior Trade Auth compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Superior Trade Auth this skillSuperior-Trade/superior-skills215—~950Automated safety check: PassMIT
Metamask Agent Walletnirholas/three.ws230—~4.5kAutomated safety check: PassMIT
Trading212 APItrading212-labs/agent-skills129—~11kAutomated safety check: PassMIT
Agentic Walletcoinbase/agentic-wallet-skills1262 repos~1kAutomated safety check: PassMIT
Alpaca CLIalpacahq/cli178—~2.6kAutomated safety check: PassApache-2.0
Onchain Pay Open APInpc-live/clawfirm1561 repos~4.9kAutomated safety check: PassMIT

Similar skills

  • Metamask Agent Wallet

    nirholas/three.ws

    A skill your agent uses when the user asks anything about blockchain wallets, transactions, signing, token transfers, supported chains, wallet balances, perpetual futures trading, prediction…

    230 GitHub stars~4.5k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Trading212 API

    trading212-labs/agent-skills

    This skill should be used when the user asks to "connect to Trading 212", "authenticate Trading 212 API", "place a trade", "buy stock", "sell shares", "place market order",, "place pending order"…

    129 GitHub stars~11k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Agentic Wallet

    coinbase/agentic-wallet-skills

    Crypto wallet operations via the awal CLI — sign in, check balances, send USDC/ETH/POL/SOL, trade tokens, fund the wallet, and use the x402 payment protocol to discover paid services, pay for API…

    126 GitHub starsUsed in 2 repos~1k tokens
    Backend & APIsAuto-check passed
  • Alpaca CLI

    alpacahq/cli

    Install, configure, and use the Alpaca CLI - a command-line tool for the Alpaca Trading API.

    178 GitHub stars~2.6k tokensUpdated 2 days ago
    Business, Finance & HRAuto-check passed
  • Onchain Pay Open API

    npc-live/clawfirm

    Binance Onchain Pay enables users to buy cryptocurrency with fiat (e.g., EUR, USD) or send existing crypto from their Binance account directly to any external on-chain wallet address in a single…

    156 GitHub starsUsed in 1 repo~4.9k tokens
    Business, Finance & HRAuto-check passed
  • Alpaca Broker Integration

    alpacahq/alpaca-skills

    Entry point for integrating with the Alpaca Broker API (plus Market Data and Trading APIs) in any programming language.

    154 GitHub stars~3k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed

More from Superior-Trade/superior-skills

All 31 skills in this repo
  • Deposit Qr

    Superior-Trade/superior-skills

    A skill your agent uses when a user needs a QR code or wallet payment URI to fund a Superior-managed EVM wallet on a specific chain before using Lighter, Polymarket, Hyperliquid, or other Superior…

    215 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • External Deposit

    Superior-Trade/superior-skills

    A skill your agent uses when a user wants to fund or bridge from an external wallet through a third-party UI such as Relay, especially when asking for MetaMask Mobile QR codes, bridge links…

    215 GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Aerodrome

    Superior-Trade/superior-skills

    A skill your agent uses when creating, validating, backtesting, deploying, sizing, or troubleshooting Aerodrome/Base spot trading strategies through the Superior Trade API, especially Freqtrade…

    215 GitHub stars~2.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Polymarket

    Superior-Trade/superior-skills

    A skill your agent uses when the user wants to trade, research, or backtest Polymarket prediction markets through Superior Trade — finding markets by slug or event URL, placing a single immediate…

    215 GitHub stars~4.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Backtesting

    Superior-Trade/superior-skills

    A skill your agent uses when running, interpreting, or designing backtests on Superior Trade — anything about backtest windows, trade-count thresholds, exit-reason mix, parameter sweeps…

    215 GitHub stars~2.9k tokensUpdated 1 mo ago
    Auto-check passed
  • Basis Arb

    Superior-Trade/superior-skills

    A skill your agent uses when the user asks for spot-perp basis trade, basis arbitrage, cash-and-carry, perp discount, or any setup that reads the spot–perp basis as a positioning signal.

    215 GitHub stars~2.8k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Superior Trade Auth

What does Superior Trade Auth do?

A skill your agent uses when an agent needs to register a Superior Trade account, verify an email OTP, configure x-api-key authentication, or recover from missing or invalid credentials before using…. Superior Trade Auth is an agent skill from Superior-Trade/superior-skills. Use when an agent needs to register a Superior Trade account, verify an email OTP, configure x-api-key authentication, or recover from missing or invalid credentials before using the Unified API.

When should I use Superior Trade Auth?

Superior Trade Auth fits situations like: an agent needs to register a Superior Trade account; verify an email OTP; configure x-api-key authentication; recover from missing.

How do I install Superior Trade Auth in Claude Code?

Run `npx skills add Superior-Trade/superior-skills --skill superior-trade-auth -a claude-code`. Or copy the skill folder (the Superior-Trade/superior-skills repository) into .claude/skills/superior-trade-auth in your project. Claude Code loads it when a task matches its description.

How do I install Superior Trade Auth in Codex?

Run `npx skills add Superior-Trade/superior-skills --skill superior-trade-auth -a codex`. Or copy the skill folder (the Superior-Trade/superior-skills repository) into .agents/skills/superior-trade-auth in your project. Codex loads it when a task matches its description.

Can I use Superior Trade Auth in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Superior-Trade/superior-skills --skill superior-trade-auth -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/superior-trade-auth, .gemini/skills/superior-trade-auth, .github/skills/superior-trade-auth and .opencode/skills/superior-trade-auth in your project.

What does Superior Trade Auth need to run?

Going by SKILL.md and its folder, Superior Trade Auth needs the command-line tools its instructions call (curl and npx) and credentials named SUPERIOR_TRADE_API_KEY. Our summary lists: Node.js; A credential in SUPERIOR_TRADE_API_KEY.

Does Superior Trade Auth access the network?

SKILL.md names 1 domain. In commands or code: api.superior.trade; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Superior Trade Auth safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Superior Trade Auth use?

Superior Trade Auth is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Superior Trade Auth use?

About 950 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 649 tokens, read only when the agent opens those files.

What are the alternatives to Superior Trade Auth?

Skills that share tags, products or a category with Superior Trade Auth: Metamask Agent Wallet (nirholas/three.ws, 230 stars), Trading212 API (trading212-labs/agent-skills, 129 stars), Agentic Wallet (coinbase/agentic-wallet-skills, 126 stars) and Alpaca CLI (alpacahq/cli, 178 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Superior Trade Auth?

Superior-Trade (a GitHub organization) maintains it in Superior-Trade/superior-skills, which has 215 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on September 10, 2026.

Source: Superior-Trade/superior-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.