加密市场情报

面向加密货币、股票及宏观指标的实时市场数据管道。无需任何 API 密钥，所有数据均来自免费公开 API。

适用场景

当您需要以下信息时，可调用该技能：

• 当前加密货币价格与市值
• 比特币/以太坊主导率（BTC/Eth Dominance）
• 恐惧与贪婪指数（Fear & Greed Index）
• 热门币种（Trending coins）
• 去中心化金融总锁仓价值（DeFi TVL）
• 股市指数（S&P 500、Nasdaq、Dow、VIX）
• AI 相关股票价格（NVDA、AMD、MSFT 等）
• 宏观指标（DXY 美元指数、10 年期美债收益率）
• 用于交易分析的预获取数据
• 辅助投资组合决策的市场情报

快速开始

获取全部市场数据：

cd ~/.openclaw/skills/crypto-market-intel/scripts
python3 market-data-fetcher.py all --output ~/market-data

分析市场状况：

./analyze-market.sh

核心功能

✅ 集成 6 个免费 API，零密钥管理

• CoinGecko（币种、全球指标、热门榜单）
• Alternative.me（恐惧与贪婪指数）
• DeFi Llama（DeFi TVL）
• Yahoo Finance（股票、指数、债券）

✅ 加密货币覆盖范围

• 按市值排名前 30 的币种
• 全球市场指标（总市值、24 小时交易量、主导率）
• 恐惧与贪婪指数（当前值 + 近 7 日历史）
• 热门币种
• DeFi 总锁仓价值（TVL）

✅ 股票与宏观指标

• 主要股指（S&P 500、Nasdaq、Dow、VIX）
• AI 股票（NVDA、AMD、AVGO、MRVL、TSM、ASML、ARM、MSFT、AMZN、GOOG、META、ORCL）
• AI 能源股（VST、CEG、OKLO、SMR、TLN）
• AI 基础设施股（VRT、ANET、CRDO）
• 美元指数（DXY）
• 10 年期美债收益率

✅ 面向 Agent 的输出格式

• JSON 格式，便于解析
• 结构化数据并附带时间戳
• 支持定时任务（cron）或按需触发
• 无幻觉价格 —— 所有数据均为真实市场数据

使用方法

仅获取加密货币数据

python3 scripts/market-data-fetcher.py crypto --output ./data

输出文件：data/crypto-latest.json

仅获取股票/宏观数据

python3 scripts/market-data-fetcher.py stocks --output ./data

输出文件：data/stocks-latest.json

获取全部数据

python3 scripts/market-data-fetcher.py all --output ./data

自动化分析

运行分析器封装脚本，自动获取最新数据并生成结构化市场摘要提示（prompt）：

./scripts/analyze-market.sh ~/market-data

该命令将拉取最新数据，并输出一份供 Agent 分析使用的结构化 prompt，内容包括：

• 市场情绪（恐惧与贪婪指数）
• 涨跌幅前列资产（24 小时最大涨幅/跌幅）
• 宏观环境（DXY、收益率、VIX）
• 值得关注的信号

cron 集成

配置每小时自动获取市场数据：

crontab -e

# 每小时获取一次市场数据
0 * * * * cd ~/.openclaw/skills/crypto-market-intel/scripts && python3 market-data-fetcher.py all --output ~/market-data

Agent 可直接读取已预获取的数据，实现毫秒级即时分析，无需等待 API 请求。

数据结构说明

加密货币输出（crypto-latest.json）

{
  "fetched_at": "2026-03-13T15:45:00Z",
  "source": "coingecko+alternative.me",
  "top_coins": [
    {
      "symbol": "BTC",
      "name": "Bitcoin",
      "price": 68500.0,
      "market_cap": 1340000000000,
      "volume_24h": 28000000000,
      "change_24h_pct": 2.5,
      "change_7d_pct": -1.2,
      "change_1h_pct": 0.3,
      "ath": 69000.0,
      "ath_change_pct": -0.7,
      "rank": 1
    }
  ],
  "global": {
    "total_market_cap_usd": 2400000000000,
    "total_volume_24h_usd": 85000000000,
    "btc_dominance": 55.8,
    "eth_dominance": 17.2,
    "active_cryptocurrencies": 13245,
    "market_cap_change_24h_pct": 1.8
  },
  "fear_greed": [
    {
      "value": 62,
      "label": "Greed",
      "date": "1710346800"
    }
  ],
  "trending": [
    {
      "name": "Solana",
      "symbol": "SOL",
      "rank": 5,
      "score": 0
    }
  ],
  "defi_tvl": {
    "total_tvl": 95800000000,
    "date": 1710288000,
    "change_1d": 2.1
  }
}

股票输出（stocks-latest.json）

{
  "fetched_at": "2026-03-13T15:45:00Z",
  "stocks": {
    "indices": [
      {
        "symbol": "^GSPC",
        "price": 5200.5,
        "prev_close": 5180.0,
        "change_pct": 0.4
      }
    ],
    "ai_chips": [
      {
        "symbol": "NVDA",
        "price": 890.25,
        "prev_close": 885.0,
        "change_pct": 0.59
      }
    ]
  },
  "dxy": {
    "price": 103.45,
    "prev_close": 103.2
  },
  "treasury_10y": {
    "yield": 4.25,
    "prev_close": 4.22
  }
}

速率限制与合理使用规范

建议：将数据拉取频率设为每小时一次，不建议更频繁。虽然所有 API 均免费，但请遵守合理使用原则。

故障排查

问题：数据拉取失败，出现超时错误

解决方案：检查网络连接，数分钟后重试；部分 API 可能存在临时性中断。

问题：Yahoo Finance 对某只股票未返回数据

解决方案：该股票代码可能已被退市或暂不可用。请确认代码准确性（股指需加 ^ 前缀，例如 ^GSPC）。

问题：DeFi TVL 字段为 null

解决方案：DeFi Llama API 可能正在更新中；其历史数据接口偶有延迟。建议稍后重试。

问题：恐惧与贪婪指数返回空值

解决方案：Alternative.me 服务可能暂时不可用。请直接访问 https://alternative.me/crypto/fear-and-greed-index/ 进行验证。

架构说明

• 无需认证 — 所有 API 均为公开接口，无需管理密钥
• 仅依赖 HTTP 请求 — 使用 Python 内置 urllib 模块（无外部依赖）
• 容错设计 — 单一 API 失败不影响其余 API 正常执行
• 高可移植性 — 支持任意安装了 Python 3.7+ 的系统
• 输出路径可配置 — 使用 --output 参数指定数据存储目录

集成示例

Discord 机器人告警

#!/bin/bash
python3 scripts/market-data-fetcher.py crypto --output /tmp
FEAR=$(jq '.fear_greed[0].value' /tmp/crypto-latest.json)
if [ "$FEAR" -lt 25 ]; then
  echo "🚨 极度恐惧：$FEAR — 潜在买入机会"
fi

交易机器人预分析

import json

# 加载预获取数据
with open("~/market-data/crypto-latest.json") as f:
    data = json.load(f)

# 提取涨幅前列币种
top_coins = data["top_coins"]
gainers = sorted(top_coins, key=lambda x: x["change_24h_pct"], reverse=True)[:5]

print("24 小时涨幅前 5 名：")
for coin in gainers:
    print(f"{coin['symbol']}: +{coin['change_24h_pct']:.2f}%")

参考资料

详见 references/api-sources.md，内含各 API 的完整文档、端点地址、响应结构及速率限制详情。

最后更新日期： 2026-03-13