Alltick Agent

实时金融市场数据 API，为 LLM 提供股票、外汇、加密货币等实时行情。

特性

• 支持多种交易品种：加密货币、股票（美股/港股/A股）、外汇、贵金属
• REST API 封装：K线、成交价、订单簿查询
• WebSocket 实时行情订阅
• MCP Server：LLM 可直接调用的工具接口
• CLI 工具：命令行快速查询

安装

npm install alltick-agent
# 或
pnpm add alltick-agent

快速开始

Node.js API

import { AlltickHttpClient, DEMO_TOKEN } from 'alltick-agent';

const client = new AlltickHttpClient({ token: DEMO_TOKEN });

// 获取K线数据
const response = await client.getKline({
  code: 'BTCUSDT',
  klineType: 1,  // 1分钟K线
  queryKlineNum: 10,
});

console.log(response.data?.klines);

WebSocket 实时行情

import { AlltickWsClient, WsSubscribeType } from 'alltick-agent';

const ws = new AlltickWsClient({ token: DEMO_TOKEN });

ws.on('push', (data) => {
  console.log('实时数据:', data);
});

ws.on('connected', () => console.log('已连接'));
ws.on('authenticated', async () => {
  await ws.subscribe(['BTCUSDT', 'ETHUSDT'], WsSubscribeType.TRADE);
});

await ws.connect();

MCP Server

import { AlltickMcpServer } from 'alltick-agent';

const mcp = new AlltickMcpServer({ token: DEMO_TOKEN });

// 获取工具定义
const tools = mcp.getTools();

// 调用工具
const result = await mcp.callTool({
  name: 'get_trade',
  arguments: { code: 'BTCUSDT' },
});

CLI 工具

# 查询最新成交
alltick -s BTCUSDT

# 查询K线
alltick -s BTCUSDT -k 1h -n 50

# 实时订阅
alltick -s BTCUSDT -r

API 文档

支持的交易品种

类型	代码示例
加密货币	BTCUSDT, ETHUSDT, BNBUSDT
美股	AAPL.US, TSLA.US, NVDA.US
港股	00700.HK, 09988.HK
A股	600519.SH, 300750.SZ
外汇	EURUSD, GBPUSD, USDJPY
贵金属	XAUUSD (黄金), XAGUSD (白银)

K线类型

类型	代码
1分钟	1
5分钟	5
15分钟	15
30分钟	30
1小时	60
4小时	240
日K	1000
周K	2000
月K	3000

HTTP API 方法

• getKline(params) - 获取K线数据
• getTrade(params) - 获取最新成交价
• getOrderBook(params) - 获取订单簿
• batchGetKline(codes, klineType, num) - 批量获取K线

WebSocket 事件

• connected - 连接成功
• authenticated - 认证成功
• push - 收到推送数据
• error - 错误
• disconnected - 连接断开
• reconnecting - 正在重连

MCP 工具

工具名	描述	参数
get_kline	获取K线数据	code, kline_type, num
get_trade	获取最新成交价	code
get_orderbook	获取订单簿	code
get_batch_kline	批量获取K线	codes, kline_type, num
list_symbols	列出支持的品种	category

类型定义

import type {
  AlltickConfig,
  KlineQuery,
  KlineType,
  TradeQuote,
  OrderBook,
  WsSubscribeType,
} from 'alltick-agent';

开发

# 安装依赖
pnpm install

# 开发模式（监听变化）
pnpm dev

# 类型检查
pnpm typecheck

# 运行测试
pnpm test

# 构建
pnpm build

# 运行测试（监听模式）
pnpm test:watch

License

MIT