SkillsAdd

pionex-official/pionex-skills

pionex-trade

Use when the user asks to place orders, cancel orders, check open orders or fills on Pionex. Covers spot orders via `pionex-trade-cli` CLI. Requires API credentials. Do NOT use for market data only (pionex-market) or balance/portfolio (pionex-portfolio).

First seen Mar 18, 2026

Installation

$ npx skills add pionex-official/pionex-skills --skill pionex-trade
View on skills.sh ↗ GitHub repository ↗

Also in this package

Other skills from pionex-official/pionex-skills · top by installs.

npx skills add pionex-official/pionex-skills
financial-analysis-stock-screening 118 pionex-portfolio 108 pionex-bot 108 pionex-market 106 financial-analysis-earnings 100 financial-analysis-comps 94 pionex-earn-dual 93 financial-analysis-dcf 91 financial-analysis-earnings-preview 85 pionex-wallet 61

Browse all from pionex-official/pionex-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 5
License LICENSE
Default branch main
Open issues 0
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version1.0.0
LicenseMIT
More metadata
author
pionex
version
1.0.0
homepage
https://www.pionex.com
agent
{"requires":{"bins":["pionex-trade-cli"]},"install":{"0":"id: npm","kind":"node","package":"@pionex\/pionex-ai-kit","bins":["pionex-trade-cli","pionex-ai-kit"],"label":"Install pionex CLI (npm)"}}

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 7,118 B
  • docs SUMMARY.md 274 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 101 installs

SKILL.md

Pionex Trading Skill

Spot order placement and management on Pionex via the pionex-trade-cli CLI. Requires API credentials in ~/.pionex/config.toml (run pionex-ai-kit onboard first). Security: Pionex API Docs recommend IP whitelisting and never sharing your API Key/Secret.

Prerequisites

  1. Install CLI and configure credentials:

``bash npm install -g @pionex/pionex-ai-kit pionex-ai-kit onboard ``

  1. Test (read-only):

``bash pionex-trade-cli account balance ``

Skill Routing

  • Market data (price, depth, klines, symbol info) → pionex-market
  • Account balance → pionex-portfolio (or use pionex-trade-cli account balance here when checking before order)
  • Place/cancel orders, open orders, fills → pionex-trade (this skill)
  • Futures grid bot lifecycle (create/adjust/reduce/cancel) → pionex-bot

Command Index (orders & account used by this skill)

Command Type Description
pionex-trade-cli account balance READ All spot balances (filter by currency from JSON if needed)
`pionex-trade-cli orders new --symbol <s> --side BUY\ SELL --type MARKET\ LIMIT [--amount \ --size] [--price] [--dry-run]` WRITE Create order. MARKET buy: use --amount (quote). MARKET sell / LIMIT: use --size (base). LIMIT: add --price
pionex-trade-cli orders get --symbol <s> --order-id <id> READ Get one order by ID
pionex-trade-cli orders open --symbol <s> READ List open orders for symbol
pionex-trade-cli orders all --symbol <s> [--limit <n>] READ Order history (filled/cancelled)
pionex-trade-cli orders fills --symbol <s> [--startTime] [--endTime] READ Fills (executed trades)
pionex-trade-cli orders fillsbyorder_id --symbol <s> --order-id <id> READ Fills for one specific order
pionex-trade-cli orders cancel --symbol <s> --order-id <id> [--dry-run] WRITE Cancel one order
pionex-trade-cli orders cancel_all --symbol <s> [--dry-run] WRITE Cancel all open orders for symbol

Symbol info (min size, precision) before placing orders: use pionex-market → pionex-trade-cli market symbols --symbols BTC_USDT.

1. When to use this skill

Use pionex-trade when the user wants to:

  • Place a spot order (market or limit buy/sell).
  • Cancel an order or all orders for a symbol.
  • Query open orders, order history, or fills.

Do not use for: only checking prices or order book (use pionex-market); only checking balance (pionex-portfolio, or pionex-trade-cli account balance as part of a trade flow).

2. General rules

  1. Explicit parameters — Do not guess symbol, side, or size. If unclear, ask the user for: symbol (e.g. BTC_USDT), side (BUY/SELL), type (MARKET/LIMIT), and amount or size.
  2. Prefer dry-run then confirm — For any write (new order, cancel, cancel_all), run with --dry-run first when supported, show the user what would be done, then ask for confirmation before running without --dry-run.
  3. Do not increase risk without telling the user — No larger size, no extra orders, without explicit user agreement.
  4. On errors — Explain and suggest next steps (e.g. adjust size to min, or check balance).

3. Balance-aware order flow

When the user asks to buy with a quote amount (e.g. “buy BTC with 1000 USDT”):

  1. Check balance

``bash pionex-trade-cli account balance ` From the JSON result, read the available balance for the quote asset (e.g. USDT). There is no --asset` flag; the command returns all currencies.

  1. Compare to requested amount

- If available &lt; requested: do not place the order. Tell the user the available balance and requested amount; suggest reducing amount or skipping. - If available ≥ requested: proceed with order flow (still prefer dry-run + user confirm).

  1. Example

- User: “Buy BTC with 1000 USDT.” - Agent: run pionex-trade-cli account balance → if USDT available is 600, reply: “Your available USDT is 600, less than 1000. Should I place a market buy for 600 USDT instead? I’ll use --dry-run first.” - Only after user confirms, run e.g. pionex-trade-cli orders new --symbol BTC_USDT --side BUY --type MARKET --amount 600 (and optionally run with --dry-run first, then without after confirm).

4. Min size / “amount too small” errors

If the API returns an error about minimum order size or notional (e.g. minimum notional 10 USDT):

  1. Get symbol rules

``bash pionex-trade-cli market symbols --symbols BTC_USDT `` Use the result to see min size, min notional, step size.

  1. Suggest a valid size — Round to the required precision and ensure notional ≥ min notional. Explain to the user: original request, exchange minimum, and suggested size.
  1. Confirm then retry — After user agrees, place the order again (prefer --dry-run first).

5. Order commands (exact CLI)

  • Market buy (quote amount)

pionex-trade-cli orders new --symbol BTC_USDT --side BUY --type MARKET --amount 100

  • Market sell (base quantity)

pionex-trade-cli orders new --symbol BTC_USDT --side SELL --type MARKET --size 0.01

  • Limit order

pionex-trade-cli orders new --symbol BTC_USDT --side BUY --type LIMIT --price 50000 --size 0.01

  • Cancel one

pionex-trade-cli orders cancel --symbol BTC_USDT --order-id 123456

  • Cancel all for symbol

pionex-trade-cli orders cancelall --symbol BTCUSDT Before running, list what will be cancelled: pionex-trade-cli orders open --symbol BTC_USDT, then confirm with the user.

6. Cancel_all and batch actions

  • Always preview — Before pionex-trade-cli orders cancel_all --symbol <s>, run pionex-trade-cli orders open --symbol <s> and show the user how many orders and for which symbol.
  • Explicit confirmation — e.g. “This will cancel 3 open orders on BTC_USDT. Confirm?” Only then run without --dry-run if applicable.

7. Summary

  • pionex-trade defines how to safely place and cancel spot orders using the pionex-trade-cli CLI.
  • Use pionex-trade-cli account balance to check funds; use pionex-trade-cli market symbols (pionex-market) to respect min size/notional.
  • Prefer --dry-run and user confirmation for writes. Never increase risk without the user’s explicit agreement.