OKX DeFi

Discover and manage multi-chain, OKX-aggregated DeFi products and positions through the onchainos defi CLI group.

Preflight

Preflight checks: At the start of each thread, complete the checks in ../okx-agentic-wallet/_shared/preflight.md. If missing, read _shared/preflight.md.

Intent Routing

Load only the reference files required by the selected route.

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, shared support, and 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.

Route a named third-party DApp request—including protocol-specific APY, TVL, volume, history, or timeframe analysis—to okx-dapp-discovery. Generic cross-protocol yield/APY/TVL and V3-liquidity analysis stays here. Route token search/price/chart requests to okx-dex-market, and spot swaps, wallet balances, login, contract calls, or transaction broadcasts to okx-agentic-wallet.

Chain Name Support

The CLI resolves chain names automatically (for example, ethereum → 1, bsc → 56, solana → 501). Use the Chain Support table in portfolio.md for the DeFi-specific aliases.

Security

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

Address-Chain Compatibility

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)
Before reporting completion, verify the selected command succeeded, apply the output format and safety checks from its routed reference, and report any partial or failed on-chain step explicitly.

okx-defi