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（已退役）。