Skip to main content

宏观数据模块

宏观数据模块提供大宗商品价格等宏观经济数据的查询功能。

初始化

import { Reportify } from 'reportify-sdk';

const client = new Reportify({ apiKey: 'your-api-key' });

大宗商品价格

获取大宗商品价格数据,支持原油、黄金、天然气、白银、铂金。
// 获取原油价格
const oil = await client.macro.commodities('oil', {
  startDate: '2026-02-01',
  endDate: '2026-02-09',
});
console.log(oil);
// [{ date: '2026-02-06T00:00:00+08:00', wti_co_sp: 63.77, brent_co_sp: 70.45 }, ...]

// 获取黄金价格
const gold = await client.macro.commodities('gold', {
  startDate: '2026-02-01',
  endDate: '2026-02-09',
});
console.log(gold);
// [{ date: '2026-02-06T00:00:00+08:00', lbma_pm_usd: 4948, sge_pm_cny: 1085.72 }, ...]

// 获取天然气价格
const gas = await client.macro.commodities('gas', {
  startDate: '2026-02-01',
  endDate: '2026-02-09',
});

参数说明

参数名类型必填描述
typestring商品类型:oil, gold, gas, silver, platinum
options.startDatestring开始日期(YYYY-MM-DD)
options.endDatestring结束日期(YYYY-MM-DD),起止间隔不超过 10 年

返回类型

返回 Promise<CommodityData[]>,每个对象包含 date 字段和对应 type 的价格字段:
type字段描述
oilwti_co_sp, brent_co_spWTI/布伦特原油现货价(美元/桶)
goldlbma_pm_usd, sge_pm_cny伦敦金(美元/盎司)/上海金(人民币)
gashh_ng_sp亨利港天然气(美元/百万英热单位)
silversi_eur伦敦银(美元/盎司)
platinumpl_usd伦敦铂金(美元/盎司)