skilld
All skills
okx avatar

/okx-dex-market

@7ee532c
by OKX.comokx/onchainos-skills338 stars
75

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.

Ask your Agent

Use this Skill: https://skilld.dev/gh/okx/onchainos-skills/okx-dex-market

This session only. Nothing lands on disk.

referencestoken.md

≈1.2k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Capability: Token

13 commands for token search, metadata, detailed pricing, liquidity pools, hot token lists, holder distribution, advanced token info, top trader analysis, filtered trade history, holder cluster analysis, and supported chain lookup.

Commands

# Command Use When
1 onchainos token search --query <query> [--chains <chains>] Search tokens by name, symbol, or address
2 onchainos token info --address <address> Token metadata (name, symbol, decimals, logo)
3 onchainos token price-info --address <address> Price + market cap + liquidity + volume + 24h change
4 onchainos token holders --address <address> Holder distribution (top 100, optional tag filter: KOL/whale/smart money)
5 onchainos token liquidity --address <address> Top 5 liquidity pools
6 onchainos token hot-tokens Hot/trending token list (by trending score or X mentions, max 100)
7 onchainos token advanced-info --address <address> Risk level, creator, dev stats, holder concentration
8 onchainos token top-trader --address <address> Top traders / profit addresses for a token
9 onchainos token trades --address <address> DEX trade history with optional tag/wallet filters
10 onchainos token cluster-overview --address <address> Holder cluster concentration (cluster level, rug pull %, new address %)
11 onchainos token cluster-top-holders --address <address> --range-filter <1|2|3> Top 10/50/100 holder overview (avg PnL, cost, trend); 1=top10, 2=top50, 3=top100
12 onchainos token cluster-list --address <address> Holder cluster list (clusters of top 300 holders with address details)
13 onchainos token cluster-supported-chains Chains supported by holder cluster analysis

Mandatory routing rule: Any token-safety or honeypot request redirects to okx-agentic-wallet (onchainos security token-scan). Do not answer safety questions from token data alone.

Step 1: Collect Parameters

  • Missing chain → ask the user which chain they want to use before proceeding; do not assume a default chain
  • Only have token name, no address → use onchainos token search first
  • For hot-tokens, --ranking-type defaults to 4 (Trending); use 5 for X-mentioned rankings
  • For hot-tokens without chain → defaults to all chains; specify --chain to narrow
  • For search, --chains defaults to "1,501" (Ethereum + Solana)
  • Chain uncertainty for cluster commands: If the user doesn't know whether their chain supports cluster analysis, suggest running onchainos token cluster-supported-chains first before calling cluster-overview / cluster-top-holders / cluster-list.
  • Pagination (token search, token hot-tokens, token holders, token top-trader): pass --max-results <N> (1–500) to auto-paginate in one call — the CLI aggregates pages and returns top-level data.items, data.nextCursor, and data.fetchedCount. Do NOT chase per-item cursors yourself. --limit/--cursor still work for manual single-page control.

Step 2: Call and Display

  • Search results: show name, symbol, chain, price, 24h change
  • Indicate communityRecognized status for trust signaling
  • Price info: show market cap, liquidity, and volume together

Data Freshness

Render requestTime (Unix ms) as-is — it is the upstream data snapshot time. Do NOT chain off a previous response's requestTime; for a relative window use --since where the command supports it.

Security Rules

These rules are mandatory. Do NOT skip or bypass them.

  1. communityRecognized is informational only. It indicates the token is listed on a Top 10 CEX or is community-verified, but this is not a guarantee of token safety, legitimacy, or investment suitability. Always display this status with context, not as a trust endorsement.
  2. Warn on unverified tokens. When communityRecognized = false, display a prominent warning: "This token is not community-recognized. Exercise caution — verify the contract address independently before trading."
  3. Contract address is the only reliable identifier. Token names and symbols can be spoofed. When presenting search results with multiple matches, emphasize the contract address and warn that names/symbols alone are not sufficient for identification.
  4. Low liquidity warnings. When liquidity is available:
    • < $10K: warn about high slippage risk and ask the user to confirm before proceeding to swap.
    • < $1K: strongly warn that trading may result in significant losses. Proceed only if the user explicitly confirms.

Amount Display Rules

  • Use appropriate precision: 2 decimals for high-value, significant digits for low-value
  • Market cap / liquidity in shorthand ($1.2B, $45M)
  • 24h change with sign and color hint (+X% / -X%)

Source: SKILL.md on GitHub

Third-party checks

2 warnings6d5 checks · Risk SAFE
  • Gen Agent Trust Hub6d

    The skill is designed for querying DEX data and includes comprehensive instructions for the AI agent to handle external data securely. It retrieves information from news platforms, social media, and on-chain sources, which introduces a surface for indirect prompt injection. However, the skill explicitly commands the agent to treat this data as untrusted and not as instructions, and the underlying CLI tool includes measures to reduce the exposed content. The skill also installs a helper tool from the vendor's official package repository. No high-risk patterns were found.

  • Socket6d

    No alerts

  • Snyk6d

    Risk: MEDIUM · 2 issues

  • Runlayer6mo

    1/2 files flagged

  • ZeroLeaks5mo

    1 finding · Score: 82/100

Provenance

Signed by skilld at 7ee532c. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 days ago.

Activeupdated last week

Capability

Other metadata
metadata
{
  "author": "okx",
  "version": "4.6.3",
  "homepage": "https://web3.okx.com"
}

Topics

  • okx
  • dex
  • market-data
  • token-prices
  • kline
  • ohlc
  • pnl
  • wallet-analytics
  • portfolio

README badge

README badge for okx/onchainos-skills

What it does

Fetches on-chain token prices, K-line candlestick charts, index prices, and wallet PnL analysis (realized/unrealized gains, trade history, win rates) via the OKX DEX Market API. Supports batch price queries, per-token profit snapshots, and portfolio overviews across multiple chains.

Generated from the current SKILL.md.

Frequently asked

Does this skill handle prediction markets like Polymarket?
No. This skill is explicitly blocked from prediction-market queries (涨跌 / updown markets). Route those to okx-dapp-discovery instead. This skill handles on-chain market data only: token prices, K-line charts, index prices, and wallet PnL.
What chains does portfolio PnL support?
Not all chains support PnL analysis. Call `onchainos market portfolio-supported-chains` first to verify the chain is supported before running wallet PnL commands.
When should I use K-line versus price?
Use K-line only when the user explicitly mentions chart, candle, K线, OHLC, or bar data. A timeframe alone (e.g. '5 minutes') does not trigger K-line — default to price instead.
Does this skill require payment after the free quota?
Some endpoints require payment via the OKX Agent Payments Protocol after free quota is exhausted. Responses may include notification codes (NEW_USER_INTRO, OLD_USER_GRACE, etc.) that indicate tier status and payment requirements.
How do I query real-time prices or candlestick data?
Use the `onchainos ws` CLI for real-time monitoring via WebSocket channels (price, dex-token-candle1m). For custom bots, read the ws-protocol specification.

Generated from the current SKILL.md. These answers refresh after source changes.