帮助中心
关于 GroundAPI 的常见问题和使用指南。找不到答案？请发邮件到 support@wisefuturus.com
快速上手
GroundAPI 是专为 AI Agent 设计的数据接口服务。我们提供 A 股数据、选股、大盘全景、基金、天气、物流、IP 归属、网络搜索、网页抓取、新闻共 14 个接口，支持 REST API 和 MCP 接入。一个 API Key 即可使用所有功能。
注册 GroundAPI 账号后，进入 Dashboard → API Keys → 点击「创建新 Key」。新创建的 Key 只展示一次完整内容，请务必妥善保存。每个账户可以创建多个 Key，分别用于不同环境（开发、测试、生产）。
每个账户每月免费 500 次 API 调用，覆盖所有接口。无需绑定信用卡即可使用免费额度。超出后按量计费：股票/新闻/基金 $0.01/次，搜索/抓取/大盘/板块/选股 $0.02/次。天气、物流、IP 定位目前免费。
目前支持 14 个接口：股票数据 (/v1/finance/stock)、条件选股 (/v1/finance/stock/screen)、大盘全景含板块/基金/宏观 (/v1/finance/market)、基金 (/v1/finance/fund)、天气 (/v1/life/weather)、物流 (/v1/life/logistics)、IP 归属 (/v1/life/ip)、网络搜索 (/v1/info/search)、网页抓取 (/v1/info/scrape)、新闻 (/v1/info/news) 等。
技术问题
MCP（Model Context Protocol）是 Anthropic 推出的协议，让 AI 助手可以直接调用外部工具。在 Claude Desktop 的配置文件中添加 GroundAPI 的 MCP 地址（mcp.groundapi.net/mcp）和你的 API Key，重启后 Claude 就能直接查询实时数据了。详见博客教程。
所有接口返回统一的 JSON 格式：success（布尔值，表示是否成功）和 data（结构化数据）。错误时返回 error 对象，包含 code 和 message。这种格式对人类和 AI Agent 都友好。
有。免费用户限制为每秒 10 次请求，付费用户限制为每秒 100 次请求。超出限速会返回 429 状态码。如果你的 Agent 需要更高的并发，请联系我们获取企业方案。
不同接口的缓存时长不同：A 股行情 3 秒、快递追踪 2 分钟、网络搜索 5 分钟、天气/网页抓取/新闻 10 分钟、IP 定位 24 小时。缓存期内返回缓存数据，过期后自动请求上游数据源。
账单与付费
我们通过 Stripe 处理支付，支持支付宝、微信支付和国际信用卡（Visa / Mastercard）。在 Dashboard → 账单 页面绑定支付方式后，超出免费额度的调用将按月自动结算。
登录后进入 Dashboard，概览页展示本月调用总量、费用和趋势图表。「用量明细」页可以按接口类型筛选和导出 CSV。「账单」页展示当月费用明细和历史账单。
API 调用费用一经扣除不支持退款，因为数据已经实际交付。但如果你遇到服务异常导致的无效调用，请联系 support@wisefuturus.com，我们会核实后补偿你的免费额度。
进入 Dashboard → 设置 → 底部「危险操作」区域，点击删除账户。删除后，你的所有 API Key、调用记录和账单数据将被永久删除，无法恢复。正式删除需要联系 support@wisefuturus.com 确认。