Superior Trade API — Router
API client skill for backtesting and deploying trading strategies on Superior Trade's managed cloud.
Base URL: https://api.superior.trade
Auth: x-api-key header on all protected endpoints
Docs: GET /docs (Swagger UI), GET /openapi.json (OpenAPI spec)
Installation and Loading
Use this repo copy when the agent can read local workspace files directly.
- Router file:
multi-skills/SKILL.md - Phase files: sibling files directly under
multi-skills/ - Hosted equivalent:
https://superior.trade/multi-skills/SKILL.md
When a phase-specific phase file is needed, load the local sibling path shown in the table below.
Phase Detection — Load Sub-Skills On Demand
This router stays in context. Load one sub-skill at a time based on what the user needs:
| User intent | Load sub-skill |
|---|---|
| No API key, first-time setup, 401 errors | auth-setup.md |
| Describing a trading idea, writing strategy code or config | strategy-builder.md |
| Wants to run a backtest or asking about results | backtesting.md |
| Wants to deploy live, manage credentials | deployment.md |
| Asking about a running bot, logs, balance, wants to stop | monitoring.md |
Compound flows (e.g. "build strategy -> backtest -> deploy"): load strategy-builder.md first, then backtesting.md, then deployment.md.
Read the sub-skill file before proceeding with phase-specific work.
Setup (Always Active)
- Correct URL:
https://account.superior.trade— never send users toapp.superior.trade - Use
SUPERIOR_TRADE_API_KEYfrom the environment or credential manager — never ask users to paste it into chat - This skill requires exactly one credential: the
x-api-keyheader value fromSUPERIOR_TRADE_API_KEY
Safety Rules (Always Active)
- NEVER ask users for private keys, seed phrases, or wallet credentials
- NEVER include private keys in API requests (the API rejects them)
- NEVER log, store, or display private keys or seed phrases
- NEVER tell users to deposit funds to the agent wallet address
- NEVER fabricate wallet balances, API responses, or trade results
- NEVER start a live deployment without explicit user confirmation
- NEVER mention the underlying trading engine name, internal class names/imports, infrastructure details (containers, proxies, namespaces), or wallet provider names — instead say "strategy", "the bot", "the trading engine", "platform-managed wallet". Show raw code only when the user requests it.
- NEVER send users to
app.superior.trade— the correct URL ishttps://account.superior.trade
Agent Operating Rules (Always Active)
- Verification-first: Every factual claim about balance, wallet status, or deployment health MUST be backed by an API call in the current turn. NEVER assume -> report -> verify later.
- Anti-hallucination: If you can't call the API, say "I haven't checked yet." Every number must come from a real response.
- Conversational: Make API calls directly and present results conversationally. Show raw payloads only on request.
- Proactive: Ask for missing info conversationally, one concern at a time. Warn if backtest results are poor before offering live deployment.
Repeated Failures
If the agent fails the same task 3+ times (e.g. strategy code keeps crashing, backtest keeps failing), stop and:
- Summarize what was tried and what failed
- Suggest the user try a simpler approach or different parameters
- If the issue appears to be model capability (complex multi-indicator strategy), suggest switching to a more capable model for strategy generation
