Superior-Trade/superior-skills

"name": "Superior Trade",     "email": "json@superior.trade",     "url": "https://superior.trade"

"email": "json@superior.trade",     "url": "https://superior.trade"   },

"url": "https://superior.trade"

},   "homepage": "https://github.com/Superior-Trade/superior-skills",   "license": "see LICENSE",

"homepage": "https://github.com/Superior-Trade/superior-skills",

{   "repository": "https://github.com/Superior-Trade/superior-skills.git",

"repository": "https://github.com/Superior-Trade/superior-skills.git",

- [Agent Skills specification](https://agentskills.io) — the six-key frontmatter contract and progressive disclosure

- [Best practices for skill creators](https://agentskills.io/skill-creation/best-practices)

- [Evaluating skill output quality](https://agentskills.io/skill-creation/evaluating-skills)

- [Claude Code skills documentation](https://code.claude.com/docs/en/skills) — discovery paths, listing budget, `context: fork`

Trading strategies and intelligence tools for [Superior Trade](https://superior.trade) — natural-language strategy authoring, backtesting, and autonomous deployment on Hyperliquid, Lighter, and Polymarket.

[Website](https://superior.trade) · [Discord](https://discord.gg/aVZR8cCxcR) · [Twitter](https://x.com/SuperiorTrade_)

"Unavailable" means the skill must report the limitation instead of falling back to a versioned route. See the [full migration guide](https://docs.superior.trade/reference/migration) for

back to a versioned route. See the [full migration guide](https://docs.superior.trade/reference/migration) for the product-level lifecycle.

[full migration guide](https://docs.superior.trade/reference/migration) for

Every skill is a self-contained directory at `skills/<name>/`, following the [Agent Skills](https://agentskills.io) standard. Skill loaders resolve exactly one level, so this depth is a hard requirement rather than a convention — a skill ne

# List trading accounts curl https://api.superior.trade/wallet \

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

# Backtest a strategy curl -X POST https://api.superior.trade/runtime/backtests \

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

# Creation queues the backtest; poll until completion curl https://api.superior.trade/runtime/backtests/{id} \

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

Superior skills follow the open [Agent Skills](https://agentskills.io) standard — one folder per

| **Claude Code** | `/plugin marketplace add Superior-Trade/superior-skills` then `/plugin install superior-skills@superior-trade` | | **OpenClaw / ClawHub** | `openclaw skills install @superior-ai/<skill>` (owner-qualified) &nbsp;·&nbsp; o

| **OpenClaw / ClawHub** | `openclaw skills install @superior-ai/<skill>` (owner-qualified) &nbsp;·&nbsp; or from git: `openclaw skills install git:Superior-Trade/superior-skills@main` | | **From our domain** | point any agent at `https://s

| **From our domain** | point any agent at `https://superior.trade/SKILL.md` |

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

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

curl -sS https://api.superior.trade/account/register \

curl -sS https://api.superior.trade/account/verify \

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

- Use `https://api.superior.trade` as the production API base URL.

Change `[full migration guide](../../apps/docs/content/en/reference/migration.md)` to `[full migration guide](https://docs.superior.trade/reference/migration)`.

Executable file

- Base URL: `${SUPERIOR_UNIFIED_API_URL:-https://api.superior.trade}`

- Base URL: `${SUPERIOR_UNIFIED_API_URL:-https://api.superior.trade}`

- Base URL: `${SUPERIOR_UNIFIED_API_URL:-https://api.superior.trade}`

- Base URL: `${SUPERIOR_UNIFIED_API_URL:-https://api.superior.trade}`

- Base URL: `${SUPERIOR_UNIFIED_API_URL:-https://api.superior.trade}`

- Base URL: `${SUPERIOR_UNIFIED_API_URL:-https://api.superior.trade}`

- Base URL: `${SUPERIOR_UNIFIED_API_URL:-https://api.superior.trade}`

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

"servers": [   {    "url": "https://api.superior.trade"

{    "url": "https://api.superior.trade"   }

"url": "https://api.superior.trade"

#!/usr/bin/env node

const OPENAPI_URL =   process.env.SUPERIOR_UNIFIED_API_OPENAPI_URL ??   "https://api.superior.trade/openapi.json";

"https://api.superior.trade/openapi.json";

if (process.argv.includes("--refresh")) {   const key = process.env.SUPERIOR_TRADE_API_KEY;   const response = await fetch(OPENAPI_URL, {

[Credential-related source omitted]

[Credential-related source omitted]

const response = await fetch(OPENAPI_URL, {

Executable file

const result = runFixtureAudit({     entrySkillAppend:       "\nCall GET /v2/backtesting or GET https://unified-api-zag4gzx6gq-an.a.run.app/wallet during migration.\n",

entrySkillAppend:       "\nCall GET /v2/backtesting or GET https://unified-api-zag4gzx6gq-an.a.run.app/wallet during migration.\n",   });

"\nCall GET /v2/backtesting or GET https://unified-api-zag4gzx6gq-an.a.run.app/wallet during migration.\n",

#!/usr/bin/env bash

[Credential-related source omitted]

trap 'cd "$REPO" 2>/dev/null || cd /; rm -rf "$WORKDIR"' EXIT

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

Executable file

for (const match of text.matchAll(CLAIM)) {     const path = match[2]       .replace("https://api.superior.trade", "")

const path = match[2]       .replace("https://api.superior.trade", "")       .split("?")[0]

.replace("https://api.superior.trade", "")

#!/usr/bin/env node

Executable file

}); const normalize = (url) =>   url.trim().replace(/\.git$/, "").replace(/^git@github\.com:/, "https://github.com/");

const normalize = (url) =>   url.trim().replace(/\.git$/, "").replace(/^git@github\.com:/, "https://github.com/"); if (

url.trim().replace(/\.git$/, "").replace(/^git@github\.com:/, "https://github.com/");

#!/usr/bin/env node

Executable file

- Superior Trade API base URL: `https://api.superior.trade`

[Credential-related source omitted]

[Credential-related source omitted]

- Base RPC URL: `https://mainnet.base.org`

- Production API: `https://api.superior.trade`

- Use explicit numeric `stake_amount`. Avoid `"unlimited"` unless the user explicitly accepts balance exhaustion risk. - Never include wallet private keys or platform-injected exchange credentials in config. - Use `https://mainnet.base.org`

- Never include wallet private keys or platform-injected exchange credentials in config. - Use `https://mainnet.base.org` for `exchange.ccxt_config.options.rpcUrl` unless the user explicitly provides another Base RPC. - Always backtest befo

- Use `https://mainnet.base.org` for `exchange.ccxt_config.options.rpcUrl` unless the user explicitly provides another Base RPC.

"ccxt_config": {       "options": {         "rpcUrl": "https://mainnet.base.org",

"options": {         "rpcUrl": "https://mainnet.base.org",         "markets": [

"rpcUrl": "https://mainnet.base.org",

1. Build Aerodrome config and Freqtrade strategy code. 2. Check data availability with `GET https://api.superior.trade/runtime/backtests/dataset` and the query fields published by OpenAPI.

2. Check data availability with `GET https://api.superior.trade/runtime/backtests/dataset` and the query fields published by OpenAPI.

3. Create a backtest with `POST https://api.superior.trade/runtime/backtests` using `framework: "freqtrade"`, `venue: "aerodrome"`, strategy source/config, instruments, and timerange fields from the current contract. 4. Creation queues the 

4. Creation queues the run; poll `GET https://api.superior.trade/runtime/backtests/{id}` until `completed` or `failed`. 5. Fetch the backtest record and `GET /runtime/backtests/{id}/logs` for full metrics and diagnostics. 6. Present total t

1. Create a deployment with `POST https://api.superior.trade/runtime/deployments` using top-level `framework`, `venue`, `mode`, `name`, `code`, and `config` fields.

3. Run the pre-deployment checklist below. 4. Show a concise live trading summary and wait for explicit confirmation. 5. Start with `PUT https://api.superior.trade/runtime/deployments/{id}/status` and `{ "action": "start" }`.

4. Show a concise live trading summary and wait for explicit confirmation. 5. Start with `PUT https://api.superior.trade/runtime/deployments/{id}/status` and `{ "action": "start" }`. 6. Monitor status and logs with `GET https://api.superior

5. Start with `PUT https://api.superior.trade/runtime/deployments/{id}/status` and `{ "action": "start" }`.

6. Monitor status and logs with `GET https://api.superior.trade/runtime/deployments/{id}` and `GET https://api.superior.trade/runtime/deployments/{id}/logs`.

7. Stop with `PUT https://api.superior.trade/runtime/deployments/{id}/status` and `{ "action": "stop" }`.

- Internal plan: [docs/alpha-scan-improvement-plan.md](https://github.com/Superior-Trade/superior-turborepo/blob/main/docs/alpha-scan-improvement-plan.md) — basis-flipping bucket

- Freqtrade `informative_pairs` — https://www.freqtrade.io/en/stable/strategy-customization/#additional-data-informative_pairs

- Internal audit — `docs/standard-strategies-audit.md`, backtest `01kqypw5bqsaezpgm8pxcrpvyb` - Freqtrade trailing stop — https://www.freqtrade.io/en/stable/stoploss/#trailing-stop-loss

- Freqtrade trailing stop — https://www.freqtrade.io/en/stable/stoploss/#trailing-stop-loss

- Freqtrade `adjust_trade_position` — https://www.freqtrade.io/en/stable/strategy-callbacks/#adjust-trade-position

- DigDeeperStrategy reference — https://github.com/freqtrade/freqtrade/issues/7052

![Deposit QR](https://quickchart.io/qr?size=360&text=...)

#!/usr/bin/env node

function qrUrl(text) {   return `https://quickchart.io/qr?size=360&text=${encodeURIComponent(text)}`;

return `https://quickchart.io/qr?size=360&text=${encodeURIComponent(text)}`;

https://relay.link/bridge/<destination-chain>?toCurrency=<destination-token>&fromChainId=<source-chain-id>&fromCurrency=<source-token>&toAddress=<recipient>&amount=<target-amount>&tradeType=EXPECTED_OUTPUT

https://link.metamask.io/dapp/<url-encoded-relay-url>

| Wallet target | Link format | |---|---| | `metamask` | `https://link.metamask.io/dapp/<encoded-url>` |

|---|---| | `metamask` | `https://link.metamask.io/dapp/<encoded-url>` | | `trust` | `https://link.trustwallet.com/open_url?coin_id=60&url=<encoded-url>` |

| `metamask` | `https://link.metamask.io/dapp/<encoded-url>` |

| `trust` | `https://link.trustwallet.com/open_url?coin_id=60&url=<encoded-url>` |

https://relay.link/bridge/robinhood?toCurrency=0x5fc5360d0400a0fd4f2af552add042d716f1d168&fromChainId=42161&fromCurrency=0xaf88d065e77c8cc2239327c5edb3a432268e5831&toAddress=0xF60CA00ef5e510137bC09691b52BA7863F52158F&amount=20&tradeType=EXP

![Relay Deposit QR](https://quickchart.io/qr?size=360&text=...)

#!/usr/bin/env node

const RELAY_API = process.env.RELAY_API ?? "https://api.relay.link";

function qrUrl(text) {   return `https://quickchart.io/qr?size=360&text=${encodeURIComponent(text)}`;

return `https://quickchart.io/qr?size=360&text=${encodeURIComponent(text)}`;

switch (wallet) {     case "metamask":       return `https://link.metamask.io/dapp/${encoded}`;

case "metamask":       return `https://link.metamask.io/dapp/${encoded}`;     case "trust":

return `https://link.metamask.io/dapp/${encoded}`;

case "trust":       return `https://link.trustwallet.com/open_url?coin_id=60&url=${encoded}`;     case "okx":

return `https://link.trustwallet.com/open_url?coin_id=60&url=${encoded}`;

function relayBridgeUrl(args, fromChain, toChain, fromToken, toToken) {   const url = new URL(`https://relay.link/bridge/${toChain.relayPath}`);

const url = new URL(`https://relay.link/bridge/${toChain.relayPath}`);

const response = await fetch(`${RELAY_API}/quote`, {

Executable file

assert.equal(walletLinks.metamask.url.startsWith("https://link.metamask.io/dapp/"), true);

assert.equal(walletLinks.trust.url.startsWith("https://link.trustwallet.com/open_url?"), true);

assert.equal(output.wallet_links[1].url, output.relay_url);   assert.equal(     decodeURIComponent(output.wallet_links[0].url.replace("https://link.metamask.io/dapp/", "")),

assert.equal(     decodeURIComponent(output.wallet_links[0].url.replace("https://link.metamask.io/dapp/", "")),     output.relay_url,

decodeURIComponent(output.wallet_links[0].url.replace("https://link.metamask.io/dapp/", "")),

"20",       "--quote",     ], { RELAY_API: `http://127.0.0.1:${port}` });

"--quote",     ], { RELAY_API: `http://127.0.0.1:${port}` });   } finally {

], { RELAY_API: `http://127.0.0.1:${port}` });

Hyperliquid's perp fees as of writing (verify against `https://hyperliquid.gitbook.io/hyperliquid-docs/trading/fees` for current numbers):

1. **Hyperliquid fee tier**: `https://app.hyperliquid.xyz/portfolio` shows current 14-day volume tier.

- Hyperliquid fees — https://hyperliquid.gitbook.io/hyperliquid-docs/trading/fees

- Freqtrade configuration reference — https://www.freqtrade.io/en/stable/configuration/#understand-order_types

- Freqtrade pricing — https://www.freqtrade.io/en/stable/configuration/#understand-entry_pricing-and-exit_pricing

- Freqtrade DataProvider — https://www.freqtrade.io/en/stable/strategy-customization/

- Hyperliquid funding mechanics — https://hyperliquid.gitbook.io/hyperliquid-docs/trading/funding

- Sibling strategy: the `funding-rate-arbitrage` skill - Internal: [docs/alpha-scan-improvement-plan.md](https://github.com/Superior-Trade/superior-turborepo/blob/main/docs/alpha-scan-improvement-plan.md) — squeeze-fuel bucket

- Internal: [docs/alpha-scan-improvement-plan.md](https://github.com/Superior-Trade/superior-turborepo/blob/main/docs/alpha-scan-improvement-plan.md) — squeeze-fuel bucket

- Freqtrade DataProvider — https://www.freqtrade.io/en/stable/strategy-customization/

- Freqtrade `adjust_trade_position` — https://www.freqtrade.io/en/stable/strategy-callbacks/#adjust-trade-position

version: 5.0.0   updated: 2026-08-12   homepage: https://account.superior.trade

updated: 2026-08-12   homepage: https://account.superior.trade   source: https://github.com/Superior-Trade

homepage: https://account.superior.trade

source: https://github.com/Superior-Trade

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

env:     - name: SUPERIOR_TRADE_API_KEY       description: "Superior Trade API key (x-api-key header). Obtained at https://account.superior.trade. Used for Unified wallet/context reads, backtests, deployments, supported typed executions, an

[Credential-related source omitted]

[Credential-related source omitted]

description: "Superior Trade API key (x-api-key header). Obtained at https://account.superior.trade. Used for Unified wallet/context reads, backtests, deployments, supported typed executions, and contract-supported withdrawals. It cannot ex

[Credential-related source omitted]

[Credential-related source omitted]

externalEndpoints:     - url: https://api.superior.trade       purpose: "All backtesting and deployment operations"

- url: https://api.superior.trade

purpose: "All backtesting and deployment operations"     - url: https://api.hyperliquid.xyz/info       purpose: "Read-only public queries. Balance checks send the user's public wallet address (not a secret — visible on-chain). Pair validati

- url: https://api.hyperliquid.xyz/info

**Base URL:** `https://api.superior.trade`

- **The agent wallet holding $0 is normal.** It signs against the main wallet's balance and never needs funds. Always check the **main** trading wallet's balance; checking the agent wallet's will always look like an empty account. - **A bal

- **A balance that covers `stake_amount × max_open_trades` exactly will still fail.** The exchange reserves roughly 1% for fees, so cap `stake_amount` at ~95% of `balance / max_open_trades` or entries get rejected silently. - **The account 

- **The account URL is `https://account.superior.trade`.** Never send users to `app.superior.trade`, including when an API error message itself contains that older URL.

[Credential-related source omitted]

6. **NEVER** start a live deployment without explicit user confirmation 7. **Prefer user-friendly language** over internal technical names when speaking conversationally. Say "strategy", "the bot", or "the trading engine" instead of referen

8. **NEVER** send users to `app.superior.trade` — the correct URL is `https://account.superior.trade`

> **IMPORTANT:** The correct URL is **https://account.superior.trade** — NOT `app.superior.trade`. Never send users to `app.superior.trade`.

[Credential-related source omitted]

1. Go to https://account.superior.trade

[Credential-related source omitted]

[Credential-related source omitted]

- **Perps:** `POST https://api.hyperliquid.xyz/info` → `{"type":"clearinghouseState","user":"0x..."}`

- **Spot:** `POST https://api.hyperliquid.xyz/info` → `{"type":"spotClearinghouseState","user":"0x..."}`

6. **Pair is tradeable** — `POST https://api.hyperliquid.xyz/info` → `{"type":"meta"}` for standard perps, or `{"type":"meta", "dex":"xyz"}` (or the relevant dex name) for HIP3 pairs. Verify the coin name exists in the `universe` array.

- Perps: `POST https://api.hyperliquid.xyz/info` with

`{"type":"clearinghouseState","user":"0x..."}` - Spot: `POST https://api.hyperliquid.xyz/info` with   `{"type":"spotClearinghouseState","user":"0x..."}`

- Spot: `POST https://api.hyperliquid.xyz/info` with

version: 1.0.0   updated: 2026-07-16   homepage: https://robinhoodchain.lighter.xyz

updated: 2026-07-16   homepage: https://robinhoodchain.lighter.xyz   source: https://github.com/Superior-Trade

homepage: https://robinhoodchain.lighter.xyz

source: https://github.com/Superior-Trade

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

env:     - name: SUPERIOR_TRADE_API_KEY       description: "Superior Trade API key (x-api-key header). Obtained at https://account.superior.trade."

[Credential-related source omitted]

[Credential-related source omitted]

description: "Superior Trade API key (x-api-key header). Obtained at https://account.superior.trade."

[Credential-related source omitted]

[Credential-related source omitted]

externalEndpoints:     - url: https://api.superior.trade       purpose: "Unified venue discovery, backtests, and deployment planning"

- url: https://api.superior.trade

**Exchange name:** `lighter-robinhood` **Venue config:** `{ "venue": "lighter-robinhood", "instrument_id": "<SYMBOL>-PERP.LIGHTER-RH" }` **Superior API base:** `https://api.superior.trade`

**Venue config:** `{ "venue": "lighter-robinhood", "instrument_id": "<SYMBOL>-PERP.LIGHTER-RH" }` **Superior API base:** `https://api.superior.trade` **Robinhood Chain id:** `4663`

**Superior API base:** `https://api.superior.trade`

version: 1.0.2   updated: 2026-07-22   homepage: https://account.superior.trade

updated: 2026-07-22   homepage: https://account.superior.trade   source: https://github.com/Superior-Trade

homepage: https://account.superior.trade

source: https://github.com/Superior-Trade

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

env:     - name: SUPERIOR_TRADE_API_KEY       description: "Superior Trade API key (x-api-key header). Obtained at https://account.superior.trade. Used for Unified wallet reads, market context, backtests, and contract-supported Lighter depl

[Credential-related source omitted]

[Credential-related source omitted]

description: "Superior Trade API key (x-api-key header). Obtained at https://account.superior.trade. Used for Unified wallet reads, market context, backtests, and contract-supported Lighter deployments."

[Credential-related source omitted]

[Credential-related source omitted]

externalEndpoints:     - url: https://api.superior.trade       purpose: "Unified Lighter market context, wallet reads, backtests, and deployments"

- url: https://api.superior.trade

**Base URL:** `https://api.superior.trade`

[Credential-related source omitted]

[Credential-related source omitted]

version: 2.0.0   updated: 2026-08-12   homepage: https://superior.trade

updated: 2026-08-12   homepage: https://superior.trade   source: https://github.com/Superior-Trade

homepage: https://superior.trade

source: https://github.com/Superior-Trade

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

externalEndpoints:     - url: https://api.superior.trade       purpose: "Unified account, wallet, market context, typed executions, filled-data backtests, deployments, and logs"

- url: https://api.superior.trade

**Base URL:** `https://api.superior.trade`. If the environment configures a different base URL, use that instead.

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

version: 1.0.0   updated: 2026-08-12   homepage: https://account.superior.trade

updated: 2026-08-12   homepage: https://account.superior.trade   source: https://github.com/Superior-Trade

homepage: https://account.superior.trade

source: https://github.com/Superior-Trade

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

**Base URL:** `https://api.superior.trade`

**Account UI:** `https://account.superior.trade`

[Credential-related source omitted]

[Credential-related source omitted]

curl -sS https://api.superior.trade/account/register \

[Credential-related source omitted]

[Credential-related source omitted]

https://account.superior.trade.

[Credential-related source omitted]

[Credential-related source omitted]

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*

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

5. **Never** send users to `app.superior.trade` — the correct URL is `https://account.superior.trade`, even when an API error message says otherwise.

[Credential-related source omitted]

[Credential-related source omitted]