OKX DeFi Skill for Claude Code: Find Yield, Deposit and Track Positions

Lets your coding agent find DeFi yields, deposit, withdraw, claim rewards and view positions across protocols and chains through OKX's onchainos CLI.

Installs: 11.5K; on skills.sh
Stars: 343; on GitHub
Files: 7; besides SKILL.md
Updated: Oct 2026; last repo commit

The okx-defi skill runs the onchainos defi commands. It searches and lists products by APY, shows details and APY or TVL history, and prepares deposits, staking, liquidity, withdrawals and reward claims. A second set of commands shows your DeFi positions and per-protocol holdings.

It works with the okx-agentic-wallet skill, which handles login, balances and signing. Requests about a named protocol go to a different skill, okx-dapp-discovery. Deposits and withdrawals move real funds, and the skill requires your confirmation before each one.

Good for

Crypto users comparing yields and TVL across DeFi products
People who want an agent to prepare deposits, withdrawals and reward claims
Anyone checking their DeFi holdings on EVM chains, Solana and others

Install okx-defi

Claude Code

Copy this prompt.

Install the okx-defi skill in Claude Code. Run this command:

npx -y @okxweb3/onchainos-installer install

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js, Git.

The installer sets up the CLI, the skills and the A2A runtime together, per the README. Add --beta for the beta channel. okx-defi relies on okx-agentic-wallet for wallet login and signing.

From the project README. Source.

What's in the skill

When it loads

Discover and manage OKX-aggregated DeFi products and positions across protocols and chains. Use for generic or venue-agnostic yield, APY, or TVL discovery and history; DeFi deposits, staking, liquidity, withdrawals, rewards, lending, CLMM analysis; and DeFi portfolio or position views. Requests targeting a named protocol belong to DApp discovery. Triggers include earn yield, best APY, DeFi product, APY/TVL history, deposit, stake, withdraw, redeem, provide or remove liquidity, claim rewards, borrow or repay, CLMM, V3 liquidity charts, DeFi portfolio, and DeFi holdings.

Sections in SKILL.md

Preflight
Intent Routing
Chain Name Support
Security
Address Resolution
Address-Chain Compatibility
Global Notes

Key facts

Author: OKX (okx/onchainos-skills)
Repo: okx/onchainos-skills, folder skills/okx-defi
Installs on skills.sh: 11,547 as of 2026-11-02
GitHub stars: 343 for the whole okx/onchainos-skills repo, 2026-11-02
License: MIT (declared in SKILL.md frontmatter; the README says MIT)
Last repo commit: 2026-10-30
What is inside: 8 files including SKILL.md: invest and portfolio guides, 2 CLI references, 2 troubleshooting guides and a shared preflight
Needs: The onchainos CLI (installed by the README installer) and the okx-agentic-wallet skill for wallet login and signing
Disclaimer: OKX says nothing it provides is financial advice

What it includes

List top products by APY or search by token, platform, chain and product group.
Results above 50 percent APY must carry a risk warning.
Runs code · defi list and defi search
Product details, APY and TVL history, and V3 depth and price charts.
Detail gives APY, TVL and accepted tokens.
Runs code · defi detail and charts
Prepares a deposit, staking or liquidity transaction.
It only returns unsigned transaction data. The guide says a balance check through the wallet skill is required first.
Runs code · defi invest
Prepares a full or partial withdrawal.
Use a ratio of 1 for a full exit.
Runs code · defi withdraw
Prepares a reward claim.
Covers platform, investment, V3 fee and bonus rewards.
Runs code · defi collect
Sends each prepared step through the wallet skill's contract-call command.
Steps run one at a time and stop at the first failure. Solana transactions expire in about 60 seconds.
Runs code · Sign and broadcast
Show your DeFi holdings overview and per-protocol detail.
The address comes from your agentic wallet unless you give one.
Runs code · defi positions and defi position-detail
At the start of each thread, runs the OKX installer through npx.
The shared preflight file runs the onchainos installer with a throttle and the skill version.
Runs code · Preflight

From the official docs

Permissions

High risk

This skill prepares deposits and withdrawals that your OKX wallet then signs and sends. Use small amounts, read every confirmation, and be wary of very high APYs.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can deposit and withdraw real funds
Deposits, withdrawals and reward claims are signed and broadcast from your wallet. The guide requires confirmation before each, but check the amounts, token and chain yourself. github.com
High APY products carry risk
The guide requires a warning for any product above 50 percent APY and mentions impermanent loss, contract risk and unsustainable rewards. Take it seriously. github.com
It runs an installer through npx
The preflight runs @okxweb3/onchainos-installer through npx at the start of a thread. That is third-party code from npm, so use a machine you trust. github.com
OKX disclaims financial advice
The DISCLAIMER says nothing it provides is investment advice and you are responsible for your decisions. github.com

Technical details

Turning on read-only	No switch. defi list, search, detail and positions only read, while invest, withdraw and collect lead to signed transactions.
Talks to	OKX backend, through the onchainos CLI
Sign-in and keys	Uses your OKX wallet login via the okx-agentic-wallet skill. The invest guide says the CLI never holds private keys.
Scopes	Runs onchainos defi commands that search products and prepare transactions Sends prepared steps with onchainos wallet contract-call through the wallet skill Reads your DeFi positions

Questions

What does the okx-defi skill do?

It lets your coding agent search DeFi products, check APY and TVL, prepare deposits, withdrawals and reward claims, and view your DeFi positions, through the onchainos CLI.

How do I install it?

Use the install box at the top of this page. It runs the OKX installer, which sets up the onchainos CLI and the skills together. Installing only the skill folder does nothing without the CLI.

Can it move my funds?

Yes, through the wallet skill. The defi commands only return unsigned transactions, then each step is signed and sent with the wallet's contract-call command. The guide says user confirmation is required before every invest, withdraw or collect. The deposit comes from your wallet, and the guide warns that skipping the balance check wastes gas on failed transactions.

Does it need the wallet skill?

Yes. Its preflight and address lookup use okx-agentic-wallet, and deposits need a balance check there. The README installer installs the skills together.

Can it use a protocol I name, like Aave?

SKILL.md sends requests that name a specific protocol to okx-dapp-discovery. This skill handles generic, cross-protocol yield and positions.

Is it safe to use?

It can trigger real on-chain transactions from your OKX wallet, so treat it as high risk. Start with small amounts, check each confirmation, and note that high-APY products can carry risks the skill itself warns about.

Information

updated Nov 2, 2026

Repository: okx/onchainos-skills
Folder: skills/okx-defi

okx/onchainos-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5

https://github.com/okx/onchainos-skills/blob/HEAD/README.md · github.com
https://github.com/okx/onchainos-skills/blob/HEAD/skills/okx-agentic-wallet/_shared/preflight.md · github.com
https://github.com/okx/onchainos-skills/blob/HEAD/skills/okx-defi/SKILL.md · github.com
https://github.com/okx/onchainos-skills/blob/HEAD/skills/okx-defi/references/invest.md · github.com
https://github.com/okx/onchainos-skills/blob/HEAD/skills/okx-defi/references/portfolio.md · github.com