活跃商品期货合约行情快照
查看 印度股票交易所 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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>'
查询结果
使用场景
- 按商品生成期货曲线视图,以合约月份为横轴绘制最新成交价
- 持仓量排名:找出每种商品中持仓最拥挤的合约
- 换月日期提醒:当合约到期日只剩几个交易日时发出预警
- 计价单位统一工具:避免仪表盘把 KGS、桶等不同报价单位混在一起显示
- 以快照时间戳和合约 id 为键归档每次的当日快照,用来重建日内历史数据
常见问题
商品期货接口需要传参数吗?
不需要。它只是对 /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 合约月份属于文档示例,而不是实时响应。该接口被描述为返回当前活跃的合约,因此请查看每次响应中的快照时间戳,并记住它只是资讯性质的快照,而不是交易执行行情源。