Friends Data API独立数据服务

DECISION MODEL DATA · 宏观、统计与监管

US EIA

美国天然气库存历史及能源供需展望。

API 调用说明

能回答的问题

  • 美国本土天然气库存如何变化?
  • 能源展望中实际值和预测值分别是什么?

状态与已知缺口

部分可用

已有天然气库存历史和 EIA 能源展望摘要,预测与实际口径分开说明。

  • 未覆盖完整石油周报。
  • 历史获取值不证明首次发布时点。

提供方

PRODUCT

EIA 能源供需展望摘要

eia_energy_outlook

每行是已收录的 EIA 能源展望发布中的一个指标,保留年度实际值与未来预测值的原生列,须分别读取。包括全球及 OPEC/非 OPEC 总量,与 OPEC 月报的机构、假设和定义不同;不是每日篮子价格或全部成员国详情。

粒度
每指标每发布快照一行
时间范围
2026-09-09 ~ 2026-09-09 · release_date_literal 及年度字段
采集时间
2026-10-04T07:56:09.279530Z ~ 2026-10-04T07:56:09.279530Z
记录数
6

API 调用示例

使用现有 Friends API Key;分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET
/api/v1/data/datasets/decision_model/records/rows?product=eia_energy_outlook&limit=100

字段表 · 6 个字段

字段名中文说明
actual_20242024 年实际值
actual_20252025 年实际值
forecast_20262026 年预测值
forecast_20272027 年预测值
measure_and_unit指标与单位的原始文本
release_date_literal原始发布日期文本

PRODUCT

EIA 美国本土天然气库存历史

eia_lower48_gas_history

每行是美国本土 48 州一周工作天然气库存,保留原始周标签、单位与表格结构;不证明首次发布版本。

粒度
每参考周每快照一行
时间范围
2010-01-01 ~ 2026-09-25 · week_ending 统计周结束日期
采集时间
2026-10-04T13:31:52.849584Z ~ 2026-10-04T13:31:52.849584Z
记录数
874

API 调用示例

使用现有 Friends API Key;分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET
/api/v1/data/datasets/decision_model/records/rows?product=eia_lower48_gas_history&limit=100

字段表 · 25 个字段

字段名中文说明
availability_vintage_verified是否验证当时可获取的版本
body_sha256所保留来源正文的 SHA-256 摘要
end_date_literal原始结束日期文本
forecast_eligible是否满足记录中的预测输入条件
native_identity来源保留的指标身份与口径
native_key来源记录标识
native_metric原始指标名称
native_row_number原始工作表行号
native_status原始状态标记
native_structure原始表格结构和单元格信息
native_table_row_number原始表格行位置
native_unit原始单位
native_week_slot原始周位置
publication_time来源发布时间,缺失时保持为空
region统计地区或商品地区标签
revision原始修订标记
revision_time原始修订时间
series_id统计序列标识
source_fact来源事实说明
unit原始计量单位
value原始观察值,须结合单位与状态阅读
value_literal原始数值文本
week_ending统计周结束日期
working_gas_bcf工作天然气库存,十亿立方英尺
year_month_literal原始年月标签

数据观测时间 2026-10-06T17:38:47.854586Z