# Velo CSV怎么核？区分八小时费率、基差与历史权限

整理：链小知（AI 辅助）
资料核对日期：2026-10-14
引用地址：https://lianxiaozhi.com/tools/guides/velo-csv-funding-basis-history-license-check
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

保留合约、毫秒时间与分钟粒度，按值数量拆分和核授权。

## 使用工具
- [Velo Data](https://lianxiaozhi.com/tools/velo-data) · [官方入口](https://velo.xyz/)

## 前置条件
- 仅核公开文档或自己已有的脱敏材料；不申请密钥、下单或转移资金。
- 分别保存产品、场所、单位、时点与数据缺项，错误不记成零。

## 1. 锁数据产品和对象

当前API base为api.velo.xyz，rows为GET /api/v1/rows，返回CSV。type选futures/options/spot；products与coins必须恰好一个，不能同时给或都省略。普通请求还要求exchanges与columns，保留exchange/coin/product组合，不只按BTC一列拼合约。

核对结果：CSV对象、市场类型和请求参数可追溯，没有丢场所或合约。
依据：[Velo：API与历史权限](https://docs.velo.xyz/api)
依据：[Velo：rows CSV](https://docs.velo.xyz/api/data)

## 2. 核时间与聚合粒度

begin/end及CSV time示例为毫秒；resolution通常是分钟，例如240为4小时，列出值之外接受60的倍数。months=true则resolution变成月数，且end−begin最多32天乘resolution；不能把月粒度当分钟。文档没有在这段给统一边界包含规则，拼接窗口先核实际边界并去重。

核对结果：毫秒、分钟和月份分别记录，重叠及不明边界未静默拼接。
依据：[Velo：rows CSV](https://docs.velo.xyz/api/data)

## 3. 分清资金费率与基差

rows所有资金费率归一化为每8小时；终端Futures页可展示每8小时或年化，因此先核列名和尺度，不当个人实际已结算款。3m_basis_ann是三个月年化期货基差，必须type=futures、columns只这一项、用coins只选BTC/ETH；这一特例可省exchanges，并非其它列都可省。

核对结果：费率尺度与基差特例明确，没有混当已收款或同一个指标。
依据：[Velo：rows CSV](https://docs.velo.xyz/api/data)
依据：[Velo：Futures指标定义](https://docs.velo.xyz/features/reference/futures)

## 4. 按值数与权限检查缺历史

单HTTP请求最多22500个values，不等22500行；限流120请求/30秒。官方API页月付三个月历史、年付完整数据历史，完整指供应商所存而非每个产品同日起点。403缺/无效/无权限、429限流、503暂不可用需分别记录，不能据缺值推没有交易。

核对结果：值数、速率、订阅历史和产品实际覆盖分别核，错误仍为未知。
依据：[Velo：API与历史权限](https://docs.velo.xyz/api)
依据：[Velo：rows CSV](https://docs.velo.xyz/api/data)
依据：[Velo：速率限制](https://docs.velo.xyz/api/rate-limits)

## 5. 核认证与使用许可

HTTP Basic用户名api、密码本人key，不写入记录。条款把key、数据、派生数据和新闻限制为本人使用；多人或非内部用途需另联系供应商授权。五分钟超过三个IP使用同账号/key时可能只允许一个，不把它当可任意并行的服务。

核对结果：本人密钥未留存，再分发、派生公开图和多人使用没有被默认为已许可。
依据：[Velo：认证](https://docs.velo.xyz/api/authentication)
依据：[Velo：许可](https://docs.velo.xyz/terms-of-service)
依据：[Velo：速率限制](https://docs.velo.xyz/api/rate-limits)

## 常见错误
- CSV看起来连续不证明没有漏行。
- 图表与下单覆盖不是API数据覆盖的替代清单。

## 完成检查
- 形成带合约、尺度、粒度、缺项与使用许可的CSV核对记录；没有取得实际业务数据。

## 相关知识

## 官方依据
- [Velo：API与历史权限](https://docs.velo.xyz/api)
- [Velo：rows CSV](https://docs.velo.xyz/api/data)
- [Velo：Futures指标定义](https://docs.velo.xyz/features/reference/futures)
- [Velo：速率限制](https://docs.velo.xyz/api/rate-limits)
- [Velo：认证](https://docs.velo.xyz/api/authentication)
- [Velo：许可](https://docs.velo.xyz/terms-of-service)