← Back to Skills Marketplace
patches429

Market Monitor

by Parker · GitHub ↗ · v0.1.0
cross-platform ⚠ suspicious
902
Downloads
0
Stars
14
Active Installs
1
Versions
Install in OpenClaw
/install market-monitor
Description
Monitor cryptocurrency and financial markets via exchange APIs (Binance, OKX). Track prices, analyze trends, and generate market reports.
README (SKILL.md)

Skill: market-monitor(接口定义)

接口层:定义触发条件、分析框架、输出规范和错误策略,与具体交易所无关。 各交易所的 API 端点和请求格式见 impl/ 目录:

  • impl/binance.md — Binance 实现
  • impl/okx.md — OKX 实现

新增交易所时,只需添加对应 impl/{exchange}.md,本文件无需修改。

概述

实时监控加密货币市场数据,计算技术指标,生成交易信号。

触发条件

  • 用户询问行情或价格
  • 定时轮询(可配置间隔)
  • 价格触及预设警报线

输入参数

参数 类型 必填 说明
pair string 交易对,格式 BASE/QUOTE(如 BTC/USDT)
exchange string 目标交易所 id(见 impl/ 目录),默认 binance
interval string K 线周期(1m / 5m / 15m / 1h / 4h / 1d),默认 1h
limit number K 线数量,默认 100

执行流程

1. 根据 exchange 参数加载对应 impl/{exchange}.md
2. 调用实现层获取 24h 行情和 K 线数据
3. 基于 K 线数据计算技术指标
4. 按信号规则生成交易信号
5. 返回标准输出格式

技术指标(与交易所无关)

  • 移动平均线:MA7、MA25、MA99
  • RSI(周期 14)
  • MACD(12, 26, 9)
  • 布林带(20, 2)
  • 成交量分析

信号生成规则

信号 触发条件
strong_buy RSI \x3C 30 且 MACD 金叉 且 价格触及布林下轨
buy RSI \x3C 40 且 MA7 上穿 MA25
neutral 30 ≤ RSI ≤ 70 且无明确趋势
sell RSI > 60 且 MA7 下穿 MA25
strong_sell RSI > 70 且 MACD 死叉 且 价格触及布林上轨

输出格式

{
  "pair": "BTC/USDT",
  "exchange": "binance",
  "interval": "1h",
  "timestamp": "ISO8601",
  "price": 0.0,
  "change24h": 0.0,
  "volume24h": 0.0,
  "indicators": {
    "rsi14": 0.0,
    "macd": { "line": 0.0, "signal": 0.0, "histogram": 0.0 },
    "ma": { "ma7": 0.0, "ma25": 0.0, "ma99": 0.0 },
    "bollinger": { "upper": 0.0, "mid": 0.0, "lower": 0.0 }
  },
  "signal": "strong_buy | buy | neutral | sell | strong_sell",
  "confidence": 0.0,
  "keyLevels": { "support": [], "resistance": [] }
}

错误处理策略

错误类型 处理方式
限流(429) 等待 60s 后重试,最多 3 次
无效参数(400) 提示用户修正交易对或参数
服务不可用(5xx) 告知用户稍后重试
网络超时 记录错误,告知用户

安全约束

  • 只读操作,不触发任何下单
  • 只访问 impl/ 中定义的白名单域名
  • 所有 API 调用由网关记录到审计日志
Usage Guidance
Do not provide production API keys until the credential usage is clarified. Ask the publisher why BINANCE_API_KEY is required for read-only market endpoints and why OKX credentials are absent from the declared env list. If you test, use a key with minimal permissions (read-only, no trading/withdrawal rights) or a throwaway key, and rotate it after testing. Prefer requiring no key for public endpoints; if private endpoints are needed, the skill metadata should list all required env vars (OKX_API_KEY, OKX_API_SECRET, OKX_PASSPHRASE) and explain when/why they're used. Confirm the skill's audit/logging claims and consider running it in a restricted environment first.
Capability Analysis
Type: OpenClaw Skill Name: market-monitor Version: 0.1.0 The market-monitor skill is a standard financial analysis tool designed to fetch and analyze cryptocurrency data from Binance and OKX APIs. The implementation files (SKILL.md, binance.md, okx.md) define clear, read-only logic for calculating technical indicators like RSI and MACD without any evidence of malicious intent, data exfiltration, or unauthorized command execution.
Capability Assessment
Purpose & Capability
The skill claims read-only market monitoring. However the skill metadata requires BINANCE_API_KEY as the primary credential even though the documented Binance endpoints are public and do not require an API key for market data. Additionally, the OKX implementation documents require OKX_API_KEY / OKX_API_SECRET / OKX_PASSPHRASE, but those environment variables are not declared in the skill's metadata. Requiring BINANCE_API_KEY while omitting OKX credentials is inconsistent with the described multi-exchange scope.
Instruction Scope
SKILL.md confines operations to loading impl/{exchange}.md and calling market endpoints (no trading). It also mentions timed polling and configurable intervals — autonomous agents could use that to periodically query exchanges. The impl files list only exchange API domains as whitelist. The main scope is appropriate, but the instructions rely on per-exchange env vars that are not consistently declared (see OKX missing). The skill asserts audit logging and a whitelist, but as an instruction-only bundle there is no enforceable runtime code to guarantee those constraints.
Install Mechanism
This is an instruction-only skill with no install spec and no code files to write to disk, which is the lowest install risk.
Credentials
Declaring BINANCE_API_KEY as required is disproportionate for public market data endpoints; requesting a single primary credential while impl/okx.md documents additional OKX credentials is inconsistent. The skill asks for a credential named like a secret (BINANCE_API_KEY) without justifying its need for read-only operations, which increases the risk that users will provide a high-privilege key unnecessarily.
Persistence & Privilege
The skill does not request persistent 'always' inclusion or system-wide changes. Autonomous invocation is allowed (platform default) and the skill documents scheduled polling, which is expected for a monitor, but does not by itself imply elevated privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install market-monitor
  3. After installation, invoke the skill by name or use /market-monitor
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release of market-monitor. - Provides real-time monitoring of cryptocurrency market data via exchange APIs (Binance, OKX). - Supports user-triggered queries, scheduled polling, and price alert triggers. - Calculates key technical indicators: MA7/25/99, RSI(14), MACD(12,26,9), Bollinger Bands, and volume analysis. - Generates trading signals (strong_buy, buy, neutral, sell, strong_sell) based on indicator rules. - Standardized JSON output includes price, 24h change, indicators, signal, confidence, and key levels. - Implements robust error handling for rate limits, invalid parameters, and service issues. - Enforces security: read-only operations, access-restricted domains, and auditing of all API calls.
Metadata
Slug market-monitor
Version 0.1.0
License
All-time Installs 15
Active Installs 14
Total Versions 1
Frequently Asked Questions

What is Market Monitor?

Monitor cryptocurrency and financial markets via exchange APIs (Binance, OKX). Track prices, analyze trends, and generate market reports. It is an AI Agent Skill for Claude Code / OpenClaw, with 902 downloads so far.

How do I install Market Monitor?

Run "/install market-monitor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Market Monitor free?

Yes, Market Monitor is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Market Monitor support?

Market Monitor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Market Monitor?

It is built and maintained by Parker (@patches429); the current version is v0.1.0.

💬 Comments