🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

pionex-earn-dual

by @pibrandon

Use when the user asks about Pionex Dual Investment (earn dual): listing supported pairs or products, checking yield rates or index prices, querying balances...

TERMINAL
clawhub install pionex-earn-dual

πŸ“– About This Skill


name: pionex-earn-dual description: > Use when the user asks about Pionex Dual Investment (earn dual): listing supported pairs or products, checking yield rates or index prices, querying balances or investment history, placing or revoking an investment, or collecting settled earnings. Do NOT use for spot trading (pionex-trade), futures grid bots (pionex-bot), or market price/depth data only (pionex-market). license: MIT metadata: author: pionex version: "0.1.0" homepage: "https://www.pionex.com" agent: requires: bins: ["pionex-trade-cli"] install: - id: npm kind: node package: "@pionex/pionex-ai-kit" bins: ["pionex-trade-cli", "pionex-ai-kit"] label: "Install pionex CLI (npm)"

Pionex Earn Dual Investment Skill

Dual Investment products on Pionex: browse products, check yields, invest, revoke, and collect settled earnings via pionex-trade-cli. Public queries require no credentials; write operations require API credentials with Earn permission.

> Beta notice: The Dual Investment API is currently in Beta. Contact open@pionex.com to request access.

Product ID format: {BASE}-{QUOTE}-{YYMMDD}-{STRIKE}-{C|P}-{CURRENCY}, where C = DUAL_BASE and P = DUAL_CURRENCY.

Skill Routing

  • Dual Investment products, prices, invest, revoke, collect β†’ pionex-earn-dual (this skill)
  • Spot market data (depth, tickers, klines) β†’ pionex-market
  • Spot account balance β†’ pionex-portfolio
  • Spot order placement/cancellation β†’ pionex-trade
  • Futures Grid Bot lifecycle β†’ pionex-bot
  • Prerequisites

    1. Install CLI:

       npm install -g @pionex/pionex-ai-kit
       
    2. For private commands (balances, invest, revoke_invest, collect), configure credentials:
       pionex-ai-kit onboard
       
    Ensure your API key has the required permissions: - View β€” for balances, get_invests, records - Earn β€” for invest, revoke_invest, collect 3. Verify (public, no auth needed):
       pionex-trade-cli earn dual symbols
       


    Command Index

    Public Commands (no authentication required)

    | # | Command | Flags | Type | |---|---------|-------|------| | 1 | pionex-trade-cli earn dual symbols | [--base ] | READ | | 2 | pionex-trade-cli earn dual open_products | --base --quote --type DUAL_BASE\|DUAL_CURRENCY [--currency ] | READ | | 3 | pionex-trade-cli earn dual prices | --base --quote --product-ids | READ | | 4 | pionex-trade-cli earn dual index | --base --quote | READ | | 5 | pionex-trade-cli earn dual delivery_prices | --base [--quote ] [--start-time ] [--end-time ] | READ |

    Private Commands β€” View permission

    | # | Command | Flags | Type | |---|---------|-------|------| | 6 | pionex-trade-cli earn dual balances | [--merge] | READ | | 7 | pionex-trade-cli earn dual get_invests | [--base ] --client-dual-ids | READ | | 8 | pionex-trade-cli earn dual records | --base --end-time [--quote ] [--currency ] [--start-time ] [--limit ] | READ |

    Private Commands β€” Earn permission

    | # | Command | Flags | Type | |---|---------|-------|------| | 9 | pionex-trade-cli earn dual invest | --base --product-id --profit (--base-amount \| --currency-amount ) [--client-dual-id ] [--dry-run] | WRITE | | 10 | pionex-trade-cli earn dual revoke_invest | --base --product-id --client-dual-id [--dry-run] | WRITE | | 11 | pionex-trade-cli earn dual collect | --base --client-dual-id --product-id [--dry-run] | WRITE |


    quote and currency Rules

    The correct --quote value depends on the base currency:

    | Base currency | --quote | --currency options | |---------------|-----------|--------------------| | BTC, ETH | USDXO | USDT or USDC | | All other bases (XRP, SOL, LRC, etc.) | USDT | USDT |

    Incorrect --quote will return DUAL_PARAMETER_ERROR: invalid base quote.


    Product Type Semantics

    | Type | Invest in | Strike hit at expiry | Strike NOT hit | |------|-----------|----------------------|----------------| | DUAL_BASE (C in product ID) | Base currency (e.g. BTC) | Converted to investment currency + yield | Returned in base + yield | | DUAL_CURRENCY (P in product ID) | Investment currency (e.g. USDT) | Converted to base currency + yield | Returned in investment currency + yield |


    Safety Rules

    1. Never use a stale profit value β€” Always call earn dual prices immediately before earn dual invest. The API rejects mismatched profit values. Steps 2 and 3 of the invest workflow must be consecutive. 2. --profit is required for invest β€” There is no default; the exact value returned by prices must be passed. 3. Never provide both --base-amount and --currency-amount β€” They are mutually exclusive; use one or the other. 4. Dry-run first, confirm before real execution β€” For invest, revoke_invest, and collect, always run with --dry-run, show output to user, then confirm before running without it. 5. Never infer --client-dual-id β€” Require the user to provide it, or propose one and get confirmation. It acts as an idempotency key. 6. Check order state before revoke/collect β€” Use earn dual get_invests to verify state first: revoke_invest only works on pending orders; collect only works on settled orders. 7. Never infer --product-id, strike, or expiry β€” These must come from the API (open_products or get_invests), never assumed.


    Invest Workflow (Mandatory 3-Step Process)

    Step 1: Get available products

    # 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

    Choose a productId from the response (e.g. BTC-USDXO-260402-68000-P-USDT).

    Step 2: Get current yield rate (must be done immediately before Step 3)

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

    Check canInvest: true and record the profit value exactly as returned (e.g. "0.0039").

    Step 3: Dry-run, confirm, then submit

    # 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

    > Do not call other commands between Steps 2 and 3. The profit value has a short validity window.


    Examples

    Browse products

    # 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

    Check prices and index

    # 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

    Account and history

    # 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

    Revoke a pending order

    # 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

    Collect settled earnings

    # 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

    πŸ’‘ Examples

    Browse products

    # 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

    Check prices and index

    # 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

    Account and history

    # 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

    Revoke a pending order

    # 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

    Collect settled earnings

    # 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

    βš™οΈ Configuration

    1. Install CLI:

       npm install -g @pionex/pionex-ai-kit
       
    2. For private commands (balances, invest, revoke_invest, collect), configure credentials:
       pionex-ai-kit onboard
       
    Ensure your API key has the required permissions: - View β€” for balances, get_invests, records - Earn β€” for invest, revoke_invest, collect 3. Verify (public, no auth needed):
       pionex-trade-cli earn dual symbols