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 进行解析：

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. 注意事项

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