# Okx Defi > Descubre y gestiona productos y posiciones DeFi agregados por OKX: rendimiento, APY/TVL, staking, liquidez, retiradas, recompensas, préstamos y CLMM. Peticiones a DApps, swaps y tokens van a otras skills; los gráficos APY y V3 quedan aquí. Fuente: https://skillsagentes.com/skills/okx/onchainos-skills/okx-defi Markdown: https://skillsagentes.com/skills/okx/onchainos-skills/okx-defi.md Repositorio: https://github.com/okx/onchainos-skills Autor: okx Licencia: MIT Actualizado: hace 10 días Coste de contexto: 227 tok instalada, 1.4k tok al activarse, 15.3k tok con todos los archivos del bundle Bundle: 8 archivos, 60 KB Permisos que pide: ninguno declarado ## Instalación Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina. ```bash # Claude Code npx -y skills add okx/onchainos-skills --skill okx-defi --agent claude-code # Cursor npx -y skills add okx/onchainos-skills --skill okx-defi --agent cursor # Codex npx -y skills add okx/onchainos-skills --skill okx-defi --agent codex # Gemini CLI npx -y skills add okx/onchainos-skills --skill okx-defi --agent gemini # Windsurf npx -y skills add okx/onchainos-skills --skill okx-defi --agent windsurf # Cline npx -y skills add okx/onchainos-skills --skill okx-defi --agent cline ``` ## Qué hace - Descubre y busca productos DeFi agregados por OKX en múltiples cadenas y protocolos, con APY, TVL e historial. - Gestiona posiciones DeFi: depósitos, staking, liquidez, retiradas, recompensas, préstamos, análisis CLMM y holdings. - Genera gráficos de APY/TVL y de liquidez V3, y resuelve automáticamente la dirección de la Agentic Wallet si no se aporta. - Enruta a okx-dapp-discovery las peticiones sobre DApps concretas, y a okx-agentic-wallet u okx-dex-market los swaps, saldos, tokens y precios de mercado. ## Cuándo usarla - Para descubrir productos DeFi y buscar el mejor APY o el historial de APY/TVL. - Para depositar, hacer staking, aportar o retirar liquidez, retirar o reembolsar una posición y reclamar recompensas. - Para consultar posiciones u holdings DeFi (持仓) y el detalle por protocolo. - Para analizar CLMM y consultar gráficos de APY/TVL y de liquidez V3. ## Cuándo no - Cuando la petición nombre un DApp concreto (Aave, Lido, PancakeSwap, Uniswap, Curve, Compound, Morpho, Pendle, Kamino, Raydium, Hyperliquid o Polymarket): usa okx-dapp-discovery. - Para swaps al contado DEX, saldos de cartera, envío de transacciones firmadas o login/contratos de Agentic Wallet: usa okx-agentic-wallet. - Para búsqueda de tokens, precios de mercado, velas y gráficos de tokens: usa okx-dex-market. ## Qué la activa - "¿Cuál es el mejor APY ahora mismo para hacer staking?" - "Busca productos DeFi con alto TVL y muéstrame su historial." - "Quiero depositar USDC en un producto DeFi y ver mis posiciones." - "Retira mi posición de liquidez y reclama las recompensas pendientes." - "Analiza el pool CLMM y los gráficos de APY y V3." ## Antes de instalar - Requiere completar las comprobaciones previas de okx-agentic-wallet y, si el usuario no da una dirección, tener la Agentic Wallet iniciada para resolverla automáticamente. ## Archivos - SKILL.md — 6 KB - _shared/preflight.md — 1 KB - references/invest-cli-reference.md — 27 KB - references/invest-troubleshooting.md — 2 KB - references/invest.md — 13 KB - references/portfolio-cli-reference.md — 3 KB - references/portfolio-troubleshooting.md — 1 KB - references/portfolio.md — 7 KB ## SKILL.md Reproducido tal cual desde okx/onchainos-skills bajo MIT. Esta sección es el documento original y está en inglés. # 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](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, shared support, and 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. 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](references/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 ` + `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. ## Dónde encaja - Categoría: [Finanzas](https://skillsagentes.com/categorias/finanzas.md) — Contabilidad, modelado financiero y flujos de reportes. - Creador: [okx](https://skillsagentes.com/creators/okx.md) — 7 skills en el directorio - [Todas las skills](https://skillsagentes.com/skills.md) - [Ranking de instalaciones](https://skillsagentes.com/ranking.md) ## Otras skills del mismo repositorio - [Okx Agent Payments Protocol](https://skillsagentes.com/skills/okx/onchainos-skills/okx-agent-payments-protocol.md): Pagos de agentes y endpoints de pago vía x402, MPP, enlaces de pago, a2a-pay y facturación recurrente o por uso: HTTP 402/payment-required, endpoints Agent/A2MCP, x402/Permit2, canales MPP, suscripciones y estados de paymentId. - [Okx Agentic Wallet](https://skillsagentes.com/skills/okx/onchainos-skills/okx-agentic-wallet.md): Usa esta skill cuando quieras operar con OKX Onchain OS, el CLI `onchainos` o la cartera agéntica: estado, saldos, envíos, swaps, bridges, Gas Station, contratos, historial, UTXOs/BRC-20, firmas, aprobaciones, seguridad y audit log. - [Okx Ai](https://skillsagentes.com/skills/okx/onchainos-skills/okx-ai.md): Usa OKX.AI para encontrar y usar tareas y servicios, gestionar suscripciones o registrarte como ASP. Incluye identidad de agente, ciclo de vida de tareas, reputación, staking de evaluador, watch, chat A2A y reparación de okx-a2a. - [Okx Dapp Discovery](https://skillsagentes.com/skills/okx/onchainos-skills/okx-dapp-discovery.md): Descubre DApps y enruta peticiones a plugins de OKX; nunca firma, transmite ni instala sin aprobación. Cubre DApp + acción, comparativas, Polymarket UpDown, token nativo + acción, writes de pump.fun; alternativas para no soportadas. - [Okx Dex Market](https://skillsagentes.com/skills/okx/onchainos-skills/okx-dex-market.md): Datos de solo lectura de DEX (token, market, signal, social, trenches y WebSocket). Las consultas de escritura o DApps sensibles van a okx-dapp-discovery; swaps y chequeos de seguridad, a okx-agentic-wallet; el agente, a okx-ai. ## Skills relacionadas - [Okx Agent Payments Protocol](https://skillsagentes.com/skills/okx/onchainos-skills/okx-agent-payments-protocol.md): Pagos de agentes y endpoints de pago vía x402, MPP, enlaces de pago, a2a-pay y facturación recurrente o por uso: HTTP 402/payment-required, endpoints Agent/A2MCP, x402/Permit2, canales MPP, suscripciones y estados de paymentId. - [Okx Agentic Wallet](https://skillsagentes.com/skills/okx/onchainos-skills/okx-agentic-wallet.md): Usa esta skill cuando quieras operar con OKX Onchain OS, el CLI `onchainos` o la cartera agéntica: estado, saldos, envíos, swaps, bridges, Gas Station, contratos, historial, UTXOs/BRC-20, firmas, aprobaciones, seguridad y audit log. - [Okx Dapp Discovery](https://skillsagentes.com/skills/okx/onchainos-skills/okx-dapp-discovery.md): Descubre DApps y enruta peticiones a plugins de OKX; nunca firma, transmite ni instala sin aprobación. Cubre DApp + acción, comparativas, Polymarket UpDown, token nativo + acción, writes de pump.fun; alternativas para no soportadas. - [Okx Ai](https://skillsagentes.com/skills/okx/onchainos-skills/okx-ai.md): Usa OKX.AI para encontrar y usar tareas y servicios, gestionar suscripciones o registrarte como ASP. Incluye identidad de agente, ciclo de vida de tareas, reputación, staking de evaluador, watch, chat A2A y reparación de okx-a2a. - [Okx Dex Market](https://skillsagentes.com/skills/okx/onchainos-skills/okx-dex-market.md): Datos de solo lectura de DEX (token, market, signal, social, trenches y WebSocket). Las consultas de escritura o DApps sensibles van a okx-dapp-discovery; swaps y chequeos de seguridad, a okx-agentic-wallet; el agente, a okx-ai. --- Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)