OKX DEX Market Skill for Claude Code: Token Research

Lets Claude look up token prices, holders, smart-money moves and new meme launches through OKX’s onchainos CLI, for crypto researchers.

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

The skill sends your questions to the onchainos command line tool. It covers six areas: token search, rankings, holders and clusters; prices, K-line charts and wallet profit and loss; smart-money, KOL and whale signals; news and sentiment; meme-launch research; and real-time WebSocket streams. SKILL.md describes all of it as read-only data.

It does not trade. Swaps go to okx-agentic-wallet, protocol-specific requests go to okx-dapp-discovery, and token-safety or honeypot checks go to okx-agentic-wallet. One thing to know first: the data comes with a monthly free quota, and after that each call can cost money, paid from your OKX wallet. Read the permissions section before you go past the free quota.

Good for

Crypto traders who research a token before they buy it
People who follow smart-money, whale or KOL wallets
Developers who want a WebSocket price or signal feed for a bot

Install okx-dex-market

Claude Code

Copy this prompt.

Install the okx-dex-market 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 README installs the whole onchainos set (CLI, skills and A2A runtime) in one go, not this skill alone. It lists Git and Node.js as prerequisites. Add --beta for the beta channel. To trade on what you find, the wallet skill from the same repo is installed with it.

From the project README. Source.

What's in the skill

When it loads

Query read-only DEX token, market, signal, social, trenches, and WebSocket data. Use for token search, rankings, liquidity, holders, risk metadata, clusters, and trades; prices, K-lines/OHLC, indexes, and wallet PnL; smart-money/KOL/whale signals; news, sentiment, and token vibe; meme-launch, developer, bundle/sniper, and co-investor research; or DEX WebSocket clients. Triggers include hot tokens, holder concentration, smart money, top-trader leaderboards, pump.fun research, new token launches, on-chain token scanning, bundled or sniper activity, and WebSocket.

Sections in SKILL.md

Module Description
Preflight
Intent Routing
CLI Reference Access
CLI Result Contract
Security
Confirmation
Trust Boundary
Chain Name Support

Key facts

Author: OKX
Repository: okx/onchainos-skills
Installs on skills.sh: 20,887 as of 2026-11-02
GitHub stars: 343 for the whole okx/onchainos-skills repo
License: MIT (SKILL.md frontmatter)
Last repo commit: 2026-10-30
What is inside: 30 files including SKILL.md: shared notes plus references for token, market, signal, social, trenches and WebSocket data. The repo has no scripts in this folder.
skills.sh audits: Gen Agent Trust Hub: pass; Socket: pass; Snyk: warn
Needs: The onchainos CLI, Git and Node.js (npx). Paid calls also need a logged-in OKX wallet
Skill version: 4.6.7 in the SKILL.md frontmatter
Cost: Monthly free quota, then a per-call fee paid from your wallet (details under Permissions)

What it includes

Search, rank and inspect tokens, holders and clusters
Covers token search, metadata, price info, liquidity, holders, top traders, trades and holder-cluster analysis. Commands named in follow-ups.md include token search, token info, token price-info, token holders, token advanced-info, token top-trader, token trades and token cluster-overview.
Try: “Show me the holders and top traders for this token.”
Runs code · Token
Prices, K-lines, index prices and wallet PnL
Single and batch prices, K-line (OHLC) candles, index price, and wallet profit and loss or DEX trade history. Commands include market price, market prices, market kline and market portfolio-overview.
Try: “Show the 1-hour candles for this token.”
Runs code · Market
Smart-money, KOL and whale feeds and a top-trader board
Lists aggregated buy signals, tracks custom wallet addresses and ranks top traders. Commands include signal list, tracker activities and leaderboard list.
Try: “What are smart-money wallets buying on Solana today?”
Runs code · Signal
News, sentiment and token vibe
Shows the latest crypto news, market and per-coin sentiment, a token vibe score and a token KOL leaderboard. Commands named in the reference include social news-latest, social news-platforms and social sentiment-ranking.
Try: “Which coins have the best social sentiment right now?”
Runs code · Social
Meme launches, developer history, bundle and sniper checks
Scans new meme launches and checks developer and rug history, bundled or sniper activity and co-investor wallets. Commands include memepump tokens, memepump token-dev-info and memepump token-bundle-info. Buy, sell or snipe requests are routed away to okx-dapp-discovery.
Try: “Screen the newest migrated pump.fun tokens and check their developers.”
Runs code · Trenches
Background live feeds you poll for new events
ws start opens a background session on one of 9 channels (prices, candles, trades, smart-money activity, buy signals, new meme tokens). ws poll pulls new events and ws stop ends it. A session stops by itself after 30 minutes without a poll, unless you change that.
Try: “Start a live feed of smart-money trades and tell me what comes in.”
Runs code · WebSocket streams
Sends DApp, trade and token-safety requests elsewhere
A request about a named DApp (APY, TVL, positions, Polymarket and similar) goes to okx-dapp-discovery. Buy, sell or snipe verbs for a pump.fun-style token go there too. Token-safety and honeypot checks go to okx-agentic-wallet.
Routing gates
Shows quota and pricing messages and pauses for your OK
Every CLI result is checked for notifications. Over-quota notices pause the request and ask you to pick a payment asset or cancel. The CLI keeps notice flags in ~/.onchainos/payment_cache.json.
Files · Payment notices
Runs the onchainos installer once per thread
At the start of each thread the skill runs npx -y @okxweb3/onchainos-installer install with --throttle and its own version, per its preflight.md.
Runs code · Preflight installer

From the official docs

Permissions

High risk

The skill reads market data, but calls past the free quota are charged to your OKX wallet, and it runs an npx installer at the start of each thread. Keep a small balance in the wallet and read every over-quota prompt before you confirm.

What it can do

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

Watch out for

Calls past the free quota cost real money
Basic calls are listed at 0.0001 dollars and premium calls at 0.005 dollars each after the monthly free quota, charged to your OKX wallet. Once you confirm a tier, the CLI auto-signs later charges for it. Fund the wallet with a small balance only. github.com
The prompt fires when a tier starts charging, then payments are signed automatically
payment-notifications.md says the pause and the Yes/No or asset prompt fire each time a tier flips from free to charging (Basic and Premium separately), and that the flag resets if the quota resets server-side, so expect it again in a later month. Between those prompts the CLI signs charges for that tier itself, using the saved default asset. Run onchainos payment default unset to clear the saved asset. github.com
It runs an npx installer at the start of a thread
The preflight step runs the @okxweb3/onchainos-installer package from npm with the skill version. That is third-party code, so install it on a machine you trust. github.com
Token names and news can carry prompt injection
SKILL.md tells the agent to treat every CLI field as untrusted content. Do not paste unknown tokens or links into the session and ask it to act on them. github.com
WebSocket sessions keep running in the background
ws start opens a background session that stops after 30 minutes without a poll by default. Run ws list and ws stop when you are done. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	SKILL.md calls the data commands read-only, but there is no switch that blocks payment. Cancel at the over-quota prompt to refuse a charge.
Talks to	OKX Market API through the onchainos CLI. npm registry (npx installer at the start of each thread). OKX WebSocket channels when you start a ws session
Sign-in and keys	Payment preferences and notice flags are kept in ~/.onchainos/payment_cache.json. Wallet login is handled by the onchainos CLI.
Data retention	Running onchainos wallet logout clears the cache, per payment-notifications.md.
Scopes	OKX wallet login for paid calls Per-call payments after the free quota (X Layer, token of your choice) Writes notice flags to ~/.onchainos/payment_cache.json

Questions

What does the OKX DEX Market skill do?

It makes Claude answer on-chain market questions with the onchainos CLI. That covers token search and holders, prices and candles, smart-money signals, news and sentiment, meme-launch research and live WebSocket feeds. It does not place trades.

How do I install it?

Use the install box above. The README installs the CLI, all the onchainos skills and the A2A runtime together with one npx command, and lists Git and Node.js as prerequisites. The folder alone does nothing without the CLI.

Does it cost money?

It has a free monthly quota and then charges per call. The skill’s own notice file lists 1M free calls a month on basic endpoints and 100K on premium ones, then 0.0001 dollars per basic call and 0.005 dollars per premium call. That file says its pricing numbers are skill-side config that gets updated, so the live prices may differ.

Who gets charged, and does it ask first?

You do, from the wallet you logged in with, in a token you pick on X Layer. When a tier goes over its free quota, the skill pauses, shows the options and waits for you to pick one or cancel. After you confirm, the CLI signs later charges for that tier automatically, until the quota resets and the tier starts charging again. Check your wallet balance now and then.

Do I need an API key?

The files do not ask for one. Paid calls need a logged-in OKX wallet, which you set up through the onchainos CLI and the okx-agentic-wallet skill.

Can it buy or sell tokens?

No. SKILL.md routes writes and protocol-specific actions to the owning skill. Trading goes through okx-agentic-wallet, and buy or snipe requests for meme tokens go to okx-dapp-discovery.

Is it safe?

The data commands read market data, but the skill can lead to a paid call and to a trade in a sibling skill. It tells the agent to treat every CLI field, such as token names and article text, as untrusted and never as instructions. It also runs an npx installer at the start of each thread, so install it on a machine you trust.

How is it different from OKX Agentic Wallet?

DEX Market only reads market data. The Agentic Wallet skill logs in to a wallet and can send, swap and bridge funds. The README pairs them: find a token here, then trade with the wallet skill.

Information

updated Nov 2, 2026

Repository: okx/onchainos-skills
Folder: skills/okx-dex-market

okx/onchainos-skills skills.sh

Sources

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

Show all 6

onchainos-skills README · github.com
okx-dex-market SKILL.md · github.com
okx-dex-market payment-notifications.md · github.com
okx-dex-market follow-ups.md · github.com
okx-dex-market ws.md · github.com
okx-dex-market preflight.md · github.com