Okx Cex Market

OKX Market Data

Use the OKX CLI on Zo for read-only market data and technical indicator queries.

Preflight

Before running any OKX command in this session, follow ../_shared/preflight.md. Use metadata.version from this file as the comparison version for drift checks.

What Zo Uses

• Terminal for okx market ... commands

Prerequisites

• OKX CLI installed:

npm install -g @okx_ai/okx-trade-cli

• Verify:

okx market ticker BTC-USDT

No API credentials are required for this skill.

Read-Only Rule

All commands in this skill are read-only. No confirmation is needed unless the requested historical pull is unusually large.

Common Commands

okx market ticker BTC-USDT
okx market orderbook BTC-USDT --sz 20
okx market candles BTC-USDT --bar 1H --limit 100
okx market funding-rate BTC-USDT-SWAP
okx market open-interest --instType SWAP --instId BTC-USDT-SWAP
okx market instruments --instType SPOT

Reference Files

Load the matching reference file before running less-obvious commands or multi-step workflows:

• price, candles, order book, trades: references/price-data-commands.md
• indicators: references/indicator-commands.md
• funding, mark price, open interest, price limits, index data: references/derivatives-commands.md
• instrument discovery and non-crypto categories: references/instrument-commands.md
• cross-skill workflows and MCP mappings: references/workflows.md

Workflow

1. Identify whether the user wants:

• spot price / ticker
• candles / OHLCV
• order book / recent trades
• funding, mark price, open interest
• instrument discovery
• indicators

2. If the user wants indicators, verify the subcommand exists before using any indicator reference:

okx market --help

Only continue with indicator commands if indicator appears in the available market subcommands. If it does not, stop and tell the user that this installed OKX CLI build does not expose indicator commands yet.

3. Run the minimal command that answers the question.

4. Summarize the result in chat rather than dumping raw terminal output unless the user asked for raw output.

Historical Pull Guardrail

Before large candle pulls with pagination or broad ranges, estimate the number of candles. If the request will produce more than roughly 500 rows, tell the user the estimate and ask before continuing.

Failure Handling

• If the CLI is missing, install and verify it.
• If an instrument is invalid, discover valid instruments first.
• If the requested market is ambiguous, clarify the instrument ID before running multiple commands.

Safety Notes

• This skill must not be used for balance, portfolio, or trading actions.
• Use okx-cex-portfolio for account state.
• Use okx-cex-trade for execution.

Related Skills

• okx-cex-portfolio
• okx-cex-trade