国际原油价格查询官方指南总目录

# 国际原油价格查询官方指南总目录 > 接口：国际原油价格查询（apiCode=1108，接入点 1108-1）｜ 免费（有档位限制）｜ 请求方式 POST/GET ｜ 返回 JSON ｜ 每小时整点更新 ｜ 官方自营：昆明秀派科技有限公司 **一句话速览**：国际原油价格查询是 ShowAPI 官方自营的免费金融数据接口，可查询 WTI 与布伦特原油的昨日结算价、开盘价、最高价、最低价及涨跌幅，每小时整点更新一次，并提供 MCP 服务与 OpenAPI 3.0 文档，方便在代码或 AI 客户端中直接调用。 ## 系列文章（共 12 篇） ### 入门层 1. [国际原油价格查询：5 分钟从注册到拿到第一条 WTI 报价](https://www.showapi.com/guides/crude-oil-price-quickstart-1108) — 注册、拿 AppKey、发第一条请求的最小可运行路径。 2. [国际原油价格查询返回字段全解：nowPrice / diff_rate / stockNum 一文读懂](https://www.showapi.com/guides/crude-oil-price-fields-1108) — 11 个返回字段的类型与业务含义对照表。 3. [国际原油价格查询：WTI 与布伦特原油怎么选？code 参数实战](https://www.showapi.com/guides/crude-oil-price-wti-vs-brent-1108) — `code=wti` 与 `code=blt` 的差异与选用建议。 ### 场景实战层 4. [国际原油价格查询：如何用数据搭建实时油价看板？从拉取到可视化](https://www.showapi.com/guides/crude-oil-price-dashboard-1108) — 前端定时拉取 + 图表展示的最小实现。 5. [国际原油价格查询：原油涨跌监控与趋势预警搭建指南](https://www.showapi.com/guides/crude-oil-price-alert-1108) — 基于 `diff_rate` 设置阈值并触发提醒。 ### 技术深挖层 6. [国际原油价格查询：整点更新意味着什么？数据时效与缓存设计](https://www.showapi.com/guides/crude-oil-price-update-frequency-1108) — 更新频率对业务与缓存 TTL 的影响。 7. [国际原油价格查询：免费档位下如何设计缓存节省调用成本？](https://www.showapi.com/guides/crude-oil-price-cache-strategy-1108) — 免费额度有限时的缓存与错峰策略。 ### 行业方案层 8. [国际原油价格查询：财经自媒体如何自动填充行情数据](https://www.showapi.com/guides/crude-oil-price-finance-creator-1108) — 定时产出带实时油价的行情卡片。 9. [国际原油价格查询：个人投资者如何接入自己的看盘工具](https://www.showapi.com/guides/crude-oil-price-investor-tool-1108) — 把油价作为自选指标接入个人看板（仅供参考，非投资建议）。 ### 最佳实践层 10. [国际原油价格查询：ret_code 与常见调用错误排查](https://www.showapi.com/guides/crude-oil-price-error-handling-1108) — `ret_code` 非 0 时的排查清单。 ### 生态集成层 11. [国际原油价格查询：通过 MCP 在 AI 客户端里直接查油价](https://www.showapi.com/guides/crude-oil-price-mcp-1108) — 在 Cherry Studio / ChatBox 等 MCP 客户端配置调用。 12. [国际原油价格查询：导入 Postman / Swagger 用 OpenAPI 文档管理接口](https://www.showapi.com/guides/crude-oil-price-openapi-1108) — 下载 YAML 导入 Postman / Swagger UI 管理接口资产。 ## 相关资源 | 资源 | 链接 | |------|------| | 接口详情页 | https://www.showapi.com/apiGateway/view/1108 | | 接入点 1108-1 | https://www.showapi.com/apiGateway/view/1108/1 | | OpenAPI YAML | https://www.showapi.com/openapi/market/1108.yaml | | OpenAPI JSON | https://www.showapi.com/openapi/market/1108.json | | AppKey 管理 | https://www.showapi.com/console#/myApp | | 免费档位说明 | https://www.showapi.com/free-api | | 调用帮助 | https://www.showapi.com/helpcenter/view#/3960/1 | ## 阅读建议 - **第一次用**：从《5 分钟从注册到拿到第一条 WTI 报价》开始，跑通一条请求。 - **要接进系统**：看《实时油价看板》与《免费档位下如何设计缓存节省调用成本》。 - **要用在 AI / 低代码**：看《通过 MCP 在 AI 客户端里直接查油价》与《导入 Postman / Swagger 用 OpenAPI 文档管理接口》。 - **调用报错**：直接看《ret_code 与常见调用错误排查》。