fund-api

支持基金净值查询、历史净值和基金搜索的 TypeScript 基金数据工具。

English | 简体中文

fund-api 是一个零运行时依赖的基金行情工具，支持 Node.js、浏览器、CLI 和 MCP。默认使用 funds.auto，自动从可用数据源获取基金数据。

支持使用方式

特性

• Node.js / Browser bundler API + TypeScript 类型
• CLI 查询基金净值、历史净值和搜索基金
• MCP tools 给 AI 客户端直接调用基金接口
• 默认自动数据源：funds.auto
• 指定数据源：funds.tencent
• 支持基金代码格式，例如 110022
• 零运行时依赖

Node.js

安装

Node.js 环境要求 >=18。

npm install fund-api

使用

import { funds } from "fund-api";

const fund = await funds.auto.getFund("110022");
const list = await funds.auto.getFunds(["110022", "000001"]);
const history = await funds.auto.getNavHistory("110022");
const results = await funds.auto.searchFunds("易方达消费");

浏览器

引用

<script src="https://cdn.jsdelivr.net/npm/fund-api/dist/browser/fund-api.iife.min.js"></script>

使用

<script>
  FundApi.funds.auto.getFund("110022").then(console.log);
  FundApi.funds.auto.getFunds(["110022", "000001"]).then(console.log);
  FundApi.funds.auto.getNavHistory("110022").then(console.log);
  FundApi.funds.auto.searchFunds("易方达消费").then(console.log);
</script>

浏览器示例：GitHub Pages

CLI

npx fund-api get-fund 110022
npx fund-api get-funds 110022 000001
npx fund-api get-nav-history 110022
npx fund-api search-funds 易方达消费

MCP

把 fund-api 接到支持 MCP 的 AI 客户端：

{
  "mcpServers": {
    "fund-api": {
      "command": "npx",
      "args": ["-y", "fund-api", "mcp"]
    }
  }
}

内置工具：get_fund、get_funds、get_nav_history、search_funds。

数据源

内置腾讯基金数据源，默认由 funds.auto 自动处理。

数据源	用法	能力
自动	funds.auto	单只基金、批量基金、历史净值、搜索
腾讯	funds.tencent	单只基金、批量基金、历史净值、搜索

文档

文档	内容
API 使用	TypeScript API、数据结构、浏览器使用
CLI 使用	命令、参数、输出
MCP 使用	MCP 客户端配置和工具列表
项目架构	目录结构、provider 工厂、解析和错误模型
开发指南	本地开发、测试、发布前检查、新增数据源
API 监控	定时检查第三方数据源并更新状态徽章

免责声明

fund-api 使用第三方公开基金接口作为数据来源，不保证数据的准确性、完整性、实时性或持续可用性。本项目不提供投资建议，任何交易或投资决策都应由你自行判断。商业、高频或生产使用前，请自行确认第三方数据源的服务条款、授权范围和合规要求。

License

MIT