国际原油价格查询：个人投资者如何接入自己的看盘工具
国际原油价格查询原油价格APIWTI原油布伦特原油免费接口 # 国际原油价格查询：个人投资者如何接入自己的看盘工具
> 接口：国际原油价格查询（apiCode=1108，接入点 1108-1）｜ 免费 ｜ 请求方式 POST/GET ｜ 返回 JSON ｜ 适用人群：个人投资者、量化爱好者 ｜ 阅读时间：约 6 分钟
## 核心要点
- 把 WTI / 布伦特油价作为"自选指标"接入你的个人看板，与持仓、新闻并列展示。
- 轻量实现：定时拉取 + 本地缓存，界面挂一个油价 widget 即可。
- 数据为每小时汇总的基准价、仅供参考，明确不构成投资建议。
## Why
很多个人投资者有自己的看盘页或周报模板，但油价这类宏观指标常常靠手动记。国际原油价格查询免费、好调，把它接成看板上的一个 widget，你的油价指标就能自动更新，不用再临时搜。本文给一个轻量接入路径。
## What
| 项目 | 说明 |
|------|------|
| 定位 | 看板上的"原油"自选指标 |
| 接入方式 | 定时拉取（每小时）+ 本地缓存 |
| 展示 | 当前价、涨跌幅、今日区间 |
## How
### 看板油价 widget 数据获取
```python
import requests
APP_KEY = "YOUR_APPKEY"
URL = "https://route.showapi.com/1108-1"
def oil_widget(code="wti"):
r = requests.get(URL, params={"appKey": APP_KEY, "code": code}, timeout=10).json()
b = r["showapi_res_body"]
if b["ret_code"] != 0:
return None
return {
"label": b["name"],
"price": b["nowPrice"],
"change": b["diff_rate"],
"range": f'{float(b["todayMin"])} ~ {float(b["todayMax"])}',
"updated": b["time"],
}
# 接入你的看板：每小时刷新一次，读取结果渲染 widget
print(oil_widget("wti"))
print(oil_widget("blt"))
```
**Node.js（fetch）**
```javascript
const APP_KEY = "YOUR_APPKEY";
async function oilWidget(code = "wti") {
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=" + code,
signal: AbortSignal.timeout(10000),
}
).then((x) => x.json());
const b = r.showapi_res_body;
if (b.ret_code !== 0) return null;
return { label: b.name, price: b.nowPrice, change: b.diff_rate,
range: `${parseFloat(b.todayMin)} ~ ${parseFloat(b.todayMax)}`, updated: b.time };
}
```
## 返回示例与解析
widget 用 `name`、`nowPrice`(数字)、`diff_rate`(字符串)、`todayMin/todayMax`(字符串)、`time`。完整字段见 [返回字段全解](https://www.showapi.com/guides/crude-oil-price-fields-1108)。
## 进阶 / 边界
- **仅供参考，非投资建议**：本接口为每小时汇总基准价，不应作为实时交易依据，看板与周报中保持此表述。
- **缓存省额度**：个人看板读本地缓存，每小时刷新（见 [免费档位下如何设计缓存节省调用成本](https://www.showapi.com/guides/crude-oil-price-cache-strategy-1108)）。
- **可叠加其他指标**：油价 widget 与你的股票/基金模块并列即可，互不干扰。
## FAQ
**Q：这能当实时交易行情吗？**
不能。数据为每小时汇总的基准油价，仅供参考，不构成投资建议。
**Q：个人看板接入复杂吗？**
不复杂：每小时拉一次、存缓存、前端渲染一个 widget 即可。
**Q：WTI 和布伦特都要挂吗？**
建议都挂，个人看盘常对比两者价差。
**Q：免费额度对个人够吗？**
每小时各拉一次，一天 48 次，量级很低；具体上限以官方免费档位说明为准。
## 相关能力 / 下一步阅读
- [国际原油价格查询：财经自媒体如何自动填充行情数据](https://www.showapi.com/guides/crude-oil-price-finance-creator-1108)
- [国际原油价格查询：免费档位下如何设计缓存节省调用成本？](https://www.showapi.com/guides/crude-oil-price-cache-strategy-1108)
- [国际原油价格查询：原油涨跌监控与趋势预警搭建指南](https://www.showapi.com/guides/crude-oil-price-alert-1108)
- **本系列共 12 篇**：查看[国际原油价格查询官方指南总目录](https://www.showapi.com/guides/crude-oil-price-guides-1108)
