pionex-trade

Pionex Trading Skill

pionex-trade-cli CLIを使用して、Pionexで現物注文を発注・管理します。~/.pionex/config.toml にAPI認証情報が必要です（最初に pionex-ai-kit onboard を実行してください）。
セキュリティ：Pionex API Docs（https://pionex-doc.gitbook.io/apidocs/）では、IPホワイトリストの設定と、API Key/Secretを決して共有しないことを推奨しています。

前提条件

1. CLIをインストールし、認証情報を設定します：

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

2. テストします（読み取り専用）：

   pionex-trade-cli account balance
   

スキルの振り分け

• 市場データ（価格、板、ローソク足、シンボル情報）→ pionex-market
• 口座残高 → pionex-portfolio（または注文前に確認する場合は、ここで pionex-trade-cli account balance を使用）
• 注文の発注・キャンセル、オープン注文、約定 → pionex-trade（このスキル）
• 先物グリッドボットのライフサイクル（作成・調整・縮小・キャンセル）→ pionex-bot

コマンド一覧（このスキルで使用する注文と口座関連）

コマンド	種類	説明
pionex-trade-cli account balance	READ	現物残高すべて（必要に応じてJSONから通貨で絞り込みます）
pionex-trade-cli orders new --symbol <s> --side BUY|SELL --type MARKET|LIMIT [--amount | --size] [--price] [--dry-run]	WRITE	注文を作成します。MARKETの買い：--amount（クオート通貨）を使用します。MARKETの売り／LIMIT：--size（ベース通貨）を使用します。LIMIT：--price を追加します
pionex-trade-cli orders get --symbol <s> --order-id <id>	READ	IDで注文を1件取得します
pionex-trade-cli orders open --symbol <s>	READ	シンボルのオープン注文を一覧表示します
pionex-trade-cli orders all --symbol <s> [--limit <n>]	READ	注文履歴（約定済み／キャンセル済み）
pionex-trade-cli orders fills --symbol <s> [--startTime] [--endTime]	READ	約定（執行された取引）
pionex-trade-cli orders fills_by_order_id --symbol <s> --order-id <id>	READ	特定の注文1件の約定
pionex-trade-cli orders cancel --symbol <s> --order-id <id> [--dry-run]	WRITE	注文を1件キャンセルします
pionex-trade-cli orders cancel_all --symbol <s> [--dry-run]	WRITE	シンボルのオープン注文をすべてキャンセルします

注文を発注する前にシンボル情報（最小サイズ、精度）を確認するには、pionex-market → pionex-trade-cli market symbols --symbols BTC_USDT を使用します。

---

1. このスキルを使用する場面

ユーザーが次の操作を希望する場合は、pionex-trade を使用します。

• 現物注文（成行または指値での買い／売り）を発注する。
• 注文またはシンボルのすべての注文をキャンセルする。
• オープン注文、注文履歴、約定を照会する。

次の場合には使用しないでください：価格または板の確認のみ（pionex-marketを使用）、残高の確認のみ（pionex-portfolioを使用するか、取引フローの一部として pionex-trade-cli account balance を使用）。

---

2. 一般ルール

1. パラメーターを明示する — シンボル、売買方向、サイズを推測しないでください。不明な場合は、ユーザーにシンボル（例：BTC_USDT）、売買方向（BUY/SELL）、注文タイプ（MARKET/LIMIT）、金額またはサイズを確認してください。
2. ドライランを実行してから確認する — 書き込み操作（新規注文、キャンセル、cancel_all）では、対応している場合、まず --dry-run を付けて実行し、実行される内容をユーザーに提示してから、--dry-run なしで実行する前に確認を求めてください。
3. ユーザーに伝えずにリスクを増やさない — サイズを大きくしたり、注文を追加したりする場合は、必ずユーザーの明示的な同意を得てください。
4. エラーが発生した場合 — エラーを説明し、次の手順（例：最小サイズに合わせてサイズを調整する、残高を確認する）を提案してください。

---

3. 残高を考慮した注文フロー

ユーザーが建値通貨の金額を指定して購入を依頼した場合（例：「1000 USDT で BTC を購入」）：

1. 残高を確認する

   pionex-trade-cli account balance
   

   JSON の結果から、建値通貨（例：USDT）の利用可能残高を確認します。--asset フラグはありません。このコマンドはすべての通貨を返します。

2. 指定金額と比較する

   • 利用可能残高 < 指定金額の場合：注文を実行しないでください。利用可能残高と指定金額をユーザーに伝え、金額を減らすか注文を見送るよう提案します。
   • 利用可能残高 ≥ 指定金額の場合：注文フローに進みます（それでも、まずドライランを行い、ユーザーの確認を得ることを優先します）。

3. 例

   • ユーザー：「1000 USDT で BTC を購入。」
   • エージェント：pionex-trade-cli account balance を実行し、USDT の利用可能残高が 600 の場合、「利用可能な USDT 残高は 600 で、1000 を下回っています。代わりに 600 USDT の成行買い注文を出しますか？まず --dry-run を使用します。」と返信します。
   • ユーザーの確認後にのみ、たとえば pionex-trade-cli orders new --symbol BTC_USDT --side BUY --type MARKET --amount 600 を実行します（必要に応じて、まず --dry-run を付けて実行し、確認後に付けずに実行します）。

---

4. 最小サイズ／「amount too small」エラー

API が最小注文サイズまたは最小注文金額に関するエラー（例：最小注文金額 10 USDT）を返した場合：

1. シンボルのルールを取得する

   pionex-trade-cli market symbols --symbols BTC_USDT
   

   結果を使って、最小サイズ、最小注文金額、刻み幅を確認します。

2. 有効なサイズを提案する — 必要な精度に丸め、注文金額が最小注文金額以上になるようにします。元の依頼内容、取引所の最小値、提案するサイズをユーザーに説明します。

3. 確認後に再試行する — ユーザーの同意後、注文を再度実行します（まず --dry-run を使うことを推奨します）。

---

5. 注文コマンド（正確な CLI）

• 成行買い（建値通貨の金額）
  pionex-trade-cli orders new --symbol BTC_USDT --side BUY --type MARKET --amount 100

• 成行売り（基軸通貨の数量）
  pionex-trade-cli orders new --symbol BTC_USDT --side SELL --type MARKET --size 0.01

• 指値注文
  pionex-trade-cli orders new --symbol BTC_USDT --side BUY --type LIMIT --price 50000 --size 0.01

• 注文を 1 件キャンセル
  pionex-trade-cli orders cancel --symbol BTC_USDT --order-id 123456

• シンボルのすべての注文をキャンセル
  pionex-trade-cli orders cancel_all --symbol BTC_USDT
  実行前に、キャンセル対象を一覧表示します：pionex-trade-cli orders open --symbol BTC_USDT。その後、ユーザーに確認します。

---

6. cancel_all と一括操作

• 必ず事前に確認する — pionex-trade-cli orders cancel_all --symbol <s> の前に、pionex-trade-cli orders open --symbol <s> を実行し、注文数と対象のシンボルをユーザーに提示します。
• 明示的な確認を得る — 例：「BTC_USDT の未約定注文 3 件をキャンセルします。よろしいですか？」確認後にのみ、該当する場合は --dry-run を付けずに実行します。

---

7. まとめ

• pionex-trade は、pionex-trade-cli CLI を使って現物注文を安全に発注・キャンセルする方法を定めています。
• pionex-trade-cli account balance で資金を確認し、最小サイズ／最小注文金額を守るために pionex-trade-cli market symbols（pionex-market）を使用します。
• 書き込み操作では --dry-run とユーザーの確認を優先します。ユーザーの明示的な同意なしにリスクを高めないでください。