当前位置：首页 > news >正文

如何通过API查询实时能源期货价格

news 2025/7/15 10:08:08

在本教程中，我们将一步步展示如何通过一个公开的API接口查询实时的能源期货价格（如美国原油和天然气价格）。这些数据对于投资者、交易者或任何关注能源市场动态的人士都非常有用。

1. 准备工作

首先，确保你具备以下几项准备工作：

你需要安装Python环境。若未安装，可以访问 Python官方网站进行下载并安装。
安装 requests 库，这个库用来发送HTTP请求。你可以通过以下命令来安装：

pip install requests

2. API接口概述

API地址结构：

https://data.infoway.io/common/batch_kline/{klineType}/{klineNum}/{codes}
# 申请API Key: www.infoway.io

{klineType}：表示K线的周期，例如 1 表示1分钟，2 表示5分钟，3 表示15分钟等。
{klineNum}：表示请求返回的K线数量，假设你设置为10，系统会返回10根K线。
{codes}：是资产代码，可以是一个或多个。例如，USOIL 代表美国原油，NGAS 代表天然气。多个资产代码之间用逗号分隔。

👉 👉 API申请入口

3. 构建请求

假设我们要查询美国原油（USOIL）和天然气（NGAS）的1分钟周期、最近10根K线数据。以下是具体代码：

import requests# API请求的基础URL
url = "https://data.infoway.io/common/batch_kline/1/10/USOIL%2CNGAS"# 请求头部，申请API密钥：www.infoway.io
headers = {"accept": "application/json","apiKey": "YOUR_API_KEY"  # 请替换为你实际的API密钥
}# 发送GET请求获取数据
response = requests.get(url, headers=headers)# 打印返回的响应内容
print(response.text)

4. 参数解释

在代码中，url 是我们要请求的API地址，我们请求的是1分钟周期（1）、10根K线（10）的 USOIL 和 NGAS 数据。

注意： 请将 YOUR_API_KEY 替换为你从API提供方获得的实际API密钥。

5. 分析返回的数据

假设你已经成功获取了响应数据。以下是一个可能的返回数据示例：

{"ret": 200,"msg": "success","traceId": "b1fbc42a-8bb3-4741-a785-b3842d04b3f3","data": [{"s": "USOIL","respList": [{"t": "1752267480","h": "68.99800","o": "68.97700","l": "68.97700","c": "68.98800","v": "12.0","vw": "827.8180","pc": "0.02%","pca": "0.01600"},{"t": "1752267420","h": "68.97200","o": "68.96800","l": "68.96300","c": "68.97200","v": "3.0","vw": "206.9030","pc": "0.00%","pca": "0.00000"}]},{"s": "NGAS","respList": [{"t": "1752370800","h": "3.35940","o": "3.35940","l": "3.35940","c": "3.35940","v": "0.0","vw": "0.00000","pc": "0.00%","pca": "0.00000"},{"t": "1752370740","h": "3.35940","o": "3.35940","l": "3.35940","c": "3.35940","v": "0.0","vw": "0.00000","pc": "0.00%","pca": "0.00000"}]}]
}

解释返回数据的各个字段：

ret: 响应的状态码。200 表示请求成功。
msg: 返回消息，success 表示请求成功。
data: 数据主体，包含了每个资产（例如 USOIL 或 NGAS）的K线数据。

每个资产数据中，respList 是一个K线数据的数组，包含以下字段：

t: 时间戳，表示K线的时间（通常是UNIX时间戳）。
h: 最高价格。
o: 开盘价格。
l: 最低价格。
c: 收盘价格。
v: 交易量。
vw: 加权平均价。
pc: 与上一K线相比的百分比变化。
pca: 与上一K线相比的价格变化。

6. 提取和显示K线数据

通过解析返回的JSON数据，我们可以提取并显示每一根K线的数据，例如：

import json# 将返回的响应转换为JSON格式
data = response.json()# 获取USOIL的K线数据
usoil_data = data["data"][0]["respList"]# 打印USOIL的每根K线信息
for kline in usoil_data:print(f"时间: {kline['t']}, 开盘: {kline['o']}, 最高: {kline['h']}, 最低: {kline['l']}, 收盘: {kline['c']}, 交易量: {kline['v']}")