pionex-earn-dual

Pionex Earn Dual Investment スキル

Pionex のデュアル投資商品：商品を閲覧し、利回りを確認して、投資、取り消し、決済済みの収益の受け取りを pionex-trade-cli で行います。公開クエリに認証情報は不要です。書き込み操作には Earn 権限を持つ API 認証情報が必要です。

ベータ版のお知らせ： デュアル投資 API は現在ベータ版です。アクセスをリクエストするには、[email protected] までお問い合わせください。

商品 ID の形式： {BASE}-{QUOTE}-{YYMMDD}-{STRIKE}-{C|P}-{CURRENCY}。ここで、C = DUAL_BASE、P = DUAL_CURRENCY です。

スキルのルーティング

• デュアル投資の商品、価格、投資、取り消し、受け取り → pionex-earn-dual（このスキル）
• アービトラージ（InstFund）の商品、ステーキング、ステーキング解除 → pionex-earn-arbitrage
• 現物市場データ（板情報、ティッカー、ローソク足） → pionex-market
• 現物アカウントの残高 → pionex-portfolio
• 現物注文の発注／キャンセル → pionex-trade
• Futures Grid Bot のライフサイクル → pionex-bot

前提条件

1. CLI をインストールします：

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

2. プライベートコマンド（残高、投資、revoke_invest、collect）を使用するには、認証情報を設定します：

   pionex-ai-kit onboard
   

   API キーに必要な権限があることを確認してください：
   • View — balances、get_invests、records 用
   • Earn — invest、revoke_invest、collect 用
3. 確認します（公開コマンドのため、認証は不要です）：

   pionex-trade-cli earn dual symbols
   

---

コマンド一覧

公開コマンド（認証不要）

#	コマンド	フラグ	種別
1	pionex-trade-cli earn dual symbols	[--base <currency>]	READ
2	pionex-trade-cli earn dual open_products	--base <c> --quote <c> --type DUAL_BASE|DUAL_CURRENCY [--currency <c>]	READ
3	pionex-trade-cli earn dual prices	--base <c> --quote <c> --product-ids <id1,id2,...>	READ
4	pionex-trade-cli earn dual index	--base <c> --quote <c>	READ
5	pionex-trade-cli earn dual delivery_prices	--base <c> [--quote <c>] [--start-time <ms>] [--end-time <ms>]	READ

プライベートコマンド — View 権限

#	コマンド	フラグ	種別
6	pionex-trade-cli earn dual balances	[--merge]	READ
7	pionex-trade-cli earn dual get_invests	[--base <c>] --client-dual-ids <id1,id2,...>	READ
8	pionex-trade-cli earn dual records	--base <c> --end-time <ms> [--quote <c>] [--currency <c>] [--start-time <ms>] [--limit <n>]	READ

プライベートコマンド — Earn 権限

#	コマンド	フラグ	種別
9	pionex-trade-cli earn dual invest	--base <c> --product-id <id> --profit <rate> (--base-amount <n> | --currency-amount <n>) [--client-dual-id <id>] [--dry-run]	WRITE
10	pionex-trade-cli earn dual revoke_invest	--base <c> --product-id <id> --client-dual-id <id> [--dry-run]	WRITE
11	pionex-trade-cli earn dual collect	--base <c> --client-dual-id <id> --product-id <id> [--dry-run]	WRITE

---

quote と currency のルール

正しい --quote の値はベース通貨によって異なります：

ベース通貨	--quote	--currency の選択肢
BTC、ETH	USDXO	USDT または USDC
その他すべてのベース通貨（XRP、SOL、LRC など）	USDT	USDT

誤った --quote を指定すると、DUAL_PARAMETER_ERROR: invalid base quote が返されます。

---

商品タイプの意味

タイプ	投資先	満期時に権利行使価格に到達	権利行使価格に到達しない場合
DUAL_BASE（商品 ID の C）	ベース通貨（例：BTC）	投資通貨に変換され、利回りが加算されます	ベース通貨で返却され、利回りが加算されます
DUAL_CURRENCY（商品 ID の P）	投資通貨（例：USDT）	ベース通貨に変換され、利回りが加算されます	投資通貨で返却され、利回りが加算されます

---

安全ルール

1. 古い profit 値は決して使用しないでください — earn dual invest の直前に、必ず earn dual prices を呼び出してください。API は一致しない profit 値を拒否します。投資ワークフローのステップ 2 と 3 は連続して実行する必要があります。
2. invest には --profit が必須です — デフォルト値はありません。prices から返された正確な値を渡してください。
3. --base-amount と --currency-amount の両方を指定しないでください — これらは相互に排他的です。どちらか一方を使用してください。
4. 最初にドライランを実行し、実際に実行する前に確認してください — invest、revoke_invest、collect では、必ず --dry-run を指定して実行し、出力をユーザーに提示してから、確認を得て --dry-run なしで実行してください。
5. --client-dual-id を推測しないでください — ユーザーに指定を求めるか、候補を提示して確認を得てください。これは冪等性キーとして機能します。
6. 取り消し／受け取りの前に注文の状態を確認してください — 最初に earn dual get_invests を使用して状態を確認してください。revoke_invest は保留中の注文にのみ実行でき、collect は決済済みの注文にのみ実行できます。
7. --product-id、権利行使価格、有効期限を推測しないでください — これらは必ず API（open_products または get_invests）から取得し、決めつけないでください。

---

投資ワークフロー（必須の 3 ステップ）

ステップ 1：利用可能な商品を取得する

# DUAL_BASE: invest in BTC, payout converted if price rises above strike
pionex-trade-cli earn dual open_products \
  --base BTC \
  --quote USDXO \
  --type DUAL_BASE \
  --currency USDT

# DUAL_CURRENCY: invest in USDT, buy BTC if price drops below strike
pionex-trade-cli earn dual open_products \
  --base BTC \
  --quote USDXO \
  --type DUAL_CURRENCY \
  --currency USDT

レスポンスから productId を選択します（例：BTC-USDXO-260402-68000-P-USDT）。

ステップ 2：現在の利回りを取得する（ステップ 3 の直前に必ず実行）

pionex-trade-cli earn dual prices \
  --base BTC \
  --quote USDXO \
  --product-ids BTC-USDXO-260402-68000-P-USDT

canInvest: true であることを確認し、返された profit 値を正確に記録します（例："0.0039"）。

ステップ 3：ドライランを実行し、確認してから送信する

# Dry-run first — shows the request payload without executing
pionex-trade-cli earn dual invest \
  --base BTC \
  --product-id BTC-USDXO-260402-68000-P-USDT \
  --client-dual-id my-order-001 \
  --currency-amount 100 \
  --profit 0.0039 \
  --dry-run

# After user confirmation, submit (same command without --dry-run)
pionex-trade-cli earn dual invest \
  --base BTC \
  --product-id BTC-USDXO-260402-68000-P-USDT \
  --client-dual-id my-order-001 \
  --currency-amount 100 \
  --profit 0.0039

ステップ 2 と 3 の間に、他のコマンドを呼び出さないでください。 profit 値の有効期間は短いためです。

---

例

商品を閲覧する

# All supported pairs
pionex-trade-cli earn dual symbols

# BTC pairs only
pionex-trade-cli earn dual symbols --base BTC

# Open DUAL_BASE products for ETH (invest ETH, convert to USDT if price rises)
pionex-trade-cli earn dual open_products \
  --base ETH --quote USDXO --type DUAL_BASE --currency USDT

# Open products for XRP (non-BTC/ETH — use USDT quote)
pionex-trade-cli earn dual open_products \
  --base XRP --quote USDT --type DUAL_BASE

価格とインデックスを確認する

# Current yield for a specific product
pionex-trade-cli earn dual prices \
  --base BTC --quote USDXO \
  --product-ids BTC-USDXO-260402-68000-P-USDT

# Multiple product IDs (comma-separated, no spaces)
pionex-trade-cli earn dual prices \
  --base ETH --quote USDXO \
  --product-ids ETH-USDXO-260410-3000-C-USDT,ETH-USDXO-260410-2900-C-USDT

# Real-time index price
pionex-trade-cli earn dual index --base BTC --quote USDXO

# Historical delivery prices
pionex-trade-cli earn dual delivery_prices --base BTC --quote USDXO

アカウントと履歴

# Balances
pionex-trade-cli earn dual balances

# Merged balances (same coin across different bases)
pionex-trade-cli earn dual balances --merge

# Batch query by client order IDs (comma-separated)
pionex-trade-cli earn dual get_invests \
  --base BTC \
  --client-dual-ids my-order-001,my-order-002

# Investment history (--base and --end-time required)
pionex-trade-cli earn dual records \
  --base BTC \
  --quote USDXO \
  --end-time 1775027817297 \
  --limit 20

保留中の注文を取り消す

# 1. Verify order is still pending
pionex-trade-cli earn dual get_invests --base BTC --client-dual-ids my-order-001

# 2. Dry-run
pionex-trade-cli earn dual revoke_invest \
  --base BTC \
  --product-id BTC-USDXO-260402-68000-P-USDT \
  --client-dual-id my-order-001 \
  --dry-run

# 3. Execute after user confirmation
pionex-trade-cli earn dual revoke_invest \
  --base BTC \
  --product-id BTC-USDXO-260402-68000-P-USDT \
  --client-dual-id my-order-001

決済済みの収益を受け取る

# 1. Verify order is settled
pionex-trade-cli earn dual get_invests --base BTC --client-dual-ids my-order-001

# 2. Dry-run
pionex-trade-cli earn dual collect \
  --base BTC \
  --client-dual-id my-order-001 \
  --product-id BTC-USDXO-260402-68000-P-USDT \
  --dry-run

# 3. Execute after user confirmation
pionex-trade-cli earn dual collect \
  --base BTC \
  --client-dual-id my-order-001 \
  --product-id BTC-USDXO-260402-68000-P-USDT