跳到正文
← 使用教程

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数据覆盖的替代清单。

本教程根据官方资料整理,尚未完成逐步操作验收。界面、支持范围及费用变化时,先核对官方说明。 纯文本版 · 提交纠错依据