介绍
# Crypto & Stock Market Data Skill (Node.js)
一套用于检索实时和历史加密货币及股票市场数据的综合工具。该技能通过专用的市场数据服务器提供高性能、已验证的全球金融统计数据访问。完全基于 Node.js 标准库构建 — 无需 `npm install`。
## 核心功能
| 类别 | 描述 | | :--- | :--- | | **实时价格** | 获取加密货币和股票的当前估值、市值、24小时交易量及价格变化。 | | **市场发现** | 按市值追踪热门资产及表现最佳的代币。 | | **智能搜索** | 通过搜索名称或符号快速查找代币 ID 或股票代码。 | | **深度详情** | 访问详尽的资产信息，从社区链接到公司概况。 | | **精确图表** | 获取 OHLC K线数据及历史价格/交易量时间序列。 | | **全球指标** | 监控总市值及上市公司国库持仓。 |
## 工具参考
| 脚本名称 | 主要功能 | 命令示例 | | :--- | :--- | :--- | | `get_crypto_price.js` | 多代币价格获取 | `node scripts/get_crypto_price.js bitcoin` | | `get_stock_quote.js` | 实时股票报价 | `node scripts/get_stock_quote.js AAPL MSFT` | | `get_company_profile.js` | 公司概况 | `node scripts/get_company_profile.js AAPL` | | `search_stocks.js` | 查找股票代码 | `node scripts/search_stocks.js apple` | | `get_trending_coins.js` | 24小时热门资产 | `node scripts/get_trending_coins.js` | | `get_top_coins.js` | 市值排行榜 | `node scripts/get_top_coins.js --per_page=20` | | `search_coins.js` | 资产发现 | `node scripts/search_coins.js solana` | | `get_coin_details.js` | 综合元数据 | `node scripts/get_coin_details.js ethereum` | | `get_coin_ohlc_chart.js` | K线数据 | `node scripts/get_coin_ohlc_chart.js bitcoin` | | `get_coin_historical_chart.js` | 时间序列数据 | `node scripts/get_coin_historical_chart.js bitcoin` | | `get_global_market_data.js` | 宏观市场统计 | `node scripts/get_global_market_data.js` | | `get_public_companies_holdings.js` | 国库持仓 | `node scripts/get_public_companies_holdings.js bitcoin` | | `get_supported_currencies.js` | 估值选项 | `node scripts/get_supported_currencies.js` |
---
## 使用详情
### 1. `get_crypto_price.js` 获取一种或多种加密货币的实时定价和基本市场指标。
**语法：** ```bash node scripts/get_crypto_price.js <coin_id_1> [coin_id_2] ... [--currency=usd] ```
**参数：** - `coin_id`：代币的唯一标识符（例如 `bitcoin`、`solana`）。 - `--currency`：估值的目标货币（默认：`usd`）。
**示例：** ```bash node scripts/get_crypto_price.js bitcoin ethereum cardano --currency=jpy ```
---
### 2. `get_top_coins.js` 检索按市值排名的顶级加密货币列表。
**语法：** ```bash node scripts/get_top_coins.js [--currency=usd] [--per_page=10] [--page=1] [--order=market_cap_desc] ```
**参数：** - `--currency`：估值货币（默认：`usd`）。 - `--per_page`：结果数量（1-250，默认：`10`）。 - `--order`：排序逻辑（例如 `market_cap_desc`、`volume_desc`）。
---
### 3. `get_coin_ohlc_chart.js` 获取用于技术分析的开盘、最高、最低、收盘（K线）数据。
**语法：** ```bash node scripts/get_coin_ohlc_chart.js <coin_id> [--currency=usd] [--days=7] ```
**允许的 `days` 值：** `1, 7, 14, 30, 90, 180, 365`。
| 时间范围 | 粒度 | | :--- | :--- | | 1-2 天 | 30 分钟间隔 | | 3-30 天 | 4 小时间隔 | | 31+ 天 | 4 天间隔 |
---
### 4. `get_coin_historical_chart.js` 检索价格、市值和交易量的详细历史时间序列数据。
**语法：** ```bash node scripts/get_coin_historical_chart.js <coin_id> [--currency=usd] [--days=30] ```
---
### 5. `get_stock_quote.js` 获取一个或多个股票代码的实时股票价格。
**语法：** ```bash node scripts/get_stock_quote.js <SYMBOL_1> [SYMBOL_2] ... ```
---
### 6. `get_company_profile.js` 获取综合的公司概况，包括描述、行业和 CEO。
**语法：** ```bash node scripts/get_company_profile.js <SYMBOL> ```
---
## 重要指南
### 加密货币：使用 ID | 股票：使用代码 - **加密货币**：始终使用 **代币 ID**（slug）而非交易符号（例如 `bitcoin`，而非 `BTC`）。 - **股票**：始终使用 **股票代码**（例如 `AAPL`、`Apple`）。
如果您不确定正确的 ID，请使用 `search_coins.js`。
### 身份验证 身份验证由内部的 `api_client.js` **自动**处理。其工作原理如下：
- **端点**：`GET https://api.igent.net/api/token` - **机制**： 1. **自动获取**：首次使用工具时，它会向服务器请求临时会话令牌。 2. **本地存储**：该令牌存储在本地的隐藏 `.token` 文件中，以便在后续请求中重复使用。 3. **自动头部**：客户端会在每个请求中自动包含此令牌，以证明您已获得授权。 4. **自动刷新**：如果令牌过期，客户端会自动获取新令牌，无需您执行任何操作。
无需手动 API 密钥或配置。
### 速率限制 虽然系统稳健，但请避免突发请求（每分钟超过 30 次），以保持所有用户的服务稳定性。
### Agent 集成 此技能与 OpenClaw 以及其他使用 **AgentSkills** 标准的代理完全兼容。直接从 `scripts/` 目录执行脚本。