今日油价查询

接口标识: oilprice 价格: 0.05 元/次 VIP免费

接口介绍
接口文档
在线测试

接口简介

今日油价查询接口，覆盖全国 31 个省份的汽油、柴油零售价格，数据每日早上 7 点整同步国家发改委及各地公布的成品油最高零售限价。支持按省份查询 89/90/92/93/95/97/98 号汽油与 0 号柴油价格，可选附带最近一次调价涨跌幅与下次调价日期。省份名称自动归一（兼容「北京市」「广西壮族自治区」等写法），适用于车主出行助手、汽车资讯内容生成、物流燃油成本测算等场景。

详细介绍

## 接口介绍

今日油价查询接口提供全国 31 个省份的汽油、柴油零售价格数据，数据源为每日早上 7 点整同步的国家发改委及各地公布的成品油最高零售限价。接口按省份返回该地区在售的各标号汽油（89/90/92/93/95/97/98 号）与 0 号柴油价格。

## 使用场景

- **车主出行助手**：查询目的地省份今日 92/95 号油价，估算出行燃油成本
- **汽车资讯内容**：定时生成「各省油价速览」「今日油价播报」等资讯
- **物流成本测算**：按途经省份 0 号柴油价格测算货运燃油开支
- **油价调整提醒**：结合 with_change 参数推送最近调价涨跌幅与下次调价日期

## 使用教程

### 1. 发起请求

向 `/api/oilprice` 发送 POST 请求，携带以下参数：

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| province | string | 是 | 省份名称，如 北京 / 广东 / 上海市，支持全国 31 省，本站自动归一行政后缀 |
| with_change | boolean | 否 | 是否附带油价涨跌信息，默认 false |

### 2. 响应示例

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "province": "北京",
    "unit": "元/升",
    "update_date": "2026-11-03",
    "update_time": "2026-11-03 07:00:00",
    "prices": [
      {"label": "92号汽油", "price": 7.85},
      {"label": "95号汽油", "price": 8.35},
      {"label": "0号柴油", "price": 7.56}
    ],
    "price_92": 7.85,
    "price_95": 8.35,
    "diesel_0": 7.56,
    "change": {
      "last_change_date": "2026-10-30",
      "next_change_date": "2026-11-13",
      "items": [
        {"label": "92号汽油", "price": 7.85, "change": -0.12, "change_percent": "-1.5%", "before_price": 7.97}
      ]
    }
  },
  "request_id": "a1b2c3d4e5f6"
}
```

### 3. 响应字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| province | string | 省份名称 |
| unit | string | 价格单位，固定「元/升」 |
| update_date | string | 数据日期（YYYY-MM-DD） |
| update_time | string | 数据更新时间 |
| prices | array | 各标号油价数组，元素含 label（油品名称）与 price（价格，元/升） |
| price_89 ~ price_98 | float | 对应标号汽油价格，该省无此标号时不返回 |
| diesel_0 | float | 0 号柴油价格 |
| change | object | 油价涨跌信息，仅 with_change=true 时返回 |

### 4. 错误码

| code | 说明 |
|------|------|
| 0 | 请求成功 |
| 40002 | 参数错误（省份缺失或不存在） |
| 40101 | 鉴权失败 |

## 注意事项

- 数据为**每日 7 点同步的省级调价结果**，非实时行情，请以国家/地方发改委公布价为准。
- 覆盖全国 31 个省份，标号集合随各地实际在售情况而定，prices 数组天然兼容标号增减。
- 传入不支持或拼写错误的省份名称时返回本站参数错误码（40002），不会返回空数据。

接口地址： https://www.phpwc.cn/api/oilprice

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`province`	string	必填	-	省份名称，如北京 / 广东 / 上海市，支持全国 31 省，本站自动归一行政后缀
`with_change`	boolean	选填	`false`	是否附带油价涨跌信息（最近/下次调价日、各标号涨跌幅），默认 false

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`province`	string	省份名称
`unit`	string	价格单位，固定「元/升」
`update_date`	string	数据日期（YYYY-MM-DD）
`update_time`	string	数据更新时间
`prices`−	array	各标号油价数组
`label`	string	油品名称，如 92号汽油 / 0号柴油
`price`	float	价格，元/升
`price_89`	float	89号汽油价格，元/升（该省无此标号时不返回）
`price_90`	float	90号汽油价格，元/升
`price_92`	float	92号汽油价格，元/升
`price_93`	float	93号汽油价格，元/升
`price_95`	float	95号汽油价格，元/升
`price_97`	float	97号汽油价格，元/升
`price_98`	float	98号汽油价格，元/升
`diesel_0`	float	0号柴油价格，元/升
`change`−	object	油价涨跌信息，仅 with_change=true 时返回
`last_change_date`	string	最近一次调价日期（YYYY-MM-DD）
`next_change_date`	string	下一次调价日期（YYYY-MM-DD）
`items`	array	各标号涨跌明细数组
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试