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.

referencessignal.md

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

Capability: Signal

5 commands for tracking smart money, KOL, and whale activity — raw transaction feed, aggregated buy signals, and top trader leaderboard.

Commands

# Command Use When
1 onchainos tracker activities --tracker-type <type> See actual trades by smart money/KOL/custom wallets (transaction-level, includes buys and sells)
2 onchainos signal chains Check which chains support signals
3 onchainos signal list --chain <chain> Aggregated buy-only signal alerts (smart money / KOL / whale)
4 onchainos leaderboard supported-chains Check which chains support leaderboard
5 onchainos leaderboard list --chain <chain> --time-frame <tf> --sort-by <sort> Top trader leaderboard ranked by PnL/win rate/volume/ROI (max 20)

Mandatory routing rule: If the user wants actual transaction-level trades, including sells, use tracker. If the user wants tokens that triggered buy alerts across multiple wallets, use signal list.

Step 1: Collect Parameters

Address Tracker:

  • --tracker-type is required: smart_money, kol, or multi_address
  • --wallet-address is required when --tracker-type multi_address; omit for smart_money/kol
  • --trade-type defaults to 0 (all); use 1 for buy-only, 2 for sell-only
  • --chain is optional — omit to get results across all chains
  • Optional token filters (use when user wants to narrow results by token quality or size):
    • --min-volume / --max-volume — trade volume range (USD)
    • --min-market-cap / --max-market-cap — token market cap range (USD)
    • --min-liquidity / --max-liquidity — token liquidity range (USD)
    • --min-holders — minimum number of token holders

Signal:

  • Missing chain → always call onchainos signal chains first to confirm the chain is supported
  • Signal filter params (--wallet-type, --min-amount-usd, etc.) → ask user for preferences if not specified; default to no filter (returns all signal types)
  • --token-address is optional — omit to get all signals on the chain; include to filter for a specific token
  • --wallet-type is multi-select (comma-separated integers: 1=Smart Money, 2=KOL/Influencer, 3=Whale) — e.g. --wallet-type 1,3 returns both Smart Money and Whale signals
  • Pagination: signal list supports --limit (default 20, max 100) and --cursor. Each response item includes a cursor field; pass the last item's cursor as --cursor on the next call to page forward.

Leaderboard:

  • Missing chain → call onchainos leaderboard supported-chains to confirm support; default to solana if user doesn't specify
  • --time-frame and --sort-by are required by the CLI but the agent should infer them from user language before asking — use the mappings below. Only prompt the user if intent is genuinely ambiguous.
  • Missing --time-frame → map "today/1D" → 1, "3 days/3D" → 2, "7 days/1W/7D" → 3, "1 month/30D" → 4, "3 months/3M" → 5
  • Missing --sort-by → map "PnL" → 1, "win rate" → 2, "transaction count" → 3, "volume" → 4, "ROI" → 5
  • --wallet-type is single-select only (one value at a time: sniper, dev, fresh, pump, smartMoney, influencer) — do NOT pass comma-separated values or it will error; if omitted, all types are returned

Step 2: Call and Display

Address Tracker:

  • Present as a transaction feed table: time, wallet address (truncated), token symbol, trade direction (Buy/Sell), amount USD, price, realized PnL
  • Translate tradeType: 1 → "Buy", 2 → "Sell"

Signal:

  • Present signals in a readable table: token symbol, wallet type, amount USD, trigger wallet count, price at signal time
  • Translate walletType values: "1" → "Smart Money", "2" → "KOL/Influencer", "3" → "Whale"
  • Show soldRatioPercent — lower means the wallet is still holding (bullish signal)

Leaderboard:

  • Returns at most 20 entries per request
  • Present as a ranked table: rank, wallet address (truncated), PnL, win rate, tx count, volume
  • Translate field names — never dump raw JSON keys to the user

Data Freshness

requestTime Field

When a response includes a requestTime field (Unix milliseconds), display it alongside results so the user knows when the snapshot was taken. When chaining commands (e.g., showing trade details after a signal), use the requestTime from the most recent response as the reference point for any time-based parameters.

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.