国际原油价格查询：WTI 与布伦特原油怎么选？code 参数实战
国际原油价格查询原油价格APIWTI原油布伦特原油免费接口 # 国际原油价格查询：WTI 与布伦特原油怎么选？code 参数实战
> 接口：国际原油价格查询（apiCode=1108，接入点 1108-1）｜ 免费 ｜ 请求方式 POST/GET ｜ 返回 JSON ｜ 适用人群：需要同时关注两类基准油价的开发者 / 研究者 ｜ 阅读时间：约 5 分钟
## 核心要点
- `code` 参数决定查哪种原油：`wti` = WTI 原油（NYMEX 原油），`blt` = 布伦特原油。
- 两种原油是全球最常用的两大基准油价，关注市场和含义不同，按需查询。
- 一次请求只返回一个 `code` 的结果；要并列展示两种，发两次请求即可。
## Why
聊"国际油价"时，不同场景说的可能不是同一个价。WTI 和布伦特（Brent）是全球两大原油基准，报价来源、代表市场不同，价差也常被拿来研判供需。国际原油价格查询用一个 `code` 参数切换两者，本文讲清差异与调用姿势，避免你取到错误基准还浑然不知。
## What
| 项目 | 说明 |
|------|------|
| 参数名 | `code` |
| 类型 | String，选填（建议显式传） |
| 取值 | `wti`：WTI 原油（NYMEX 原油）；`blt`：布伦特原油 |
| 默认行为 | 文档未说明不传时的返回，建议显式传值 |
## How
### 两种原油对照
| 维度 | WTI（`code=wti`） | 布伦特（`code=blt`） |
|------|------------------|---------------------|
| 中文名（返回 `name`） | WTI原油(NYMEX原油) | 布伦特原油（具体名称以返回为准） |
| 代表市场 | 美国原油基准 | 全球（欧洲/非洲/中东）原油基准 |
| 典型用途 | 北美行情、美盘研判 | 国际油价风向标、跨区价差 |
### 分别查询两种原油
```python
import requests
APP_KEY = "YOUR_APPKEY"
URL = "https://route.showapi.com/1108-1"
def quote(code):
r = requests.get(URL, params={"appKey": APP_KEY, "code": code}, timeout=10).json()
b = r["showapi_res_body"]
if b["ret_code"] != 0:
raise SystemExit(f"失败 {code}")
return b
wti = quote("wti")
blt = quote("blt")
print(f"{wti['name']}: {wti['nowPrice']} 美元/桶 ({wti['diff_rate']})")
print(f"{blt['name']}: {blt['nowPrice']} 美元/桶 ({blt['diff_rate']})")
```
**cURL（布伦特）**
```bash
curl -X POST "https://route.showapi.com/1108-1?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" \
-d "code=blt"
```
**Node.js（fetch，布伦特）**
```javascript
const APP_KEY = "YOUR_APPKEY";
const r = await fetch(
"https://route.showapi.com/1108-1?appKey=" + APP_KEY,
{
method: "POST",
headers: { "content-type": "application/x-www-form-urlencoded" },
body: "code=blt",
signal: AbortSignal.timeout(10000),
}
).then((x) => x.json());
if (r.showapi_res_body.ret_code !== 0) throw new Error("失败");
console.log(r.showapi_res_body.name, r.showapi_res_body.nowPrice);
```
## 返回示例与解析
`code=wti` 与 `code=blt` 返回结构完全一致（字段见 [返回字段全解](https://www.showapi.com/guides/crude-oil-price-fields-1108)），区别仅在数值与 `name`。`nowPrice` 为数字，`name` 会随 `code` 变为对应原油名称。
## 进阶 / 边界
- **一次一基准**：单条请求只返回一个 `code`，同时展示两种需两次调用（注意免费档位下的调用次数）。
- **`name` 字段最可靠**：用它做界面标签，比硬编码"WTI/布伦特"更不易出错。
- **价差用法**：若需计算 WTI 与布伦特的价差，分别取两者 `nowPrice` 相减即可（均为美元/桶、均为数字类型）。
## FAQ
**Q：code 不传默认返回哪个？**
文档未说明默认行为，建议显式传 `wti` 或 `blt`。
**Q：能一次拿两种原油吗？**
不能。该接入点按 `code` 单查，需两次请求分别取 `wti` 与 `blt`。
**Q：WTI 和布伦特哪个更"权威"？**
两者都是全球主流基准，用途不同：WTI 偏北美、布伦特偏国际。具体用哪个取决于你的业务场景，接口不替你做价值判断。
**Q：返回的价是谁的报价？**
由接口数据源提供，文档未披露逐笔交易所来源；本接口为每小时整点更新的汇总价，非实时逐笔行情。
## 相关能力 / 下一步阅读
- [国际原油价格查询返回字段全解：nowPrice / diff_rate / stockNum 一文读懂](https://www.showapi.com/guides/crude-oil-price-fields-1108)
- [国际原油价格查询：5 分钟从注册到拿到第一条 WTI 报价](https://www.showapi.com/guides/crude-oil-price-quickstart-1108)
- [国际原油价格查询：如何用数据搭建实时油价看板？从拉取到可视化](https://www.showapi.com/guides/crude-oil-price-dashboard-1108)
- **本系列共 12 篇**：查看[国际原油价格查询官方指南总目录](https://www.showapi.com/guides/crude-oil-price-guides-1108)
