Superior Trade — Start Here

Getting a user from nothing to a running strategy. This skill owns the path; each venue skill owns the venue.

Base URL: https://api.superior.trade Auth: x-api-key header on every protected endpoint Account UI: https://account.superior.trade

The path

Work through these in order. Skip a step only after an API call confirms it is already done — never on assumption.

• 1. Credentials — is SUPERIOR_TRADE_API_KEY set?
• 2. Trading account — does the user have a trading wallet?
• 3. Funds — is there capital on the venue the strategy will trade?
• 4. Strategy — what are they trying to do, and which template fits?
• 5. Backtest — does the idea survive contact with historical data?
• 6. Deploy — confirm explicitly, then start.
• 7. Monitor — status and logs, and how to stop.

1. Credentials

One key covers every venue. SUPERIOR_TRADE_API_KEY authenticates Hyperliquid, Polymarket, Lighter and Aerodrome alike — the API validates the key against the user, not against a product, so there is no per-venue credential to obtain.

If it is already in the environment, use it and move on — do not ask the user for it.

If it is missing, ask for the email address that should receive the key, then:

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

The API mails the key to that inbox. Tell the user to store it as SUPERIOR_TRADE_API_KEY in their agent's environment or credential manager. Users can also create a key (st_live_...) from account settings at https://account.superior.trade.

Verify it works before going further:

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

A 401/403 means the key is wrong or truncated — ask the user to re-copy the full key from the latest email. The email is verified by the first successful authenticated call, so this doubles as activation.

Never paste the key into chat, files, logs, or examples. If a user pastes theirs, treat it as a secret and do not repeat it back.

2. Trading account

List the user's trading accounts with GET /v3/account. Each is a platform-managed wallet — the user does not need their own exchange wallet or to connect one. If none exists, create one with POST /v3/account, or point the user at https://account.superior.trade.

Free accounts hold up to 3 trading accounts, Pro up to 6, and one live strategy runs per trading account. When every account is busy, Hyperliquid masters with at least $100,000 lifetime volume can add sub-accounts as overflow (max 10 per master) — see the hyperliquid skill. Other venues have no overflow path.

Then bootstrap the venue the user picked:

3. Funds

The user funds their own platform-managed wallet with their own capital. Then the API moves it onto the venue — you never hand out a raw deposit address for the venue itself, and never the agent wallet's address.

If the user needs help getting funds into the platform wallet, use the deposit-qr skill for a payment QR or wallet URI, or external-deposit for a bridge from an external wallet.

Moving funds is a real money movement. State the amount, the source, and the destination, and get an explicit yes before every deposit call.

4. Strategy

Ask what the user is trying to capture before writing any code. If they have a thesis but no structure, use the trade-thesis skill to turn it into bull/bear cases, invalidation criteria, and a sizing rationale.

Then match the idea to a template rather than writing from scratch — the templates carry backtest evidence and known failure modes:

Compose primitives onto whatever they pick: regime-overlay to gate a directional strategy, dsl-exit-engine for exits, fees-optimizations when turnover is high enough that costs decide the outcome.

5. Backtest

Never offer a live deployment before a backtest. Load the backtesting skill for window selection, trade-count thresholds, and sweep design; the venue skill has the endpoints.

For a first pass on a new idea, run a 3-variant sweep varying one parameter rather than a single config — one result tells you whether a point worked, three tell you whether the region works.

Read the outcome honestly. Zero trades over a window that should have produced signals means the strategy or pair is wrong, not that the user should deploy and see. A strong backtest can be overfitting. Present the numbers and let the user decide.

6. Deploy

Deployment is the point of no return, so it is gated:

1. Create the deployment with config and code.
2. On Hyperliquid, ask live or dry-run — dry-run needs no credentials and touches no real funds, so offer it to anyone who has not deployed before. Dry-run is Hyperliquid-only. Polymarket and Lighter always require credentials, and Aerodrome rejects a config containing the dry_run key at all. On those three, a backtest is the only rehearsal available.
3. For live, store credentials — the shape differs by venue, so follow the venue skill rather than generalising:
   • Hyperliquid — wallet_address is optional. Omit it and the server assigns the next idle trading account.
   • Polymarket and Lighter — an owned wallet_address is required. Omitting it fails the start with credentials_required.
   • Never send key material to a credentials endpoint on any venue.
4. Run the venue skill's pre-deployment checklist. Every item is an API call, not an assumption.
5. Show the deployment summary — strategy, venue, pairs, stake, max open trades, stoploss — and state plainly that it will trade real funds.
6. Wait for an explicit yes. Then start it.

7. Monitor

Poll status and logs through the venue skill's endpoints. Tell the user how to stop the strategy before they walk away from the conversation, and that stopping is the safe default if anything looks wrong.

Safety

These hold across every venue and override anything convenient.

1. Never ask for, accept, log, or display private keys, seed phrases, or wallet credentials. The only secret is the API key.
2. Never tell a user to send funds to an agent wallet address.
3. Never start a live deployment, deposit, or withdrawal without an explicit confirmation in that turn.
4. Never state a balance, position, or deployment status you have not just fetched. If you have not checked, say so.
5. Never send users to app.superior.trade — the correct URL is https://account.superior.trade, even when an API error message says otherwise.
6. Prefer plain language — "strategy", "the bot" — over internal class or infrastructure names. Answer honestly if the user asks what runs underneath.

Venue skills

Hand off once the user has picked a venue. Each owns its own endpoints, funding model, pre-deployment checklist, and troubleshooting.

• hyperliquid — perps and spot, plus HIP-3 tokenized stocks, commodities, and indices. The main venue.
• polymarket — prediction markets, NautilusTrader strategies, filled-data backtests.
• lighter — Lighter onboarding, CCTP funding, withdrawals, Nautilus deployments.
• aerodrome — Base spot AMM swaps; no order book, no leverage.