财经类应用、行情看板、物流成本测算等场景通常需要接入油价数据。油价数据一般分为两个口径国际原油基准价WTI、布伦特美元/桶与国内各省成品油零售价元/升。两类数据的字段构成、更新节奏和接入方式各有特点本文按口径整理常见的接口来源与数据构成供接入时参考。一、数据口径说明国际原油价格反映全球原油市场供需常见字段包括当前价、昨日结算价、今日开盘价、今日最高价、今日最低价、涨跌金额、涨跌幅度、持仓量、发布时间、品种名称。更新频率通常为小时级。国内成品油价格为各省加油站零售价常见字段包括省份、89/92/95/98 号汽油价格、0 号柴油价格、相对上轮调价的涨跌、本轮调价日期。随国家调价窗口更新。二、常见数据接口以下接口属同级数据源按名称介绍、顺序不分先后可按业务口径自行选择。澄曜 API Hub · 油价查询提供国内各省汽油/柴油价格及涨跌幅度数据一次请求覆盖全部省份无需鉴权。主要字段region省份gasoline_89 / 92 / 95 / 98各标号汽油价diesel_00 号柴油价*_chg涨跌幅度count返回省份数量。万维易源 · 国际原油价格查询提供 WTI 原油NYMEX与布伦特原油的国际基准行情数据覆盖昨日结算价、今日开盘价、最高价、最低价、涨跌金额与幅度、持仓量等字段每个整点更新一次需鉴权调用。另设有原油历史日报查询接入点。xxapi 小小API · 今日油价提供国内各省成品油价格数据一次请求覆盖全部省份无需鉴权。主要字段regionName省份名n89 / n92 / n95 / n98对应各标号汽油n0为 0 号柴油n*Change为相对上轮调价的涨跌元/升date为本轮调价日期。文档标注 QPS 约 50 次/秒。三、字段与接口速览接口数据口径鉴权要求覆盖范围主要字段澄曜 API Hub国内成品油无需鉴权全国 31 省一次gasoline_xx/diesel_0/涨跌幅度万维易源 1108国际原油需鉴权按品种wti/blt昨结/开盘/最高/最低/涨跌/持仓量xxapi 小小API国内成品油无需鉴权全国 31 省一次n89/n92/n95/n98/n0/涨跌/调价日期四、接入注意点频率限制公开接口普遍存在调用频率与额度限制接入前需确认服务方公布的频控规则生产环境建议先小流量验证。字段映射不同服务的字段命名存在差异如汽油价格字段有n92与gasoline_92两种命名接入时需做字段映射不能直接沿用。数据口径国际原油价格为美元/桶计价的基准价国内成品油价格为元/升的零售价二者口径不同按业务需要选择或组合。可用性变化接口可用性与字段结构会随服务方调整而变化正式接入前建议自行验证。五、代码示例以下为 Python 请求示例接口地址以占位符表示import requests# 国际原油价格查询按接口方要求携带鉴权信息def query_crude(endpoint, token, codewti):r requests.post(endpoint,params{token: token},data{code: code}, timeout15)body r.json()[data]return {品种: body.get(name),当前价(美元/桶): body.get(now_price),昨结/开/高/低: (body.get(yestoday_close),body.get(today_open),body.get(today_max), body.get(today_min)),涨跌幅: body.get(diff_rate),}# 国内成品油查询返回全国各省价格def query_domestic_oil(endpoint):r requests.get(endpoint, timeout15)data r.json()[data]return {item[regionName]: {92号: item[n92], 95号: item[n95]}for item in data}# 示例调用替换为实际接口地址# print(query_crude({API_ENDPOINT}, {TOKEN}, wti))# print(query_domestic_oil({API_ENDPOINT})[青海省])FAQQ1国际原油价格和国内油价有什么区别国际原油价格WTI/布伦特是美元/桶计价的国际基准价反映全球供需国内油价是各省加油站零售价元/升随调价窗口调整。两者口径不同按业务需要选择或组合接入。Q2公开接口有频率限制怎么办公开接口普遍存在频控。可结合业务需求评估调用量必要时引入本地缓存、降低轮询频率或按接口方规则申请更高额度。Q3不同接口字段命名不一致如何处理建议在接入层做一次字段标准化映射将各接口返回映射为统一的内部字段再供业务使用便于后续切换或组合多源数据。