okx-agent-skills
A collection of AI agent skills for OKX exchange operations. Each skill is a self-contained Markdown file with YAML frontmatter that tells an AI agent when to activate and how to execute tasks via the okx CLI.
onchainos skills for AI coding assistants. Provides token search, market data, wallet balance queries, swap execution, transaction broadcasting, leaderboard rankings, token cluster analysis, and direct third-party DApp routing across 20+ blockchains.
> /plugin marketplace add okx/onchainos-skills> /plugin install onchainos-skills@onchainos-skills
Repo: okx/onchainos-skills
What's inside
onchainos skills for AI coding assistants. Provides token search, market data, wallet balance queries, swap execution, transaction broadcasting, leaderboard rankings, token cluster analysis, and direct third-party DApp routing across 20+ blockchains.
| Skill | Description |
|---|---|
okx-agentic-wallet | Wallet lifecycle (auth, balance, portfolio PnL, send, tx history, contract call), Gas Station, DEX swap, cross-chain bridge, limit-order strategy, transaction gateway (gas / simulate / broadcast / track order), public-address portfolio, security scanning (token risk, DApp phishing, tx & signature checks, approvals), audit log |
okx-dex-market | Read-only on-chain DEX data: real-time prices/K-line/index/wallet PnL, address tracker activities, smart money/whale/KOL signal tracking + leaderboard rankings, token search/metadata/market cap/rankings/liquidity/hot tokens/holder & cluster analysis/top traders/trade history, crypto news/sentiment/vibe/KOL leaderboard, meme pump/trenches scanning/dev reputation/bundle detection (read-only), and WS/script real-time streaming |
okx-agent-payments-protocol | Unified payment dispatcher across x402 (exact / aggr_deferred schemes โ TEE or local-key sign), MPP (charge / session intents โ open / voucher / topUp / close, transaction or hash mode), and a2a-pay (paymentId-based create / pay / status). Routes to per-scheme/intent references. |
okx-defi | OKX-aggregated DeFi: product discovery, deposit, withdraw, claim rewards across Aave, Lido, PancakeSwap, Kamino, NAVI and more, plus positions and holdings overview across protocols and chains |
okx-ai | ERC-8004 on-chain Agent identity (register/update/search/rate/service-list) + agent task marketplace (publish/accept/deliver/dispute) + live task-progress monitor |
okx-guide | Onboarding & guide hub (merges former okx-how-to-play + okx-ai-guide + okx-ai-support): Onchain OS onboarding + welcome banner, OKX.AI intro & role-registration routing, customer-support / Help Center guidance |
okx-dapp-discovery | Third-party DApp discovery and direct plugin routing โ currently supports Polymarket, Aave V3, Hyperliquid, PancakeSwap V3 AMM, Morpho V1 Optimizer |
okx-growth-competition | Agentic Wallet exclusive trading competitions: list, join, view leaderboard, claim rewards |
okx-activity | OKX activity hub โ per-activity content under references/<activity>-*.md. Currently: OKX.AI Trading Hackathon registration with an existing Trading ASP |
XLayer, Solana, Ethereum, Base, BSC, Arbitrum, Polygon, and 20+ other chains.
All skills require OKX API credentials. Apply at OKX Developer Portal.
Recommended: create a .env file in your project root:
OKX_API_KEY="your-api-key"
OKX_SECRET_KEY="your-secret-key"
OKX_PASSPHRASE="your-passphrase"
Security warning: Never commit .env to git (add it to .gitignore) and never expose credentials in logs, screenshots, or chat messages.
npx skills add okx/onchainos-skills
Works with Claude Code, Cursor, Codex CLI, and OpenCode. Auto-detects your environment and installs accordingly.
# Run in Claude Code
/plugin marketplace add okx/onchainos-skills
/plugin install onchainos-skills
Tell Codex:
Fetch and follow instructions from https://raw.githubusercontent.com/okx/onchainos-skills/refs/heads/main/.codex/INSTALL.md
Tell OpenClaw:
Fetch and follow instructions from https://raw.githubusercontent.com/okx/onchainos-skills/refs/heads/main/.openclaw/INSTALL.md
Tell OpenCode:
Fetch and follow instructions from https://raw.githubusercontent.com/okx/onchainos-skills/refs/heads/main/.opencode/INSTALL.md
The skills work together in typical DeFi flows:
Search and Buy: okx-dex-market (find token) -> okx-agentic-wallet (check funds + execute trade)
Portfolio Overview: okx-agentic-wallet (holdings) -> okx-dex-market (enrich with analytics + price charts)
Market Research: okx-dex-market (trending/rankings + candles/history) -> okx-agentic-wallet (trade)
Swap and Broadcast: okx-agentic-wallet (get quote -> swap -> broadcast -> track order)
Full Trading Flow: okx-dex-market (search + price/chart) -> okx-agentic-wallet (check balance -> swap -> simulate + broadcast + track)
Leaderboard โ Research โ Trade: okx-dex-market (top traders by PnL/win rate + token analytics) -> okx-agentic-wallet (execute trade)
Follow Smart Money: okx-dex-market (KOL/smart money buys + token details + holder cluster + price chart) -> okx-agentic-wallet (trade)
Pre-built workflow orchestrations in workflows/ compose multiple skills into complete operations. The agent reads workflows/INDEX.md to route requests, then follows the step-by-step instructions in the matched workflow file.
| Workflow | What it does | CLI command |
|---|---|---|
| Token Research | Price, security, holders, cluster, smart money signals, optional launchpad deep-dive | onchainos workflow token-research --address <addr> |
| Daily Brief | Market pulse + smart money + new token activity + portfolio alerts | โ |
| Smart Money Signals | SM signal list aggregated by token + per-token due diligence | onchainos workflow smart-money |
| New Token Screening | MIGRATED launchpad scan + safety & dev enrichment for top 10 | onchainos workflow new-tokens |
| Wallet Analysis | 7d/30d PnL, trading behaviour, recent on-chain activity | onchainos workflow wallet-analysis --address <addr> |
| Portfolio Check | Balances, total value, 30d PnL overview | onchainos workflow portfolio --address <addr> |
| Wallet Monitor | In-session polling โ alert on new trades from watched wallets | โ |
| Wallet Monitor (WS) | Background WebSocket session for offline wallet monitoring | โ |
Single commands that replace multiple individual tool calls:
# Token report: info + price + advanced-info + security scan (parallel)
onchainos token report --address <addr> --chain solana
# Full workflow commands
onchainos workflow token-research --address <addr> [--chain solana]
onchainos workflow smart-money [--chain solana]
onchainos workflow new-tokens [--chain solana] [--stage MIGRATED]
onchainos workflow wallet-analysis --address <addr> [--chain ethereum]
onchainos workflow portfolio --address <addr> [--chains ethereum,solana]
Auto-detects your platform, downloads the latest stable release, verifies SHA256 checksum, and installs to ~/.local/bin:
curl -sSL https://raw.githubusercontent.com/okx/onchainos-skills/main/install.sh | sh
To install the latest beta version (includes pre-releases):
curl -sSL https://raw.githubusercontent.com/okx/onchainos-skills/main/install.sh | sh -s -- --beta
Note: Beta versions (e.g.,
v2.0.0-beta.0) are opt-in only. The default installer and all skill auto-updates always use the latest stable release. Running without--betawill never downgrade a beta installation whose base version is ahead of the latest stable.
Auto-detects your platform, downloads the latest stable release, verifies SHA256 checksum, and installs to %USERPROFILE%\.local\bin:
irm https://raw.githubusercontent.com/okx/onchainos-skills/main/install.ps1 | iex
To install the latest beta version (includes pre-releases):
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/okx/onchainos-skills/main/install.ps1))) --beta
Note: The same beta/stable rules apply โ default installs always use the latest stable release, and
--betais opt-in only.
The onchainos CLI doubles as a native MCP server exposing tools to any MCP-compatible client.
claude mcp add --scope user onchainos-cli onchainos mcp
Built-in Sandbox API Keys (Default) This integration includes built-in sandbox API keys for testing purposes only. By using these keys, you acknowledge and accept the following:
Production Usage (Recommended) For stable and reliable production usage, you must provide your own API credentials by setting the following environment variables:
OKX_API_KEYOKX_SECRET_KEYOKX_PASSPHRASEYou are solely responsible for the security, confidentiality, and proper management of your own API keys. We shall not be liable for any unauthorized access, asset loss, or damages resulting from improper key management on your part.
MIT
.claude-plugin/
marketplace.json
plugin.json
README.md
.codex/
.codex-plugin/
plugin.json
INSTALL.md
.cursor-plugin/
plugin.json
.github/
workflows/
ci.yml
release.yml
.gitignore
.gitlab/
merge_request_templates/
Default.md
.mcp.json.example
.openclaw/
INSTALL.md
.opencode/
INSTALL.md
opencode.json
plugins/
onchainos-skills.js
AGENTS.md
assets/
onchainos.svg
CLAUDE.md
cli/
.cargo/
config.toml
build.rs
Cargo.lock
Cargo.toml
src/
asset_class.rs
audit.rs
chains.rs
client.rs
commands/
agent_commerce/
chat/
mod.rs
identity/
args.rs
mod.rs
models.rs
mutations.rs
parts/
precheck.rs
rating.rs
queries.rs
signing.rs
socket.rs
tests/
mutations_tests.rs
utils_tests.rs
validate_tests.rs
utils.rs
validate.rs
mod.rs
task/
asp/
agreerefund.rs
apply.rs
asp_claim.rs
asp_reject.rs
content.rs
deliver.rs
dispute_confirm.rs
dispute_raise.rs
flow.rs
mod.rs
subscription.rs
common/
a2a_binding.rs
autotrade/
amount.rs
card.rs
consent.rs
grants.rs
mod.rs
notify.rs
profile.rs
schema.rs
subscription.rs
tooling.rs
trade_kit.rs
claim.rs
config.rs
deadline.rs
deliverables.rs
deposit_qr.rs
dispute_upload.rs
in_progress.rs
mod.rs
network/
mod.rs
task_api_client.rs
okx_a2a.rs
onchainos_self.rs
payment_mode.rs
pending_v2.rs
prefilled_notify.rs
prefilled_rating.rs
query.rs
review_gate.rs
session_cleanup.rs
state_machine.rs
user_lang.rs
util.rs
version_notice.rs
evaluator/
claim.rs
claimable.rs
commit.rs
decimal_str.rs
dispute_status.rs
flow.rs
helpers.rs
info.rs
mod.rs
my_stake.rs
reveal.rs
stake.rs
staking_config.rs
staking_types.rs
unstake.rs
mod.rs
signing.rs
user/
accept.rs
asp_ops.rs
attachments.rs
claim_auto_refund.rs
close.rs
complete.rs
content.rs
create_subscribe.rs
create.rs
device_routing.rs
flow_lifecycle/
core.rs
dispute.rs
manage.rs
mod.rs
subscription.rs
terminal.rs
flow_negotiate/
designated.rs
events.rs
match_provider.rs
mod.rs
flow.rs
mod.rs
negotiate.rs
offline_receive.rs
query.rs
reject_apply.rs
reject.rs
subscription_ops.rs
x402_flow.rs
agentic_wallet/
account.rs
auth/
mod.rs
balance/
mod.rs
broadcast.rs
chain.rs
common.rs
gas_station.rs
geoblock.rs
history.rs
mod.rs
plugin.rs
sign.rs
strategy/
api.rs
handlers.rs
mod.rs
session.rs
status.rs
supported_chains.rs
trader_mode.rs
types.rs
transfer/
gas_station.rs
mod.rs
common.rs
competition.rs
cross_chain.rs
defi/
api.rs
helpers.rs
mod.rs
operations.rs
gateway.rs
hackathon/
mod.rs
register.rs
leaderboard.rs
market.rs
memepump.rs
mod.rs
payment/
a2a_pay.rs
addr.rs
decode_receipt.rs
dispatcher.rs
http_carrier.rs
mod.rs
payment_flow.rs
quote.rs
session_state.rs
state.rs
subscription.rs
portfolio.rs
risk_classify.rs
security.rs
signal.rs
sink.rs
social.rs
swap.rs
token.rs
tracker.rs
upgrade.rs
workflows/
mod.rs
new_tokens.rs
portfolio.rs
smart_money.rs
token_research.rs
wallet_analysis.rs
ws.rs
config.rs
crypto.rs
device/
id.rs
mod.rs
name.rs
doh/
binary.rs
cache.rs
manager.rs
mod.rs
types.rs
file_keyring.rs
home.rs
keyring_store.rs
main.rs
mcp/
mcp_client.rs
mod.rs
output.rs
payment/
payment_cache.rs
payment_notify.rs
mod.rs
permit2/
eip712.rs
mod.rs
rpc.rs
sign.rs
types.rs
subscription/
cache.rs
eip712.rs
facilitator.rs
mod.rs
sign.rs
types.rs
qr.rs
test_helpers.rs
token_alias.rs
validators.rs
wallet_api.rs
wallet_store.rs
watch/
daemon.rs
mod.rs
store.rs
types.rs
tests/
cli_agent.rs
cli_command_layout.rs
cli_competition_sink.rs
cli_cross_chain.rs
cli_defi.rs
cli_gateway.rs
cli_hackathon.rs
cli_leaderboard.rs
cli_market.rs
cli_message_eligible.rs
cli_payment.rs
cli_portfolio.rs
cli_security.rs
cli_signal.rs
cli_social.rs
cli_strategy.rs
cli_swap.rs
cli_token.rs
cli_trenches.rs
cli_wallet_login_phase.rs
cli_wallet_persistence.rs
cli_wallet_testnet.rs
cli_workflows.rs
cli_ws.rs
common/
mod.rs
mcp_server.rs
install.ps1
install.sh
openclaw_template/
manifest.json
README.md
setup.sh
workspace/
AGENTS.md
BOOTSTRAP.md
HEARTBEAT.md
IDENTITY.md
memory/
MEMORY.md
.gitkeep
projects/
scan-bot-example.py
SOUL.md
TOOLS.md
USER.md
package-lock.json
package.json
README.md
scripts/
bump-version.sh
sync-shared.sh
SECURITY.md
skills/
okx-activity/
_shared/
preflight.md
references/
hackathon-core.md
hackathon-faq.md
hackathon-registration.md
SKILL.md
okx-agent-payments-protocol/
_shared/
amount-display.md
preflight.md
references/
a2a_charge.md
a2mcp-mcp.md
accepts-schemes.md
charge.md
multi-scheme.md
session.md
subscription.md
SKILL.md
okx-agentic-wallet/
_shared/
chain-support.md
preflight.md
references/
account-faq.md
audit-log.md
bridge-cli-reference.md
bridge-troubleshooting.md
bridge.md
gas-station-troubleshooting.md
gas-station.md
gateway-cli-reference.md
gateway.md
portfolio-cli-reference.md
portfolio.md
security-cli-reference.md
security.md
strategy-cli-reference.md
strategy.md
swap-cli-reference.md
swap-troubleshooting.md
swap.md
wallet-cli-reference.md
wallet-mev-protection.md
wallet-plugin-preflight.md
wallet-portal-actions.md
wallet-troubleshooting.md
wallet.md
SKILL.md
okx-ai/
references/
chat-cli-reference.md
chat-comm-init.md
chat-file-attachment.md
identity-discover.md
identity-errors.md
identity-invariants.md
identity-manage.md
... 107 moreA collection of AI agent skills for OKX exchange operations. Each skill is a self-contained Markdown file with YAML frontmatter that tells an AI agent when to activate and how to execute tasks via the okx CLI.
FAQ
onchainos-skills is a Claude Code plugin with 9 hand-picked skills for finance work, indexed on Flowy. Install it with the command on its page. It includes okx-activity, okx-agent-payments-protocol, okx-agentic-wallet. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.