时间周期与 interval

本页要点

项目	内容
常用取值	`1m`、`3m`、`5m`、`15m`、`30m`、`1h`、`2h`、`4h`、`6h`、`8h`、`12h`、`1d`、`1w`，少数接口取值不同，以接口页为准
业余	4h 及以上
初创	30m 及以上
标准起	全部周期，分钟级历史长度见下表
时间跨度	约等于 interval × limit

可选值与 API 等级

大多数 K 线类接口的 interval 支持下表中的取值。少数接口的取值范围不同（例如只支持 1m、5m），请以各接口页的参数说明为准。

表中天数是该 API 等级可查询的最长历史，「—」表示该 API 等级不支持此周期。

interval	含义	业余	初创	标准	专业
`1m`	1 分钟	—	—	6 天	12 天
`3m`	3 分钟	—	—	20 天	40 天
`5m`	5 分钟	—	—	30 天	60 天
`15m`	15 分钟	—	—	90 天	180 天
`30m`	30 分钟	—	90 天	180 天	360 天
`1h`	1 小时	—	180 天	360 天	720 天
`2h`	2 小时	—	180 天	360 天	720 天
`4h`	4 小时	180 天	180 天	360 天	720 天
`6h`	6 小时	360 天	360 天	360 天	720 天
`8h`	8 小时	360 天	360 天	360 天	720 天
`12h`	12 小时	360 天	360 天	360 天	720 天
`1d`	1 天	全部历史	全部历史	全部历史	全部历史

历史长度数据来自 CoinGlass API 定价页。定价页列出了 2 小时周期，各接口是否支持 2h，以接口页 interval 参数的可选值为准。企业的历史长度可以按需定制，见企业定制。

interval 与 limit 决定时间跨度

一次请求返回的时间跨度约等于 interval × limit。需要更长的区间时，用 start_time、end_time 分段查询，见时间戳与分页。

参数	时间跨度	适合场景
`interval=1h&limit=24`	最近 1 天	看日内变化
`interval=4h&limit=42`	最近 7 天	看周内趋势
`interval=1d&limit=365`	最近 1 年	长周期研究

import os
import requests

# 最近 7 天的比特币全市场持仓量，4 小时一根 K 线
resp = requests.get(
    "https://open-api-v4.coinglass.com/api/futures/open-interest/aggregated-history",
    headers={"CG-API-KEY": os.environ["COINGLASS_API_KEY"]},
    params={"symbol": "BTC", "interval": "4h", "limit": 42},
    timeout=10,
)
print(len(resp.json()["data"]))

K 线字段

字段	说明
`time`	K 线周期的开始时间，毫秒时间戳（UTC）。例如 `interval=30m` 时，`time` 为 15:30 的记录表示 15:30–16:00 这个周期
`open` / `close`	周期开始与结束时的数值
`high` / `low`	周期内的最高与最低值

最后一根 K 线对应尚未结束的周期，数值会继续变化。已经结束的周期也可能因数据补录而更新，目前没有统一的「定稿」等待时间。

常见问题

资金费率的 interval 和结算周期是一回事吗？

不是。interval 只决定数据按多长时间聚合成一根 K 线；资金费率的结算周期由各交易所自行规定。

为什么返回的 K 线条数比 limit 少？

请求的时间范围超出了 API 等级可查询的历史长度时，超出部分不会返回。可以对照上方「可选值与 API 等级」表，或API 等级与权限。

深入了解加密货币 K 线数据

OHLC 是什么意思？

OHLC 是开盘（Open）、最高（High）、最低（Low）、收盘（Close）的缩写。CoinGlass 不只把价格做成 K 线，持仓量（Open Interest）、资金费率（Funding Rate）等指标也以 OHLC 形式返回，例如持仓历史（K 线）和资金费率历史（K 线）。

如何获取 1 分钟级别的历史数据？

1m 到 15m 周期需要标准及以上的 API 等级：标准可查最近 6 至 90 天，专业可查最近 12 至 180 天；更长的分钟级历史可以联系企业定制。

日线数据可以查多久？

所有 API 等级都可以查询日线（1d）的全部历史，适合做长周期回测、牛熊周期对比和年度研究。