SpringBoot对接黄金白银期货数据API

1. 核心接口概览

基础 URL : https://api.stocktv.top/futures
认证方式 : 在请求参数中添加 key=您的API_KEY
支持格式: JSON

2. 获取黄金白银期货行情

您可以通过以下两个步骤获取具体数据：

第一步：通过市场列表获取产品 ID (PID)

请求市场列表，通过名称（如 "Gold" 或 "Silver"）筛选出对应的 id。

接口地址 : https://api.stocktv.top/futures/market
常用参数 :
- pageSize: 每页显示数量
- page: 页码
核心字段说明 :
- id: 产品唯一标识 (PID)，对接 K 线和查询接口时必传
- last: 最新价格
- symbol: 期货代码（如 GC 代表黄金，SI 代表白银）

第二步：查询特定品种详情或 K 线

如果您已经知道黄金或白银的 PID（例如从列表获取），可以直接调用：

查询详情 : https://api.stocktv.top/futures/queryFutures?id=产品PID&key=您的KEY
获取 K 线 : https://api.stocktv.top/futures/kline?pid=产品PID&interval=时间周期&key=您的KEY
- interval 可选值：PT1M (1分钟), PT1H (1小时), P1D (1天) 等

3. Java 代码对接示例

作为资深后端，推荐使用 OkHttp 配合 Fastjson/Jackson 进行解析：

java 复制代码

import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;

public class FuturesApiService {
    private static final String API_KEY = "您的API_KEY"; // 联系 Telegram: @CryptoRzz 获取
    private static final String BASE_URL = "https://api.stocktv.top/futures";
    private final OkHttpClient client = new OkHttpClient();

    /**
     * 获取黄金白银等期货最新行情
     */
    public String getFuturesMarket() throws Exception {
        // 构建请求，可以增加筛选逻辑
        String url = BASE_URL + "/market?pageSize=20&page=1&key=" + API_KEY;
        
        Request request = new Request.Builder()
                .url(url)
                .get()
                .build();

        try (Response response = client.newCall(request).execute()) {
            if (response.isSuccessful() && response.body() != null) {
                return response.body().string();
            }
            throw new RuntimeException("API请求失败: " + response.code());
        }
    }
}

4. 关键字段解析

字段	说明	备注
`last`	最新价格	黄金/白银的实时成交价
`high`/`low`	最高价/最低价	当日交易区间
`chgPct`	涨跌幅	需自行拼接 "%" 符号
`time`	时间戳	10位或13位整数

5. 注意事项

Key 获取: 必须联系官方 Telegram 获取有效 Key 才能返回真实数据。
异常处理 : 建议在代码中判断响应体的 code 字段，只有 200 才表示操作成功。
技术支持 : 如果需要更高频率的推送（如秒级波动），该文档支持 WebSocket 接入方式，可向服务商索取 WS 协议文档。