活跃商品期货合约行情快照

查看 印度股票交易所 API 的全部接口 →

返回当前活跃商品期货合约的市场数据快照,数据为 JSON 数组,每个合约对应一个对象,涵盖价格、成交量、持仓量、到期日和合约月份。该接口是对 /commodities 的普通 GET 请求,不接受任何查询、路径或请求体参数。该接口没有记录到实时探测调用,因此以下内容全部来自接口文档及其附带的示例记录,尚未与真实响应核对。文档表格列出了 20 个驼峰命名字段:contractId、dataTimestamp、commoditySymbol、expiryDate、lastTradedPrice、lastTradeQuantity、lastTradeTime、averageTradedPrice、totalVolume、openInterest、openingPrice、highPrice、lowPrice、closingPrice、totalTradedValue、priceUnit、contractSize、contractMonth、priceChange 和 percentageChange。而附带的示例记录使用的是 26 个下划线命名的键:id、messageTime、product、expiry、product_month、last_traded_price、last_traded_quantity、last_traded_time、average_traded_price、total_quantity_traded、open_interest、open_price、high_price、low_price、close_price、total_traded_value、price_quotation_unit、quotation_lot、change、per_change、buy_price、buy_quantity、sell_price、sell_quantity、option_type 和 strike_price。这些记录中大多数数值都是带引号的字符串,示例行的日期为 2024 年 6 月 21 日,合约月份为 AUG2024 和 SEP2024,因此只能说明数据的结构,并非当前数据。返回结果仅为资讯性质的快照,不是交易执行或持牌的逐笔行情源。

API 功能

一个数组包含全部活跃合约 一次 GET 请求为每个活跃期货合约返回一个对象,多个商品、多个合约月份一并到达;附带示例中有 CRUDEOIL、CRUDEOILM、GOLDM 和 GOLDPETAL 等行。
持仓量与成交数量一应俱全 每个合约都带有持仓量,以及当日成交的数量和金额,足以按合约的拥挤程度或活跃程度进行排名。
每行都有到期日与合约月份 到期日和合约月份字段(示例中为 19 Aug 2024 和 AUG2024)可以把各行按商品组成期限曲线,或者计算距离换月还剩几天。
记录自带计价单位与手数 计价单位(示例中出现 BBL 和 GRMS)和计价手数(示例中出现 1、10 和 100)随每个合约一起返回,混合商品在展示前就能统一换算。
日内 OHLC 与最新成交明细 开盘价、最高价、最低价和收盘价,加上均价、最新成交价、成交数量和时间,以及涨跌额与涨跌幅,为每个合约提供完整的当日视图。

在线 API 演示

GET /api/project/indian-stock-exchange-api/commodity-futures-data-api

无需参数,点击查询即可调用 API。

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/indian-stock-exchange-api/commodity-futures-data-api?key=<API_KEY>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

商品期货接口需要传参数吗?

不需要。它只是对 /commodities 的一次 GET 请求,没有查询、路径或请求体参数。没有商品、到期日或日期过滤条件,所以请在自己的代码里缩小数组范围,例如按商品代码或合约月份筛选。

响应使用驼峰命名还是下划线命名的字段?

接口文档的表格列出的是驼峰命名,例如 contractId、commoditySymbol、contractMonth 和 openInterest,而其附带的示例记录使用的是下划线命名的键,例如 id、product、product_month 和 open_interest。由于没有记录到实时探测,请在第一次调用时确认真实的键名,并对两种写法都做兼容映射。

字段值是数字还是字符串?

在附带的示例记录中,大多数值(包括价格、数量、持仓量、手数和总成交金额)都是带引号的字符串,例如“6781.00”,而 change 和 per_change 是数字;文档示例则显示为普通数字。请对每个数值字段显式解析,不要依赖 JSON 类型。

这个接口会返回商品的历史数据吗?

接口介绍中提到了实时和历史数据,但该接口本身在文档中被描述为当前活跃合约的快照,并且没有日期参数。如果想建立历史数据,请把每次响应连同快照时间戳和合约 id 一起保存下来。

怎样理解计价单位、手数和成交金额?

示例中出现了 BBL 和 GRMS 两种计价单位,以及 1、10 和 100 的手数,但文档没有说明价格与计价单位如何对应,也没有说明总成交金额以什么单位表示。计算名义金额之前,请先确认合约规格,并且不要在不同计价单位之间直接比较价格。

示例行是 2024 年 6 月的,实时数据也那么旧吗?

2024 年 6 月的时间戳以及 AUG2024 和 SEP2024 合约月份属于文档示例,而不是实时响应。该接口被描述为返回当前活跃的合约,因此请查看每次响应中的快照时间戳,并记住它只是资讯性质的快照,而不是交易执行行情源。

相关接口

相关指南

查看订阅方案 →