veinmesh 市场数据
veinmesh 是市场数据服务。一组 API 密钥就能通过 HTTP、WebSocket、Python SDK 或 AI agent，取得盘口快照、服务器端 K 线、批量导出与实时更新。
目前服务的市场列在数据范围；权威清单永远是
GET /v2/catalog/venues 与 GET /v2/catalog/datasets。
第一次使用请从快速开始着手。
可以取得什么
| 数据 | 内容 | 怎么用 |
|---|---|---|
| 盘口快照 | 最新价、累计成交量与成交额、持仓量，以及买卖价量档位 | 市场数据 |
| K 线 | 由服务器端快照计算的任何周期，包括 tick、成交量、range 与 Renko；连续合约支持价差或比例调整 | 市场数据 |
| 实时数据 | 通过 WebSocket 取得新数据列与实时 K 线，支持历史接实时 | 实时流 |
| 目录 | 交易所、市场、商品、instrument、交易日与时段、数据集范围 | 目录与代号 |
| 批量数据 | 多商品、多交易日的 Parquet 或 CSV 档 | 批量导出 |
两种文档
- 用户手册（本区）说明怎么使用服务：概念、流程与预期行为，不重复 API 参数。
- API 文档是渲染于
/api的 OpenAPI 文档，加上限制、 错误与管理。contracts/openapi/v2.yaml是路由、 参数、请求内容与响应格式的唯一出处。
使用方式
- HTTP：每项功能都是 REST 端点。从市场数据与 API 文档开始。
- Python SDK：一次调用就返回可转成 pandas、polars 或 Arrow 的表格。见 Python SDK。
- WebSocket：在交易时段订阅数据列或 K 线。见实时流。
- AI agent：同一套 API 以 MCP 工具形式提供于
/v2/mcp。见 AI agent（MCP）。
依需求找文档
| 我想… | 读 |
|---|---|
| 取得第一笔数据 | 快速开始 |
| 知道目前服务哪些市场与商品 | 数据范围 |
| 了解交易日、时段、代号或小数 | 内核概念 |
| 找合约或它的交易时段 | 目录与代号 |
| 查快照或产生 K 线 | 市场数据 |
| 下载大量商品或交易日 | 批量导出 |
| 在交易时段接收数据 | 实时流 |
| 处理错误与限制 | 错误、限制 |
| 帮同事管理密钥 | API 密钥、管理 |
| 让 AI agent 使用 API | AI agent（MCP） |
| 看有什么变更 | 变更记录 |
备注
先前的 v1 数据 API 已退役。替代关系见 v1（已退役）。