# 实时油价

**请求方式:** GET

**接口地址:** https://api.hk0.cc/api/oil

**接口描述:** 全国 31 省实时油价查询: 0号柴油、89/92/95/98号汽油, 支持省份简称与全称, 可一次返回全国. 数据每日更新, 缓存 30 分钟.

## 请求参数

| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|--------|----------|----------|----------|--------|--------|----------|
| prov | string | query | 可选 | — | — | 省份, 如 北京/广东/内蒙古; 支持简称(京/粤)与全称(北京市/广东省); 不传默认北京 |
| list | int | query | 可选 | — | — | 传 1 返回全国 31 个省份油价 |
| fresh | int | query | 可选 | — | — | 传 1 跳过缓存强制刷新 |

## 返回示例

```json
{
  "code": 200,
  "msg": "success",
  "data": {
    "prov": "北京",
    "p0": "8.11",
    "p89": "7.84",
    "p92": "8.37",
    "p95": "8.91",
    "p98": "10.41",
    "unit": "元/升",
    "updated_at": "2026-11-17 12:00:01"
  }
}
```