提取原油库存文件 API

API ID 14042

轻松检索详细的原油库存文件以进行市场分析和规划

API 文档

端点

请求
在获取原油库存文件API目录中列出商品,包括组、单位、地理覆盖范围、实时或计划状态以及最后更新日期
Endpoint ID: 34148
GET https://zylalabs.com/api/14042/retrieve+crude+oil+stock+files+api/34148/list+commodities
输入参数

列出商品 — 端点功能

对象 描述
group 可选 Commodity group to return. Example: energy, agriculture or metals.
status 可选 Catalog status to return. Example: live or planned.

剩余免费测试请求:3 / 3。


输入参数

group
status
API 示例响应
JSON
{
    "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/14042/retrieve+crude+oil+stock+files+api/34148/list+commodities?group=energy&status=live' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回一个原油库存配置文件,包括千桶单位、地理覆盖范围、历史开始日期以及国家和中心数量
Endpoint ID: 34149
GET https://zylalabs.com/api/14042/retrieve+crude+oil+stock+files+api/34149/get+commodity
输入参数

剩余免费测试请求:3 / 3。

API 示例响应
JSON
{
    "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/14042/retrieve+crude+oil+stock+files+api/34149/get+commodity&commodity=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
列出商品的国家或美国中心,包括每个地点的区号、名称和最新库存周期
Endpoint ID: 34150
GET https://zylalabs.com/api/14042/retrieve+crude+oil+stock+files+api/34150/list+commodity+areas
输入参数

列出商品领域 — 端点功能

对象 描述
type 可选 Kind of area to list. Example: country or hub.
commodity 必需

剩余免费测试请求:3 / 3。


输入参数

type
API 示例响应
JSON
{
    "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/14042/retrieve+crude+oil+stock+files+api/34150/list+commodity+areas?type=country&commodity=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回每个国家或美国中心(包括库欣)最新的原油收盘库存,包括期间、千桶值和可靠性
Endpoint ID: 34151
GET https://zylalabs.com/api/14042/retrieve+crude+oil+stock+files+api/34151/latest+inventory
输入参数

最新库存 — 端点功能

对象 描述
type 可选 Area type in the snapshot. Example: country or hub.
sort 可选 Row order. Example: value_desc or area_asc.
commodity 必需

剩余免费测试请求:3 / 3。


输入参数

type
sort
API 示例响应
JSON
{
    "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/14042/retrieve+crude+oil+stock+files+api/34151/latest+inventory?type=hub&sort=value_desc&commodity=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回一个或多个国家或中心的历史原油库存数据,比如美国和库欣,按最新时间排序
Endpoint ID: 34152
GET https://zylalabs.com/api/14042/retrieve+crude+oil+stock+files+api/34152/inventory+time+series
输入参数

库存时间序列 — 端点功能

对象 描述
from 可选 First period to include, as YYYY-MM-DD. Example: 2026-08-01.
to 可选 Last period to include, as YYYY-MM-DD. Example: 2026-08-21.
limit 可选 Maximum rows in the page. Example: 2. Default is 1000 and the maximum is 5000.
cursor 可选 Page cursor from meta.next_cursor. Example: MjAyNi0wOC0yMXxVUy1DVVNISU5HfDE4OTgy.
area 可选 Area codes, comma-separated. Example: US,US-CUSHING. Empty returns every area.
commodity 必需

剩余免费测试请求:3 / 3。


输入参数

from
to
limit
cursor
area
API 示例响应
JSON
{
    "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/14042/retrieve+crude+oil+stock+files+api/34152/inventory+time+series?from=2026-08-01&to=2026-08-21&limit=2&cursor=MjAyNi0wOC0yMXxVUy1DVVNISU5HfDE4OTgy&area=US,US-CUSHING&commodity=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回与之前时期相比的原油库存变动数据,包括美国和库欣等国家或中心的水平和百分点
Endpoint ID: 34155
GET https://zylalabs.com/api/14042/retrieve+crude+oil+stock+files+api/34155/inventory+changes
输入参数

库存变更 — 端点功能

对象 描述
area 可选 Area codes, comma-separated. Example: US,US-CUSHING.
periods 可选 How many periods to return. Example: 4. The default is 8.
commodity 必需

剩余免费测试请求:3 / 3。


输入参数

area
periods
API 示例响应
JSON
{
    "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/14042/retrieve+crude+oil+stock+files+api/34155/inventory+changes?area=US,US-CUSHING&periods=4&commodity=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 提取原油库存文件 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

(年度计费可节省 2 个月 🎉)

🚀 企业版套餐

起价
$ 10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

概览

检索原油库存文件API按国家和美国储存中心返回关闭原油库存 值以千桶为单位 覆盖范围包括报告库存的国家和像俄克拉荷马州库欣、战略石油储备以及五个PADD地区的中心 实时商品代码为crude_oil 使用列表商品读取目录 使用获取商品获取概况和历史起始 使用列表商品区域获取国家和中心代码 使用最新库存获取每个区域的当前水平 使用库存时间序列获取历史 使用库存变化获取与前一个时期的变动 使用区域代码如US、JP或US-CUSHING过滤系列或变化 小麦、玉米、天然气、锂和铜被计划列出 对于这些代码的库存请求在上市之前返回不可用

提取原油库存文件 API FAQs

千桶 库存响应包括单位设置为千桶 获取商品返回商品档案上的相同单位

按国家和美国中心的原油库存,单位为千桶。每行包含地区、时间段和库存水平。库存变化还返回与前一时期的变化和百分比变化

报告库存的国家以及美国的中心 中心包括俄克拉荷马州的库欣 战略石油储备以及PADD 1到5区域 区域代码类似于US JP和US-CUSHING

传递商品原油和地区US-CUSHING到最新库存、库存时间序列或库存变动 US-CUSHING是俄克拉荷马州卡辛的中心代码

获取商品收益历史_从。对于原油,该日期是1982-08-20,适用于美国系列。其他国家从该地区存在的第一个时期开始。从库存时间序列中设置开始日期。

原油已经上线 小麦 玉米 天然气 锂和铜的状态为计划中 对于计划代码的库存调用在该商品上线之前不可用

每个端点返回特定的原油库存数据。例如最新库存提供当前的库存水平库存时间序列提供历史数据库存变化显示库存随时间的变化

关键字段包括“地区”(位置代码)、“值”(库存水平,单位为千桶)、“周期”(数据日期)和“可靠性”(数据源的可信度)这些字段帮助用户了解库存状态和趋势

响应数据采用JSON格式结构化,主对象包含“商品”详细信息和“数据”数组。数组中的每个条目代表一个特定区域及相关指标,使解析和分析变得容易

参数因端点而异 例如 最新库存接受像US或US-CUSHING这样的区域代码 而库存时间序列允许用户通过“from”和“to”参数指定日期范围以检索历史数据

每个端点提供不同的信息:商品列表显示可用的商品,获取商品详情显示库存资料,商品区域列表识别国家和中心,最新库存提供当前库存水平

用户可以分析库存水平 跟踪随时间变化 并比较各地区的库存 例如 使用库存变动 用户可以评估库存波动的趋势 这有助于市场分析和规划

数据来源于跟踪原油库存的国家和地区报告机构。这确保了信息的可靠性,并反映出各国和枢纽的实际库存水平

典型的使用案例包括市场分析 投资规划和供应链管理 分析师和交易者使用这些数据基于当前和历史原油库存水平做出明智的决策

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

相关 API