okx-defi

SKILL.md

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.