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-cli-reference.md

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

Onchain OS DEX Market — CLI Command Reference

Detailed parameter tables, return field schemas, and usage examples for all 9 market commands.

1. onchainos market price

Get single token price.

onchainos market price --address <address> [--chain <chain>]
Param Required Default Description
--address Yes - Token contract address
--chain No ethereum Chain name (e.g., ethereum, solana, xlayer)

Return fields:

Field Type Description
chainIndex String Chain identifier
tokenContractAddress String Token contract address
time String Timestamp (Unix milliseconds)
price String Current price in USD

2. onchainos market prices

Batch price query for multiple tokens.

onchainos market prices --tokens <tokens> [--chain <chain>]
Param Required Default Description
--tokens Yes - Comma-separated tokens. Format: chainIndex:address pairs (e.g., "1:0xeee...,501:So111...") or plain addresses with --chain
--chain No ethereum Default chain for tokens without explicit chainIndex prefix

Return fields (per token):

Field Type Description
chainIndex String Chain identifier
tokenContractAddress String Token contract address
time String Timestamp (Unix milliseconds)
price String Current price in USD

3. onchainos market kline

Get K-line / candlestick data.

onchainos market kline --address <address> [--bar <bar>] [--limit <n>] [--chain <chain>]
Param Required Default Description
--address Yes - Token contract address
--bar No 1H Bar size: 1s, 1m, 5m, 15m, 30m, 1H, 4H, 1D, 1W, etc.
--limit No 100 Number of data points (max 299)
--chain No ethereum Chain name

Return fields: Each data point is now a named JSON object (transformed from the API's raw array [ts,o,h,l,c,vol,volUsd,confirm]):

Field Type Description
ts String Opening time (Unix milliseconds)
o String Open price
h String Highest price
l String Lowest price
c String Close price
vol String Trading volume (base currency unit)
volUsd String Trading volume (USD)
confirm String "0" = uncompleted candle, "1" = completed candle

4. onchainos market index

Get index price (aggregated from multiple sources).

onchainos market index --address <address> [--chain <chain>]
Param Required Default Description
--address Yes - Token contract address (empty string "" for native token)
--chain No ethereum Chain name

Return fields:

Field Type Description
chainIndex String Chain identifier
tokenContractAddress String Token contract address
price String Index price (aggregated from multiple sources)
time String Timestamp (Unix milliseconds)

5. onchainos market portfolio-supported-chains

Get the list of chains supported by the portfolio PnL endpoints.

onchainos market portfolio-supported-chains

No parameters required.

Return fields:

Field Type Description
chainIndex String Unique identifier of the chain
chainName String Chain name
chainLogo String Chain logo URL

6. onchainos market portfolio-overview

Get wallet portfolio PnL overview: realized/unrealized PnL, win rate, Top 3 tokens, buy/sell stats.

onchainos market portfolio-overview --address <address> --chain <chain> --time-frame <n>
Param Required Default Description
--address Yes - Wallet address
--chain Yes - Chain name or ID (e.g. ethereum, solana)
--time-frame No 4 Statistical range: 1=1D, 2=3D, 3=7D, 4=1M, 5=3M

Return fields:

Field Type Description
realizedPnlUsd String Realized PnL (USD)
top3PnlTokenSumUsd String Total PnL of Top 3 tokens (USD)
top3PnlTokenPercent String Top 3 tokens PnL percentage
topPnlTokenList Array Top 3 PnL token list
topPnlTokenList[].tokenContractAddress String Token contract address
topPnlTokenList[].tokenSymbol String Token symbol
topPnlTokenList[].tokenPnLUsd String Token PnL (USD)
topPnlTokenList[].tokenPnLPercent String Token PnL percentage
winRate String Win rate
tokenCountByPnlPercent Object Token count grouped by PnL range
tokenCountByPnlPercent.over500Percent String Tokens with PnL > 500%
tokenCountByPnlPercent.zeroTo500Percent String Tokens with PnL 0%–500%
tokenCountByPnlPercent.zeroToMinus50Percent String Tokens with PnL -50%–0%
tokenCountByPnlPercent.overMinus50Percent String Tokens with PnL < -50%
buyTxCount String Number of buy transactions
buyTxVolume String Buy transaction volume (USD)
sellTxCount String Number of sell transactions
sellTxVolume String Sell transaction volume (USD)
avgBuyValueUsd String Average buy value (USD)
preferredMarketCap String Preferred market cap range
buysByMarketCap Array Buy counts grouped by market cap range
buysByMarketCap[].marketCapRange String Market cap range label
buysByMarketCap[].buyCount String Buy count in that range

7. onchainos market portfolio-dex-history

Get DEX transaction history for a wallet in reverse chronological order (up to 1000 records, 100 per request).

onchainos market portfolio-dex-history --address <address> --chain <chain> (--since <window> | --begin <ms> --end <ms>) [options]

This command needs a time window: supply either --since (relative) or --begin + --end (absolute). Supplying neither, or --since together with --begin/--end, returns a structured invalid_input error.

Param Required Default Description
--address Yes - Wallet address
--chain Yes - Chain name or ID
--since Conditional - Relative window (grammar <int><s|m|h|d>, e.g. 30m, 24h, 7d); the CLI computes the range and returns data.resolvedWindow {begin,end}. Required when --begin/--end are omitted; mutually exclusive with them.
--begin Conditional - Start timestamp (Unix milliseconds). Required together with --end when --since is omitted; mutually exclusive with --since.
--end Conditional - End timestamp (Unix milliseconds). Required together with --begin when --since is omitted; mutually exclusive with --since.
--limit No 20 Records per page (max 100)
--cursor No - Pagination cursor from previous response
--token No - Filter by token contract address
--tx-type No - Transaction type: 1=BUY, 2=SELL, 3=Transfer In, 4=Transfer Out (comma-separated)

Return fields:

Field Type Description
transactionList Array List of transactions
transactionList[].type String Transaction type (1=BUY, 2=SELL, 3=Transfer In, 4=Transfer Out)
transactionList[].chainIndex String Chain identifier
transactionList[].tokenContractAddress String Token contract address
transactionList[].tokenSymbol String Token symbol
transactionList[].valueUsd String Transaction value (USD)
transactionList[].amount String Token amount
transactionList[].price String Transaction price
transactionList[].marketCap String Market cap at time of tx
transactionList[].pnlUsd String PnL (USD)
transactionList[].time String Transaction timestamp (milliseconds)
cursor String Pagination cursor for next page

8. onchainos market portfolio-recent-pnl

Get recent PnL list for a wallet in reverse chronological order (up to 1000 records, 100 per request).

onchainos market portfolio-recent-pnl --address <address> --chain <chain> [options]
Param Required Default Description
--address Yes - Wallet address
--chain Yes - Chain name or ID
--limit No 20 Records per page (max 100)
--cursor No - Pagination cursor from previous response

Return fields:

Field Type Description
pnlList Array PnL record list
pnlList[].chainIndex String Chain identifier
pnlList[].tokenContractAddress String Token contract address
pnlList[].tokenSymbol String Token symbol
pnlList[].lastActiveTimestamp String Last active timestamp (milliseconds)
pnlList[].unrealizedPnlUsd String Unrealized PnL (USD); SELL_ALL if all sold
pnlList[].unrealizedPnlPercent String Unrealized PnL percentage
pnlList[].realizedPnlUsd String Realized PnL (USD)
pnlList[].realizedPnlPercent String Realized PnL percentage
pnlList[].totalPnlUsd String Total PnL (USD)
pnlList[].totalPnlPercent String Total PnL percentage
pnlList[].tokenBalanceUsd String Token balance value (USD)
pnlList[].tokenBalanceAmount String Token balance amount
pnlList[].tokenPositionPercent String Token position percentage
pnlList[].tokenPositionDuration.holdingTimestamp String Holding start timestamp (milliseconds)
pnlList[].tokenPositionDuration.sellOffTimestamp String Sell-off timestamp; empty if still holding
pnlList[].buyTxCount String Number of buy transactions
pnlList[].buyTxVolume String Buy transaction volume
pnlList[].buyAvgPrice String Average buy price
pnlList[].sellTxCount String Number of sell transactions
pnlList[].sellTxVolume String Sell transaction volume
pnlList[].sellAvgPrice String Average sell price

9. onchainos market portfolio-token-pnl

Get the latest PnL snapshot for a specific token in a wallet.

onchainos market portfolio-token-pnl --address <address> --chain <chain> --token <token>
Param Required Default Description
--address Yes - Wallet address
--chain Yes - Chain name or ID
--token Yes - Token contract address

Return fields:

Field Type Description
totalPnlUsd String Total PnL (USD)
totalPnlPercent String Total PnL percentage
unrealizedPnlUsd String Unrealized PnL (USD)
unrealizedPnlPercent String Unrealized PnL percentage
realizedPnlUsd String Realized PnL (USD)
realizedPnlPercent String Realized PnL percentage
isPnlSupported Boolean Whether PnL calculation is supported for this token

Input / Output Examples

User says: "Check the current price of OKB on XLayer"

onchainos market price --address 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee --chain xlayer
# -> Display: OKB current price $XX.XX

User says: "Show me hourly candles for USDC on XLayer"

onchainos market kline --address 0x74b7f16337b8972027f6196a17a631ac6de26d22 --chain xlayer --bar 1H
# -> Display candlestick data (open/high/low/close/volume)

User says: "How is my Ethereum wallet performing this week?"

onchainos market portfolio-supported-chains   # confirm Ethereum supported
onchainos market portfolio-overview --address <wallet> --chain ethereum --time-frame 3
# -> Display 7D PnL overview: realized PnL, win rate, top 3 tokens

User says: "Show my DEX trade history on Ethereum for the last 30 days"

# relative window (CLI computes begin/end and echoes data.resolvedWindow)
onchainos market portfolio-dex-history --address <wallet> --chain ethereum --since 30d
# or an absolute window
onchainos market portfolio-dex-history --address <wallet> --chain ethereum \
  --begin <start_ms> --end <end_ms>
# -> Display paginated DEX transaction list

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.