# Send UPBIT market data get skill to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "upbit-market-data-skill",
    "name": "UPBIT market data get skill",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/kuns9/upbit-market-data-skill",
    "canonicalUrl": "https://clawhub.ai/kuns9/upbit-market-data-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/upbit-market-data-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=upbit-market-data-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "package.json",
      "skill.js",
      "SKILL.md",
      "src/config.js",
      "src/utils/args.js",
      "src/upbit/auth.js"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "upbit-market-data-skill",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-10T08:00:40.179Z",
      "expiresAt": "2026-05-17T08:00:40.179Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=upbit-market-data-skill",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=upbit-market-data-skill",
        "contentDisposition": "attachment; filename=\"upbit-market-data-skill-1.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "upbit-market-data-skill"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/upbit-market-data-skill"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/upbit-market-data-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/upbit-market-data-skill",
    "agentUrl": "https://openagent3.xyz/skills/upbit-market-data-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/upbit-market-data-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/upbit-market-data-skill/agent.md"
  }
}
```
## Documentation

### 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:

<command> is required.
[subcommand] is optional and MUST NOT start with --.
Options must be provided as --key=value or --key value.
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:

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


Candle type MUST NOT be passed as an option (do not use --type= in strict mode).
For non-candles commands, subcommand must be omitted.
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.

### 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

Allowed minute units:
1, 3, 5, 10, 15, 30, 60, 240

Other candles

node skill.js candles seconds --market=KRW-BTC --count=200 --strict=true
node skill.js candles days    --market=KRW-BTC --count=50  --strict=true
node skill.js candles weeks   --market=KRW-BTC --count=30  --strict=true
node skill.js candles months  --market=KRW-BTC --count=12  --strict=true
node skill.js candles years   --market=KRW-BTC --count=5   --strict=true

Incorrect examples (DO NOT USE)

# ❌ type passed as option
node skill.js candles --unit=minutes --market=KRW-ETH

# ❌ type after options
node skill.js candles --market=KRW-ETH minutes --unit=5

### 3) Recent trades

node skill.js trades --market=KRW-BTC --count=50 --strict=true

### 4) Tickers by trading pairs

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

### 5) Tickers by quote currency

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

### 6) Orderbooks

node skill.js orderbook --markets=KRW-BTC --level=100000 --count=15 --strict=true

### 7) Watchlist tickers (from config)

node skill.js watchlist --strict=true

### Error handling & rate limits

Upbit may respond with:

429: Too Many Requests
418: Request blocked
400: Bad request

The skill passes Upbit error payloads (when present) under error.upbit.

Reference:
https://docs.upbit.com/kr/reference/rest-api-guide
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: kuns9
- Version: 1.0.2
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-10T08:00:40.179Z
- Expires at: 2026-05-17T08:00:40.179Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/upbit-market-data-skill)
- [Send to Agent page](https://openagent3.xyz/skills/upbit-market-data-skill/agent)
- [JSON manifest](https://openagent3.xyz/skills/upbit-market-data-skill/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/upbit-market-data-skill/agent.md)
- [Download page](https://openagent3.xyz/downloads/upbit-market-data-skill)