okx-cex-trade
Use when the user asks to 'buy BTC', 'sell ETH', 'place a limit order', 'place a market order', 'cancel my order', 'amend my order', 'long B
Open source Repository Open in the app JSON README (API)
About
Use when the user asks to 'buy BTC', 'sell ETH', 'place a limit order', 'place a market order', 'cancel my order', 'amend my order', 'long BTC perp', 'short ETH swap', 'open a position', 'close a position', 'set take profit', 'limit take profit', 'immediate TP', 'set stop loss', 'self-trade prevention', 'stpMode', 'auto-cancel on close', 'trailing stop', 'pending order', 'chase order', 'iceberg', 'TWAP', 'split order', 'large order', 'set leverage', 'check my orders', 'fill history', 'buy a call', 'sell a put', 'option chain', 'implied volatility', 'IV', 'Greeks', 'delta', 'gamma', 'event contract', 'buy Yes', 'buy No', 'buy Up', 'buy Down', 'prediction market', or any request to place, cancel, or amend spot, swap, futures, options, or event contract orders on OKX CEX. Covers conditional (TP/SL/trailing) algo orders. Requires API credentials. Do NOT use for market data (okx-cex-market), account balance (okx-cex-portfolio), or bots (okx-cex-bot).
Details
- Kind
- Agent skills
- Topic
- Finance & crypto
- Publisher
- okx
- Origin
- skillssh
- Category
- ferramentas
- Stars
- 171
- Forks
- 28
- Last push
- 2026-09-01T07:50:27Z
- Repository state
- ativo
- Language
- Shell
- License
- MIT
- Added
- 2026-08-30 15:21:20
- Updated
- 2026-09-11 23:02:40
- Origin id
okx/agent-skills/okx-cex-trade
README
# agent-skills
A collection of AI agent skills for OKX exchange operations. Each skill is a self-contained Markdown file with YAML frontmatter that tells an AI agent when to activate and how to execute tasks via the [`okx`](https://www.npmjs.com/package/@okx_ai/okx-trade-cli) CLI.
## Skills
| Skill | Description | Auth Required |
|-------|-------------|:-------------:|
| [`okx-cex-auth`](skills/okx-cex-auth/SKILL.md) | OAuth login / API-key setup, plus install/update/remove of the `okx-auth` helper binary. Activated on first run or whenever a command returns 401 / session expired. | Setup |
| [`okx-cex-market`](skills/okx-cex-market/SKILL.md) | Public market data: prices, tickers, order books, candles, funding rates, open interest, instruments, stock tokens, metals/forex, and 70+ technical indicators (RSI, MACD, EMA, Bollinger, KDJ, SuperTrend, AHR999, BTC rainbow…). | No |
| [`okx-cex-trade`](skills/okx-cex-trade/SKILL.md) | Order management: spot, perpetual swap, dated futures, options, event contracts. TP/SL, trailing stop, iceberg, TWAP, conditional/OCO algo orders. | Yes |
| [`okx-cex-portfolio`](skills/okx-cex-portfolio/SKILL.md) | Account operations: balances, positions, P&L, trading fees, account config, fund transfers, position-mode switching. | Yes |
| [`okx-cex-bot`](skills/okx-cex-bot/SKILL.md) | Grid bots (spot / USDT-margined / coin-margined contract) and DCA Martingale bots (Spot DCA / Contract DCA). Create, amend, stop, monitor, AI-recommended parameters. | Yes |
| [`okx-cex-earn`](skills/okx-cex-earn/SKILL.md) | Simple Earn (flexible / fixed-term / lending), Flash Earn, On-chain Earn (staking / DeFi), Dual Investment (DCD / 双币赢), AutoEarn (自动赚币). | Yes |
| [`okx-cex-smartmoney`](skills/okx-cex-smartmoney/SKILL.md) | Smart-money analytics: leaderboard traders, position tracking, trade records, consensus signals, signal history. | Yes |
| [`okx-sentiment-tracker`](skills/okx-sentiment-tracker/SKILL.md) | Crypto news, coin-level sentiment analysis, trending coins, social buzz, market mood. | Yes |
| [`okx-cex-skill-mp`](skills/okx-cex-skill-mp/SKILL.md) | OKX Skills Marketplace: search, browse, install, update, remove skill packs. | Yes |
## Requirements
- [`okx` CLI](https://www.npmjs.com/package/@okx_ai/okx-trade-cli) installed:
```bash
npm install -g @okx_ai/okx-trade-cli
```
- For authenticated skills, configure credentials by either:
- **OAuth** — run the `okx-cex-auth` skill (recommended for end users)
- **API key** — write `~/.okx/config.toml` directly:
```bash
okx config init
```
## Skill Format
Each skill is a Markdown file with a YAML frontmatter header:
```yaml
---
name: skill-name
description: "Trigger description for the AI agent routing system."
license: MIT
metadata:
author: okx
version: "1.3.3"
homepage: "https://www.okx.com"
agent:
requires:
bins: ["okx"]
install:
- id: npm
kind: node
package: "@okx_ai/okx-trade-cli@1.3.3"
bins: ["okx"]
label: "Install okx CLI (npm)"
---
```
The `description` field drives agent routing — it enumerates natural-language phrases and scenarios that should trigger the skill. Skills with a `references/` subdirectory use `{baseDir}` as a runtime-resolved path pointing to the skill's own directory.
> **Description length limit**: Codex CLI enforces a **1024-character maximum** on this field. Target ≤ 900 characters to leave headroom for future trigger additions.
Skills may share helpers via the top-level [`skills/_shared/`](skills/_shared/) directory (e.g. `preflight.md` for credential / profile checks).
## Usage
Skills are loaded by AI coding agents — Claude Code, Cursor, Windsurf, Codex CLI, and any Skills-Plugin-compatible client — to provide contextual instructions for CLI-based OKX operations. The agent reads the skill document at activation time and follows the command examples and operation flows described within.
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for how to add or improve skills, and [REVIEWING.md](REVIEWING.md) for review criteria.
## Security
Report security issues per [SECURITY.md](SECURITY.md).
## License
MIT — see [LICENSE](LICENSE).