OKX DeFi Portfolio

2 commands for viewing DeFi positions and holdings across protocols and chains.

Skill Routing

• For DeFi deposit/redeem/claim → use okx-defi-invest
• For token price/chart → use okx-dex-market
• For wallet token balances → use okx-wallet-portfolio
• For DEX spot swap → use okx-dex-swap

Quickstart

# Get DeFi holdings overview across chains
onchainos defi positions \
  --address 0xYourWallet \
  --chains ethereum,bsc,solana

# Get detailed holdings for a specific protocol (analysisPlatformId from positions output)
onchainos defi position-detail \
  --address 0xYourWallet \
  --chain ethereum \
  --platform-id 67890

Command Index

Chain Support

Operation Flow

Step 0: Address Resolution

When the user does NOT provide a wallet address, resolve it automatically from the Agentic Wallet before running any defi command:

1. onchainos wallet status          → check if logged in, get active account
2. onchainos wallet addresses       → get addresses grouped by chain category:
                                       - XLayer addresses
                                       - EVM addresses (Ethereum, BSC, Polygon, etc.)
                                       - Solana addresses
3. Match address to target chain:
   - EVM chains → use EVM address
   - Solana     → use Solana address
   - XLayer     → use XLayer address

Rules:

• If the user provides an explicit address, use it directly — skip this step
• If wallet is not logged in, ask the user to log in first (→ okx-agentic-wallet) or provide an address manually
• If the user says "check all accounts" or "all wallets", use wallet balance --all to get all account IDs, then wallet switch <id> + wallet addresses for each account, and query positions for each
• Always confirm the resolved address with the user before proceeding if the account has multiple addresses of the same type

Step 1: Identify Intent

Step 2: Collect Parameters

• Missing wallet address → resolve via Step 0 (wallet status → wallet addresses), or ask user if not logged in
• Missing chains → ask user which chains to query, or suggest common ones (ethereum, bsc, solana)
• Missing platform-id → run defi positions first to get analysisPlatformId

Step 3: Display Results

Displaying Positions Results

When displaying defi positions output, you MUST use exactly these columns in this order — no substitutions, no omissions:

Rules:

• analysisPlatformId is MANDATORY in every row — users must copy this value to run position-detail
• Never omit, hide, or replace analysisPlatformId with any other field
• Never group platforms — show every platform as its own row regardless of value size
• Raw JSON path: walletIdPlatformList[*].platformList[*] — each element is one platform row
  • platformName → Platform
  • analysisPlatformId → analysisPlatformId
  • networkBalanceList[*].network → Chains (join with comma)
  • investmentCount → Positions
  • currencyAmount → Value(USD)

Displaying Position Detail Results

Output shape: { "ok": true, "data": [ { "walletIdPlatformDetailList": [...] }, ... ] } — data is an array. Never call .get() on data directly; iterate over it as a list.

When displaying defi position-detail output, render all tokens in a single flat table with these exact columns:

Rules:

• Each token row is one row; merge in investmentId and aggregateProductId from its parent investment entry
• investmentId is MANDATORY in every row — users need it for redeem/claim (via okx-defi-invest)
• aggregateProductId — show if present, otherwise –
• Token Contract: show the full contract address without truncation; show – if native/empty
• Rewards: show pending reward amount + symbol if present, – if none; for platform rewards show Platform reward
• Type: map investType → Supply/Borrow/Stake/Farm/Pool etc; pending rewards row uses Pending
• Health rate: show separately below the table with warning if healthRate < 1.5

V3 Pool Positions — Extra Fields

For V3 Pool positions (positionList present), show an additional section per position:

• tokenId: from positionList[].tokenId
• positionStatus: ACTIVE or INACTIVE
• range: from positionList[].range
• tickLower / tickUpper: from positionList[].rangeInfo.tickLower / rangeInfo.tickUpper
• These fields are critical for V3 operations (add liquidity, withdraw, collect V3 fees)

investType Reference

Post-execution Suggestions

Global Notes

• CRITICAL — Address-chain compatibility: The --address and --chains parameters must be compatible. EVM addresses (0x…) can only query EVM chains; Solana addresses (base58) can only query solana. Never mix them in a single call — the API will return error 84019 (Address format error).
  • 0x… address → only pass EVM chains: ethereum,bsc,polygon,arbitrum,base,xlayer,avalanche,optimism,fantom,linea,scroll,zksync
  • base58 address → only pass solana
  • Sui address → only pass sui
  • Tron address (T…) → only pass tron
  • TON address → only pass ton
  • If the user wants positions across both EVM and Solana, make two separate calls with the respective addresses
• defi positions uses --chains (plural, comma-separated, e.g. --chains ethereum,bsc) — do NOT use --chain
• defi position-detail uses --chain (singular) — do NOT use --chains
• The wallet address parameter is --address for both commands
• position-detail requires analysisPlatformId from positions output as --platform-id
• The CLI resolves chain names automatically (ethereum → 1, bsc → 56, solana → 501)