{
"data": [
{
"commodity": "crude_oil",
"group": "energy",
"metric": "closing_stocks",
"unit": "thousand_barrels",
"coverage": "countries with available stocks + US hubs",
"status": "live",
"last_updated": "2026-08-21"
}
]
}
curl --location --request GET 'https://zylalabs.com/api/14039/fetch+crude+oil+inventory+data+api/34130/list+commodities?group=energy&status=live' --header 'Authorization: Bearer YOUR_API_KEY'
{
"commodity": "crude_oil",
"group": "energy",
"metric": "closing_stocks",
"unit": "thousand_barrels",
"history_from": "1982-08-20",
"last_updated": "2026-08-21",
"coverage": "countries with available stocks + US hubs",
"areas_count": {
"countries": 35,
"hubs": 7
}
}
curl --location --request GET 'https://zylalabs.com/api/14039/fetch+crude+oil+inventory+data+api/34131/get+commodity&commodity=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"commodity": "crude_oil",
"data": [
{
"area": "AT",
"name": "Austria",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "AU",
"name": "Australia",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "BE",
"name": "Belgium",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "CA",
"name": "Canada",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "CH",
"name": "Switzerland",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "CL",
"name": "Chile",
"type": "country",
"latest": "2026-05-01"
},
{
"area": "CZ",
"name": "Czech Republic",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "DE",
"name": "Germany",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "DK",
"name": "Denmark",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "EE",
"name": "Estonia",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "ES",
"name": "Spain",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "FI",
"name": "Finland",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "FR",
"name": "France",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "GB",
"name": "United Kingdom",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "GR",
"name": "Greece",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "HU",
"name": "Hungary",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "IE",
"name": "Ireland",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "IS",
"name": "Iceland",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "IT",
"name": "Italy",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "JP",
"name": "Japan",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "KR",
"name": "South Korea",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "LT",
"name": "Lithuania",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "LU",
"name": "Luxembourg",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "LV",
"name": "Latvia",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "MX",
"name": "Mexico",
"type": "country",
"latest": "2025-02-01"
},
{
"area": "NL",
"name": "Netherlands",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "NO",
"name": "Norway",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "NZ",
"name": "New Zealand",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "PL",
"name": "Poland",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "PT",
"name": "Portugal",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "SE",
"name": "Sweden",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "SI",
"name": "Slovenia",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "SK",
"name": "Slovakia",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "TR",
"name": "Turkey",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "US",
"name": "United States",
"type": "country",
"latest": "2026-08-21"
}
]
}
curl --location --request GET 'https://zylalabs.com/api/14039/fetch+crude+oil+inventory+data+api/34133/list+commodity+areas?type=country&commodity=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"commodity": "crude_oil",
"metric": "closing_stocks",
"unit": "thousand_barrels",
"as_of": "2026-08-21",
"data": [
{
"area": "US-SPR",
"name": "Strategic Petroleum Reserve",
"period": "2026-08-21",
"value": 289726,
"reliability": "reported"
},
{
"area": "US-PADD3",
"name": "PADD 3 - Gulf Coast",
"period": "2026-08-21",
"value": 251424,
"reliability": "reported"
},
{
"area": "US-PADD2",
"name": "PADD 2 - Midwest",
"period": "2026-08-21",
"value": 101195,
"reliability": "reported"
},
{
"area": "US-PADD5",
"name": "PADD 5 - West Coast",
"period": "2026-08-21",
"value": 45343,
"reliability": "reported"
},
{
"area": "US-PADD4",
"name": "PADD 4 - Rocky Mountain",
"period": "2026-08-21",
"value": 22524,
"reliability": "reported"
},
{
"area": "US-CUSHING",
"name": "Cushing, OK",
"period": "2026-08-21",
"value": 22428,
"reliability": "reported"
},
{
"area": "US-PADD1",
"name": "PADD 1 - East Coast",
"period": "2026-08-21",
"value": 8423,
"reliability": "reported"
}
],
"meta": {
"count": 7,
"period_min": "2026-08-21",
"period_max": "2026-08-21"
}
}
curl --location --request GET 'https://zylalabs.com/api/14039/fetch+crude+oil+inventory+data+api/34136/latest+inventory?type=hub&sort=value_desc&commodity=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"commodity": "crude_oil",
"metric": "closing_stocks",
"unit": "thousand_barrels",
"as_of": "2026-08-21",
"data": [
{
"area": "US",
"period": "2026-08-21",
"value": 428910,
"reliability": "reported"
},
{
"area": "US-CUSHING",
"period": "2026-08-21",
"value": 22428,
"reliability": "reported"
}
],
"meta": {
"count": 2,
"next_cursor": "MjAyNi0wOC0yMXxVUy1DVVNISU5HfDE4OTgy",
"from": "2026-08-01",
"to": "2026-08-21",
"from_defaulted": false
}
}
curl --location --request GET 'https://zylalabs.com/api/14039/fetch+crude+oil+inventory+data+api/34138/inventory+time+series?area=US,US-CUSHING&from=2026-08-01&to=2026-08-21&limit=2&cursor=MjAyNi0wOC0yMXxVUy1DVVNISU5HfDE4OTgy&commodity=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"commodity": "crude_oil",
"unit": "thousand_barrels",
"as_of": "2026-08-21",
"data": [
{
"area": "US",
"period": "2026-08-21",
"value": 428910,
"change": 95,
"change_pct": 0.02
},
{
"area": "US-CUSHING",
"period": "2026-08-21",
"value": 22428,
"change": 1176,
"change_pct": 5.53
},
{
"area": "US",
"period": "2026-08-14",
"value": 428815,
"change": 4405,
"change_pct": 1.04
},
{
"area": "US-CUSHING",
"period": "2026-08-14",
"value": 21252,
"change": -1314,
"change_pct": -5.82
},
{
"area": "US",
"period": "2026-08-07",
"value": 424410,
"change": 17423,
"change_pct": 4.28
},
{
"area": "US-CUSHING",
"period": "2026-08-07",
"value": 22566,
"change": 1611,
"change_pct": 7.69
},
{
"area": "US",
"period": "2026-07-31",
"value": 406987,
"change": 2479,
"change_pct": 0.61
},
{
"area": "US-CUSHING",
"period": "2026-07-31",
"value": 20955,
"change": 2356,
"change_pct": 12.67
}
]
}
curl --location --request GET 'https://zylalabs.com/api/14039/fetch+crude+oil+inventory+data+api/34141/inventory+changes?area=US,US-CUSHING&periods=4&commodity=Required' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 获取原油库存数据 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
(年度计费可节省 2 个月 🎉)
原油库存数据API返回各国和美国储存中心的关闭原油库存数据 值以千桶为单位 覆盖包括报告库存的国家和如俄克拉荷马州库欣、战略石油储备及五个PADD区域的中心 实时商品代码为crude_oil 使用列出商品读取目录 获取商品以查看档案和历史起点 列出商品区域获取国家和中心代码 最新库存获取每个区域的当前水平 库存时间序列获取历史 数据变化与前期的变化 使用区域代码如US、JP或US-CUSHING过滤系列或变化 小麦、玉米、天然气、锂和铜列为计划中 对于这些代码的库存调用在其上线前返回不可用
千桶 库存响应包括单位设置为千桶 获取商品返回商品信息中的相同单位
按国家和美国枢纽的原油库存关闭情况,单位为千桶。每一行包含地区、时间段和库存水平。库存变化还反映了与上一时期的变化及百分比变化
报告库存的国家以及美国的中心 这些中心包括俄克拉荷马州的库欣 战略石油储备和PADD区域1到5 区域代码看起来像US JP和US-CUSHING
将商品原油和地区US-CUSHING传递到最新库存 库存时间序列或库存变化 US-CUSHING是俄克拉荷马州卡辛的中心代码
获取商品回报历史_ 从。对于原油,该日期是1982年8月20日的美国系列。其他国家从该地区存在的第一个时期开始。从库存时间序列中设置开始日期。
原油已经上线 小麦 玉米 天然气 锂和铜在目录中状态为计划中 针对计划代码的库存调用在该商品上线之前不可用
每个端点返回特定的原油库存数据 例如最新库存提供当前的库存水平 库存时间序列提供历史数据 库存变化显示库存随时间的变化 每个响应包括相关的指标和区域细节
关键字段包括“区域”(位置编码)“名称”(位置名称)“期间”(数据日期)“值”(库存水平以千桶为单位)和“可靠性”(数据源可靠性)这些字段帮助用户理解库存水平及其背景
响应数据采用JSON格式结构,其中包含一个包含元数据的主对象以及一个"数据"数组 数组中的每个条目对应一个特定区域,详细说明其库存水平、周期和可靠性,便于解析和分析
参数因端点而异 例如 最新库存接受区号以指定位置 而库存时间序列允许用户使用“从”和“到”参数设置日期范围 这种自定义有助于将数据请求根据特定需求量身定制
API涵盖了多个国家和美国中心的原油库存数据,包括库欣战略石油储备和PADD地区。这种广泛的覆盖允许对全球和区域石油库存进行全面分析
数据准确性通过来自可靠来源的定期更新得以维持,包括政府报告和行业出版物。响应中的“可靠性”字段表示来源的可信度,帮助用户评估数据质量
典型的用例包括市场分析 预测建模 和库存管理 分析师可以利用数据预测趋势 评估供应水平 并根据原油库存变动为投资决策提供信息
用户可以通过比较各地区的库存水平、跟踪历史趋势和评估随时间的变化来分析数据。利用库存变更中的“change”和“change_pct”字段可以帮助识别库存水平的显著波动