Puts your crypto to work earning interest or rewards across many blockchains: find the products paying the best yield, put money in or take it out, claim what you have earned, and see all your positions in one place.
WHEN TO USE
USE FOR
NOT FOR
This is a saved copy of the skill's SKILL.md instructions. It may differ from the upstream file or the version you install.
Discover and manage multi-chain, OKX-aggregated DeFi products and positions through the onchainos defi CLI group.
Preflight checks: At the start of each thread, complete the checks in ../okx-agentic-wallet/_shared/preflight.md. If missing, read _shared/preflight.md.
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.
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.
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 addressRules:
okx-agentic-wallet) or provide an address manuallywallet balance --all to get all account IDs, then wallet switch <id> + wallet addresses for each accountThe --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,zksyncsolanasui; Tron address (T…) → only pass tron; TON address → only pass ton--addressdefi positions uses --chains (plural, comma-separated); defi position-detail uses --chain (singular)All items below are required.
Every command here is onchainos defi ... from the Onchain OS CLI (okx-guide covers install and update); each thread first runs the preflight checks in ../okx-agentic-wallet/_shared/preflight.md.
Without an explicit --address, the address is resolved from the Agentic Wallet with onchainos wallet status and onchainos wallet addresses, so the wallet must be logged in (via okx-agentic-wallet). EVM addresses only query EVM chains and Solana addresses only Solana.
This skill ships inside the OKX OnchainOS Skills plugin.
This route installs the OKX OnchainOS Skills plugin package selected for your AI tool.
PLUGIN MARKETPLACE
Typed inside the agent's own prompt, not in a terminal. The marketplace is called onchainos-skills, which is the part after the @.
/plugin marketplace add okx/onchainos-skills/plugin install onchainos-skills@onchainos-skillsInstalling just this skill adds only its own folder. Its instructions also call for other plugin components, such as shared scripts, reference files or other skills, which aren't included. Installing the whole plugin avoids this gap.
Run this outside your AI tool, using Node.js 22.20.0 or newer. Skills CLI 1.7.2 skips skill selection; prompts cancel installation without an interactive terminal. If choosing Project when asked about installation scope, open your project's folder before running this.
Install checklist
Additional agents. ↑/↓ moves, Space toggles selections, Enter confirms.Installing to: for your intended tool. Stop if it names a different tool.Symlink (Recommended) for shared files or Copy to all agents for separate copies; review the summary before confirming installation.Install the find-skills skill? defaults to Yes, adding another skill for all projects. Choose No if you don't want that extra installation.Skills CLI 1.7.2 sends install data to skills.sh by default, including the source, skill names, target tools and file details; GitHub sources are reported only when GitHub confirms the repository is public, while other remote sources can also be reported. Confirmed-public GitHub sources also trigger a security-audit request. Before installing, set the environment variable DO_NOT_TRACK=1 or DISABLE_TELEMETRY=1 to disable both.
npx skills add okx/onchainos-skills --skill "okx-defi" --full-depthAfter installing for Claude Code, open it in the installation project if you chose Project; Global makes the skill available across projects on this computer. Once Claude Code loads the skill, its description helps Claude decide when to use it.
If installation created a top-level skills folder that did not exist when your Claude Code session started, run /reload-skills in that session. Run it again after later changes in that folder.