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.

referencesmarket-troubleshooting.md

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

Capability: Market — Troubleshooting

Error handling, edge cases, and region restrictions for the Market capability. Load operational flow and parameter schemas separately through the top-level conditional-reference table.

Region Restrictions (IP Blocking)

Some services are geo-restricted. When a command fails with error code 50125 or 80001, return a friendly message without exposing the raw error code:

Service Restricted Regions Blocking Method
DEX United Kingdom API key auth
DeFi Hong Kong API key auth + backend
Wallet None None
Global Sanctioned countries Gateway (403)

Error handling: When the CLI returns error 50125 or 80001, display:

{service_name} is not available in your region. Please switch to a supported region and try again.

Examples:

  • "DEX is not available in your region. Please switch to a supported region and try again."
  • "DeFi is not available in your region. Please switch to a supported region and try again."

Do not expose raw error codes or internal error messages to the user.

Edge Cases

  • Invalid token address: returns empty data or error — prompt user to verify, or use onchainos token search to resolve
  • Unsupported chain: the CLI will report an error — try a different chain name
  • No candle data: may be a new token or low liquidity — inform user
  • Solana SOL price/kline: The native SOL address (11111111111111111111111111111111) does not work for market price or market kline. Use the wSOL SPL token address (So11111111111111111111111111111111111111112) instead. Note: for swap operations, the native address must be used — see okx-agentic-wallet.
  • Unsupported chain for portfolio PnL: not all chains support PnL — always verify with onchainos market portfolio-supported-chains first
  • portfolio-dex-history requires --begin and --end: both timestamps (Unix milliseconds) are mandatory; if the user says "last 30 days" compute them before calling
  • portfolio-recent-pnl unrealizedPnlUsd returns SELL_ALL: this means the address has sold all its holdings of that token
  • portfolio-token-pnl isPnlSupported = false: PnL calculation is not supported for this token/chain combination
  • Network error: retry once, then prompt user to try again later

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.