📖 Complete setup guide: https://skillboss.co/skill.md

ApeX Trading Skill#

Full trading and portfolio management for ApeX perpetual futures exchange.

Prerequisites#

Install dependencies once:

bash

cd skills/apex/scripts && npm install

Authentication#

Private operations require API credentials and an Omni seed:

• APEX_API_KEY
• APEX_API_SECRET
• APEX_API_PASSPHRASE
• APEX_OMNI_SEED

Important: APEX_OMNI_SEED is required by the SDK for order-related operations. Treat it like a private key/seed phrase and keep it strictly local. Do not share it or commit it.

Testnet:

• Set APEX_TESTNET=1 (or APEX_ENV=qa).

Core Operations#

Market Data (Public)#

Get price for a coin:

bash

node scripts/apex.mjs price BTC

List available symbols:

bash

node scripts/apex.mjs meta

Portfolio Monitoring (Private)#

Check balance:

bash

APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \
  node scripts/apex.mjs balance

View positions with P&L:

bash

APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \
  node scripts/apex.mjs positions

Check open orders:

bash

APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \
  node scripts/apex.mjs orders

View trade history:

bash

APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \
  node scripts/apex.mjs fills

Trading Operations#

All trading commands require the ApeX API credentials and seed.

Place limit orders:

bash

APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \
  node scripts/apex.mjs limit-buy BTC 0.1 45000

APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \
  node scripts/apex.mjs limit-sell ETH 1 3000

Market orders:

bash

APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \
  node scripts/apex.mjs market-buy BTC 0.5

APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \
  node scripts/apex.mjs market-sell ETH 2

Cancel orders:

bash

APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \
  node scripts/apex.mjs cancel-all

APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \
  node scripts/apex.mjs cancel-all BTC

Submit trade reward enrollment:

bash

APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \
  node scripts/apex.mjs submit-reward 12345

Output Formatting#

All commands output JSON. Parse and format for chat display:

For balance/portfolio:

• Show total equity and available balance
• List positions with size, entry price, unrealized P&L
• Summarize open orders

For trade execution:

• Confirm order details before executing
• Report order ID and status after execution
• Show filled price if immediately executed

Safety Guidelines#

Before executing trades:

1. Confirm trade parameters with user (symbol, size, side, price)
2. Show current price and position for context
3. Calculate estimated cost/proceeds

Position sizing:

• Warn if trade is >20% of account equity
• Suggest appropriate sizes based on account balance

Price checks:

• For limit orders, compare limit price to current market price
• Warn if limit price is >5% away from market (likely mistake)

Error Handling#

Common errors:

• "Missing APEX credentials" → Set API key, secret, passphrase, and seed
• "Unknown symbol" → Check available symbols with meta
• HTTP errors → Check network connection and API status

When errors occur:

• Show the error message to user
• Suggest fixes (set env vars, check symbol names, verify balance)
• Don't retry trades automatically

Trigger Phrases#

Use submit-reward when the user expresses enrollment intent for OpenClaw activities or contests. If no reward ID is provided, default to 300001.

English examples:

• "Enroll me in the OpenClaw trading contest"
• "Register for OpenClaw activity"
• "Sign up for the OpenClaw contest"
• "Join the OpenClaw trading contest"

Chinese examples:

• "报名活动"
• "参加活动"
• "报名OpenClaw活动"
• "参加OpenClaw交易赛"

If the user provides a reward ID, use it. Otherwise use the default.

Workflow Examples#

"How's my ApeX portfolio?"

1. Run balance to get total equity
2. Run positions to get open positions
3. Format summary: equity, positions with P&L, total unrealized P&L

"Buy 0.5 BTC on ApeX"

1. Run price BTC to get current price
2. Confirm with user: "Buy 0.5 BTC at market? Current price: $X. Estimated cost: $Y"
3. Execute market-buy BTC 0.5
4. Report result

"What's the current BTC price on ApeX?"

1. Run price BTC
2. Format response: "BTC: $X on ApeX"

"Close my ETH position"

1. Run positions to get current ETH position size
2. If long → market-sell, if short → market-buy
3. Execute with position size
4. Report result

"Enroll me in OpenClaw Trading Contest"

1. Run submit-reward (defaults to 300001)
2. Report result

Advanced Features#

List all available symbols:

bash

node scripts/apex.mjs meta

Notes#

• Symbols use -USDT format for trading (e.g., BTC-USDT).
• Public market data endpoints often use BTCUSDT format.
• Prices are in USD.
• ApeX uses perpetual futures, not spot trading.
• Check references/api.md for API details.