okx-defi

OKX DeFi (experimental merge of okx-defi-invest + okx-defi-portfolio)

Multi-chain, OKX-aggregated DeFi in two capabilities behind one skill. Both wrap the same onchainos defi CLI command group.

Pre-flight Checks

Read ../okx-agentic-wallet/_shared/preflight.md. If that file does not exist, read _shared/preflight.md instead.

Intent Routing

User Intent	Reference
Discover / search DeFi products, find best APY	invest.md
Product detail (APY, TVL, accepted tokens)	invest.md
Deposit / stake / provide liquidity	invest.md
Withdraw / redeem a position (full or partial)	invest.md
Claim rewards (platform / investment / V3 fee / bonus / unlocked principal)	invest.md
APY history, TVL history, V3 depth / price charts	invest.md
View DeFi positions / holdings overview (持仓)	portfolio.md
Per-protocol position detail (持仓详情)	portfolio.md
Exact parameters / return schemas — invest & charts commands	invest-cli-reference.md
Exact parameters / return schemas — positions commands	portfolio-cli-reference.md
Errors / failed deposits / expired calldata	invest-troubleshooting.md
Errors / empty positions / address-format issues	portfolio-troubleshooting.md

Typical flow spans both: view positions (Portfolio) → redeem or claim (Invest). Read both reference files when the request chains them.

Skill Routing

• For DApp-named investing/lending/staking/positions ("on Aave", "my Hyperliquid balance") → use okx-dapp-discovery
• For token price/chart or token search by name/contract → use okx-dex-market
• For DEX spot swap execution → use okx-agentic-wallet
• For wallet token balances → use okx-agentic-wallet
• For broadcasting signed transactions → use okx-agentic-wallet
• For Agentic Wallet login, balance, contract-call → use okx-agentic-wallet

Chain Support

CLI resolves chain names automatically (e.g. ethereum → 1, bsc → 56, solana → 501). Full alias table: references/portfolio.md §Chain Support.

Step 0: Address Resolution (shared by both capabilities)

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
• Always confirm the resolved address with the user before proceeding if the account has multiple addresses of the same type

Address-Chain Compatibility (shared — CRITICAL)

The --address and chain parameters must be compatible. EVM addresses (0x…) can only query EVM chains; Solana addresses (base58) can only query solana. Never mix them — 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

Global Notes

• The wallet address parameter for ALL defi commands is --address
• defi positions uses --chains (plural, comma-separated); defi position-detail uses --chain (singular)
• For CLI parameter details, see references/invest-cli-reference.md (invest & charts) and references/portfolio-cli-reference.md (positions)