Huobi Pro 指数 K 线数据 API 使用指南与 Spring Boot 代码示例

Huobi Pro 提供了获取指数 K 线数据的 API，您可以使用该 API 获取不同时间粒度（如 1 分钟、5 分钟、1 小时等）的指数 K 线数据。本文将详细介绍如何使用该 API，并提供 Spring Boot 代码示例，展示如何使用 RestTemplate 进行 HTTP 请求并处理限流问题。

API 接口

获取指数 K 线数据接口

请求方式： GET
URL： /api/v5/market/index-candles
参数：
- instId: String，现货指数，如 'BTC-USD'
- after: String，可选，请求此时间戳之前（更旧的数据）的分页内容，传的值为对应接口的 ts
- before: String，可选，请求此时间戳之后（更新的数据）的分页内容，传的值为对应接口的 ts，单独使用时，会返回最新的数据。
- bar: String，可选，时间粒度，默认值 '1m'，可选值如下：
  - [‘1m’, ‘3m’, ‘5m’, ‘15m’, ‘30m’, ‘1H’, ‘2H’, ‘4H’]：香港时间开盘价 K 线
  - [‘6H’, ‘12H’, ‘1D’, ‘1W’, ‘1M’, ‘3M’]：香港时间开盘价 K 线
  - [‘6Hutc’, ‘12Hutc’, ‘1Dutc’, ‘1Wutc’, ‘1Mutc’, ‘3Mutc’]：UTC 时间开盘价 K 线
- limit: String，可选，分页返回的结果集数量，最大为 100，不填默认返回 100 条
返回参数：
- ts: String，开始时间，Unix 时间戳的毫秒数格式，如 1597026383085
- o: String，开盘价格
- h: String，最高价格
- l: String，最低价格
- c: String，收盘价格
- confirm: String，K 线状态，0 代表 K 线未完结，1 代表 K 线已完结。

限速

限速： 20 次/2 秒
限速规则： IP

Spring Boot 代码示例

import org.springframework.http.HttpMethod;
import org.springframework.http.HttpHeaders;
import org.springframework.http.HttpEntity;
import org.springframework.http.ResponseEntity;
import org.springframework.web.client.RestTemplate;
import java.util.HashMap;
import java.util.Map;

public class IndexCandlesDataCollector {

    private static final String API_URL = "https://api.huobi.pro/api/v5/market/index-candles";
    private static final String API_KEY = "your-api-key";
    private static final String API_SECRET = "your-api-secret";

    public static void main(String[] args) {
        String instId = "BTC-USD";
        String[] granularities = {"1m", "5m", "15m", "30m", "1H", "4H"};

        for (String granularity : granularities) {
            collectData(instId, granularity);
        }
    }

    private static void collectData(String instId, String granularity) {
        RestTemplate restTemplate = new RestTemplate();
        HttpHeaders headers = new HttpHeaders();

        // 设置 API 密钥和签名
        headers.set("Api-Access-Key", API_KEY);
        headers.set("Api-Access-Signature", generateSignature());

        Map<String, String> params = new HashMap<>();
        params.put("instId", instId);
        params.put("bar", granularity);
        params.put("limit", "100");

        HttpEntity<?> requestEntity = new HttpEntity<>(headers);
        ResponseEntity<String> responseEntity = restTemplate.exchange(API_URL, HttpMethod.GET, requestEntity, String.class, params);

        // 处理响应数据
        String responseBody = responseEntity.getBody();
        System.out.println(responseBody);
    }

    private static String generateSignature() {
        // 使用 API 密钥和其他必要参数生成 API 签名
        // 您可以使用 Apache Commons Codec 或 Bouncy Castle 等库进行加密

        return "your-api-signature";
    }
}

注意：

将代码中的 'your-api-key'、'your-api-secret' 和 'your-api-signature' 替换为您的实际 API 密钥和签名。
该代码使用 Spring Boot 和 RestTemplate 进行 HTTP 请求，并使用 HMAC-SHA256 算法生成 API 签名。您可以根据需要自定义此代码，并根据您的应用程序需求进行适当的限流处理。

总结

本文介绍了如何使用 Huobi Pro API 获取指数 K 线数据，并提供了 Spring Boot 代码示例，展示如何使用 RestTemplate 进行 HTTP 请求并处理限流问题。希望本文能帮助您更好地理解和使用 Huobi Pro API。

Huobi Pro 指数 K 线数据 API 使用指南与 Spring Boot 代码示例