Velo CSV怎么核?区分八小时费率、基差与历史权限
链小知 · 进阶 · 核验 · 依官方文档整理
保留合约、毫秒时间与分钟粒度,按值数量拆分和核授权。
开始前准备
- 仅核公开文档或自己已有的脱敏材料;不申请密钥、下单或转移资金。
- 分别保存产品、场所、单位、时点与数据缺项,错误不记成零。
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对象、市场类型和请求参数可追溯,没有丢场所或合约。
2. 核时间与聚合粒度
begin/end及CSV time示例为毫秒;resolution通常是分钟,例如240为4小时,列出值之外接受60的倍数。months=true则resolution变成月数,且end−begin最多32天乘resolution;不能把月粒度当分钟。文档没有在这段给统一边界包含规则,拼接窗口先核实际边界并去重。
检查结果:毫秒、分钟和月份分别记录,重叠及不明边界未静默拼接。
3. 分清资金费率与基差
rows所有资金费率归一化为每8小时;终端Futures页可展示每8小时或年化,因此先核列名和尺度,不当个人实际已结算款。3m_basis_ann是三个月年化期货基差,必须type=futures、columns只这一项、用coins只选BTC/ETH;这一特例可省exchanges,并非其它列都可省。
检查结果:费率尺度与基差特例明确,没有混当已收款或同一个指标。
4. 按值数与权限检查缺历史
单HTTP请求最多22500个values,不等22500行;限流120请求/30秒。官方API页月付三个月历史、年付完整数据历史,完整指供应商所存而非每个产品同日起点。403缺/无效/无权限、429限流、503暂不可用需分别记录,不能据缺值推没有交易。
检查结果:值数、速率、订阅历史和产品实际覆盖分别核,错误仍为未知。
5. 核认证与使用许可
HTTP Basic用户名api、密码本人key,不写入记录。条款把key、数据、派生数据和新闻限制为本人使用;多人或非内部用途需另联系供应商授权。五分钟超过三个IP使用同账号/key时可能只允许一个,不把它当可任意并行的服务。
检查结果:本人密钥未留存,再分发、派生公开图和多人使用没有被默认为已许可。
怎样确认完成
- 形成带合约、尺度、粒度、缺项与使用许可的CSV核对记录;没有取得实际业务数据。
常见错误与边界
- CSV看起来连续不证明没有漏行。
- 图表与下单覆盖不是API数据覆盖的替代清单。