# Send Trading upbit 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "trading-upbit-skill",
    "name": "Trading upbit skill",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/kuns9/trading-upbit-skill",
    "canonicalUrl": "https://clawhub.ai/kuns9/trading-upbit-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/trading-upbit-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=trading-upbit-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      ".gitignore",
      "config.example.json",
      "package.json",
      "README.md",
      "SECURITY.md",
      "skill.js"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "trading-upbit-skill",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-10T04:57:38.022Z",
      "expiresAt": "2026-05-17T04:57:38.022Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=trading-upbit-skill",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=trading-upbit-skill",
        "contentDisposition": "attachment; filename=\"trading-upbit-skill-1.0.14.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "trading-upbit-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/trading-upbit-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/trading-upbit-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/trading-upbit-skill",
    "agentUrl": "https://openagent3.xyz/skills/trading-upbit-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/trading-upbit-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/trading-upbit-skill/agent.md"
  }
}
```
## Documentation

### trading-upbit-skill

Upbit automated trading skill for OpenClaw and local execution.

### What to consider before installing (Security)

This skill implements an automated Upbit trading bot and requires Upbit API keys. Before installing or handing over production keys:

Inspect critical files:

scripts/execution/upbitClient.js (Upbit HTTP client)
scripts/config/index.js (config + secrets loading)
skill.js (CLI entrypoint)



Run in dry-run mode first:

Set execution.dryRun=true
Run node skill.js smoke_test, node skill.js monitor_once, node skill.js worker_once



Use the platform secret store:

Provide keys via environment variables (OpenClaw Skills Config / secret store):

UPBIT_OPEN_API_ACCESS_KEY
UPBIT_OPEN_API_SECRET_KEY


Avoid storing secrets in config.json.



Limit key permissions during testing:

Use minimal funds / a test account where possible.
Monitor your Upbit account activity closely.



Quick self-check:

Run node skill.js security_check to scan the repository for hard-coded external URLs (allowlist: api.upbit.com).

Security notes:

This skill does not include telemetry and does not upload data by design.
The Upbit API base URL is allowlisted to https://api.upbit.com/v1 and redirects are disabled.

### What it does

Monitors markets (watchlist + optional TopVolume)
Generates BUY/SELL events in resources/events.json
Processes events in a worker (places orders or dry-run), and persists positions in resources/positions.json
Designed for cron: monitor_once and worker_once are run-once commands

### monitor_once

Run one monitoring cycle, enqueue events.

node skill.js monitor_once

### worker_once

Process pending events (BUY/SELL), update positions.

node skill.js worker_once

### smoke_test

Validate config and public endpoints (no trading).

node skill.js smoke_test

### Budget Policy (v13)

Order sizing can be set to a percentage of available KRW, split equally across multiple buys in the same worker run.

{
  "trading": {
    "budgetPolicy": {
      "mode": "balance_pct_split",
      "pct": 0.3,
      "reserveKRW": 0,
      "minOrderKRW": 5000,
      "roundToKRW": 1000
    }
  }
}

Behavior:

totalBudget = floor((availableKRW - reserveKRW) * pct)
if there are N BUY_SIGNALs pending, perOrderKRW = floor(totalBudget / N) rounded down to roundToKRW

### Cron (recommended)

Monitor (every 5 minutes):

cd <skillRoot> && node skill.js monitor_once

Worker (every 1 minute):

cd <skillRoot> && node skill.js worker_once

### Files

Required:

config.json (do not commit)

Auto-created:

resources/events.json
resources/positions.json
resources/topVolumeCache.json
resources/nearCounter.json
resources/heartbeat.json

Testing utilities:

scripts/tests/* (see README_TESTING.md)
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: kuns9
- Version: 1.0.14
## 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-10T04:57:38.022Z
- Expires at: 2026-05-17T04:57:38.022Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/trading-upbit-skill)
- [Send to Agent page](https://openagent3.xyz/skills/trading-upbit-skill/agent)
- [JSON manifest](https://openagent3.xyz/skills/trading-upbit-skill/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/trading-upbit-skill/agent.md)
- [Download page](https://openagent3.xyz/downloads/trading-upbit-skill)