Skill playbook Browse All Skills
Skill skill

ApeX Trading Skill

Full trading and portfolio management for ApeX perpetual futures exchange. Prerequisites Install dependencies once: cd skills/apex/scripts && npm install Authentication Private op…

Updated Apr 1, 2026 By One Person Company Editorial Team Skill system

Overview

Full trading and portfolio management for ApeX perpetual futures exchange. Prerequisites

Install dependencies once:

  • 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:
  • node scripts/apex.mjs price BTC
  • List available symbols:
  • node scripts/apex.mjs meta
  • Portfolio Monitoring (Private)
  • Check balance:
  • APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \
  • node scripts/apex.mjs balance
  • View positions with P&L:
  • APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \
  • node scripts/apex.mjs positions
  • Check open orders:
  • APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \
  • node scripts/apex.mjs orders
  • View trade history:
  • 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:
  • 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:
  • 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:
  • 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:
  • 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:
  • Confirm trade parameters with user (symbol, size, side, price)
  • Show current price and position for context
  • 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?"
  • Run balance to get total equity
  • Run positions to get open positions
  • Format summary: equity, positions with P&L, total unrealized P&L
  • "Buy 0.5 BTC on ApeX"
  • Run price BTC to get current price
  • Confirm with user: "Buy 0.5 BTC at market? Current price: $X. Estimated cost: $Y"
  • Execute market-buy BTC 0.5
  • Report result
  • "What's the current BTC price on ApeX?"
  • Run price BTC
  • Format response: "BTC: $X on ApeX"
  • "Close my ETH position"
  • Run positions to get current ETH position size
  • If long → market-sell, if short → market-buy
  • Execute with position size
  • Report result
  • "Enroll me in OpenClaw Trading Contest"
  • Run submit-reward (defaults to 300001)
  • Report result
  • Advanced Features
  • List all available symbols:
  • 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.

SKILL.md file

Embedded doc viewer SKILL.md
Markdown source

Preview raw SKILL.md. Open the full source below. Scroll, inspect, then download the exact SKILL.md file if you want the original.

# apex

ApeX Trading Skill
Full trading and portfolio management for ApeX perpetual futures exchange.
Prerequisites
Install dependencies once:
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:
node scripts/apex.mjs price BTC
List available symbols:
node scripts/apex.mjs meta
Portfolio Monitoring (Private)
Check balance:
APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \
node scripts/apex.mjs balance
View positions with P&L:
APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \
node scripts/apex.mjs positions
Check open orders:
APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \
node scripts/apex.mjs orders
View trade history:
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:
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:
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:
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:
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:
Confirm trade parameters with user (symbol, size, side, price)
Show current price and position for context
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?"
Run balance to get total equity
Run positions to get open positions
Format summary: equity, positions with P&L, total unrealized P&L
"Buy 0.5 BTC on ApeX"
Run price BTC to get current price
Confirm with user: "Buy 0.5 BTC at market? Current price: $X. Estimated cost: $Y"
Execute market-buy BTC 0.5
Report result
"What's the current BTC price on ApeX?"
Run price BTC
Format response: "BTC: $X on ApeX"
"Close my ETH position"
Run positions to get current ETH position size
If long → market-sell, if short → market-buy
Execute with position size
Report result
"Enroll me in OpenClaw Trading Contest"
Run submit-reward (defaults to 300001)
Report result
Advanced Features
List all available symbols:
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.

Comments & Discussion

Add a comment