Upbit Market Data Skill

A CLI-based OpenClaw skill that fetches quotation/market data from the Upbit Open API.

This skill is designed to be executed via OpenClaw exec (run-once). It supports:

• Trading pair (market) list
• Candles (second/minute/day/week/month/year)
• Recent trades
• Tickers (by trading pairs / by quote currency)
• Orderbooks
• Watchlist tickers (from config)

All responses are JSON:

• Success → stdout: { "ok": true, "result": ... }
• Error → stderr: { "ok": false, "error": { ... } } and exit code 1

Requirements

• Node.js 18+ (uses built-in fetch)
• NPM

Installation

npm install

Configuration (JSON)

Create config/config.json.

Example:

{
  "upbit": {
    "baseUrl": "https://api.upbit.com",
    "accessKey": "",
    "secretKey": ""
  },
  "watchlist": ["KRW-BTC", "KRW-ETH", "KRW-SOL"]
}

Config path override

Default path:

• config/config.json

Override at runtime:

node skill.js tickers --markets=KRW-BTC --config=./config/config.json

CLI Grammar

General format:

node skill.js <command> [subcommand] [--option=value]

Rules:

1. <command> is required.
2. [subcommand] is optional and MUST NOT start with --.
3. Options must be provided as --key=value or --key value.
4. Outputs are always JSON.

STRICT MODE (Recommended for OpenClaw)

OpenClaw/LLM agents may reorder arguments when generating CLI calls. To prevent confusion, enable strict mode.

Enable strict mode

Add --strict=true to the command:

node skill.js tickers --markets=KRW-BTC,KRW-ETH --strict=true

Strict mode rules (hard requirements)

When --strict=true:

1. Candle type MUST appear immediately after candles:
   • ✅ node skill.js candles minutes --market=KRW-ETH --unit=5 --strict=true
   • ❌ node skill.js candles --market=KRW-ETH minutes --unit=5 --strict=true
2. Candle type MUST NOT be passed as an option (do not use --type= in strict mode).
3. For non-candles commands, subcommand must be omitted.
4. Any unexpected positional arguments (extra words not starting with --) will cause an error.

Why strict mode helps:

• It forces a single canonical command shape, making it far harder for OpenClaw/LLM to generate ambiguous or reordered invocations.

Commands

1) List trading pairs (markets)

node skill.js pairs --details=true --strict=true

2) Candles (CRITICAL STRUCTURE)

Candles require a candle type immediately after candles.

Canonical structure

node skill.js candles <type> --market=<MARKET> [options]

Where <type> MUST be one of:

• seconds
• minutes
• days
• weeks
• months
• years

⚠️ <type> is NOT passed as --unit.
⚠️ <type> must appear immediately after candles.

Minutes candles (5-minute example)

node skill.js candles minutes --market=KRW-ETH --unit=5 --count=100 --strict=true