How do I install the Okx Defi skill?

Run npx skillmds@latest add aiskillstore/okx-defi in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Okx Defi safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Okx Defi?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Okx Defi free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Okx Defi?

aiskillstore (@aiskillstore) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Okx Defi by aiskillstore — Agent Skill

Name: Okx Defi
Rating: 4.2 (5 reviews)
Author: aiskillstore

Okx Defi

OKX-aggregated DeFi (no specific DApp named) — product discovery, deposit/withdraw/claim execution, AND positions viewing. **If the user names ANY third-party protocol/DApp (Aave, Lido, PancakeSwap, Uniswap, Curve, Compound, Morpho, Pendle, Kamino, Raydium, Hyperliquid, Polymarket, …), route to okx-dapp-discovery — NOT here, even for 'show my Aave positions'.** INVEST triggers: 'invest in DeFi', 'earn yield', 'find best APY', 'deposit/stake for yield', 'search DeFi products', 'redeem/withdraw position', 'claim DeFi rewards', 'borrow against asset', 'repay loan', 'add/remove CLMM liquidity', 'APY/TVL history', 'depth chart', yield farming, lending, staking, liquidity pools. PORTFOLIO triggers: 'check my DeFi positions', 'view DeFi holdings/portfolio', 'my staking/lending positions', 'DeFi balance', 'DeFi 持仓', '我的DeFi资产'. Do NOT use for: DEX swaps (okx-agentic-wallet), token prices (okx-dex), wallet token balances (okx-agentic-wallet).

aiskillstore Updated Sep 9, 2026

File contents

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
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)

--- name: okx-defi description: "OKX-aggregated DeFi (no specific DApp named) — product discovery, deposit/withdraw/claim execution, AND positions viewing. **If the user names ANY third-party protocol/DApp (Aave, Lido, PancakeSwap, Uniswap, Curve, Compound, Morpho, Pendle, Kamino, Raydium, Hyperliquid, Polymarket, …), route to okx-dapp-discovery — NOT here, even for 'show my Aave positions'.** INVEST triggers: 'invest in DeFi', 'earn yield', 'find best APY', 'deposit/stake for yield', 'search DeFi products', 'redeem/withdraw position', 'claim DeFi rewards', 'borrow against asset', 'repay loan', 'add/remove CLMM liquidity', 'APY/TVL history', 'depth chart', yield farming, lending, staking, liquidity pools. PORTFOLIO triggers: 'check my DeFi positions', 'view DeFi holdings/portfolio', 'my staking/lending positions', 'DeFi balance', 'DeFi 持仓', '我的DeFi资产'. Do NOT use for: DEX swaps (okx-agentic-wallet), token prices (okx-dex), wallet token balances (okx-agentic-wallet)." license: MIT metadata: author: okx version: "4.2.1" homepage: "https://web3.okx.com" --- # 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](references/invest.md) | | Product detail (APY, TVL, accepted tokens) | [invest.md](references/invest.md) | | Deposit / stake / provide liquidity | [invest.md](references/invest.md) | | Withdraw / redeem a position (full or partial) | [invest.md](references/invest.md) | | Claim rewards (platform / investment / V3 fee / bonus / unlocked principal) | [invest.md](references/invest.md) | | APY history, TVL history, V3 depth / price charts | [invest.md](references/invest.md) | | View DeFi positions / holdings overview (持仓) | [portfolio.md](references/portfolio.md) | | Per-protocol position detail (持仓详情) | [portfolio.md](references/portfolio.md) | | Exact parameters / return schemas — invest & charts commands | [invest-cli-reference.md](references/invest-cli-reference.md) | | Exact parameters / return schemas — positions commands | [portfolio-cli-reference.md](references/portfolio-cli-reference.md) | | Errors / failed deposits / expired calldata | [invest-troubleshooting.md](references/invest-troubleshooting.md) | | Errors / empty positions / address-format issues | [portfolio-troubleshooting.md](references/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` - 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)

Frequently asked questions