扫描货币的宏观状态过去意味着对每个指标发出单独的API调用一个通货膨胀,一个失业,一个政策利率等等. 从今天开始,您可以在单个认证请求中检索每个指数的最新值,前期打印和期间比期百分比变化. 同样的一次调用模式现在可用于COT定位和商品价格. 查看更多
什么是新的
三个新的 /latest 汇总终点在FXMacroData API中是活的:
发布时间
/api/v1/announcements/{currency}/latest
货币的所有指标最新值,以前值和百分比变化.
最新的COT
/api/v1/cot/{currency}/latest
交易者承诺的最新快照, 每个定位领域的周到周百分比变化.
商品快照
/api/v1/commodities/latest
所有商品指标石油,黄金,天然气在一个呼叫,每个有先前的打印和百分比波动.
每个答案都包括一个最高级别的答案. as_of 每个指标条目都遵循一个一致的形状: 数据库中数据的数据值是指数据的最新指标,因此您总是知道数据货币,而无需解析单个行.
- 标志器 符合公告终点的标准
- 单位 现在我 频率 从数据目录,所以你可以正确格式化值,而无需第二次查询
- 最新 没有
date没有人知道.val没有announcement_datetime最新出版物 - 上一个 在同一个领域的前述观察
- 现在的位置: 从前一个变到最近一个,圆到二小数点的预算百分比变化
对于COT数据, pct_diff_prev 图像是一个地图而不是一个尺度图 每个数字定位字段的百分比变化 (开放利息,非商业长期和短期,净仓位等等) 因为完整的COT快照是多维的.
为什么这对商人很重要
If your system monitors seven currencies — something like USD, EUR, GBP, AUD, JPY, CAD, and CHF — with ten to fifteen indicators each, a naive polling loop can require over a hundred individual API calls to update a dashboard or feed a model. Beyond network overhead, that approach also means processing partial state: your USD inflation value might be two seconds older than your USD unemployment value, depending on when each request completed.
原子货币快照
一个请求将货币的每个指标返回单个一致的有效负载.对于扫描多种货币的大仪表板或警报系统,这将N × M调用减少到N 每种货幣一个.
预计的百分比变化
周期对周期的百分比变化是由服务器端计算的.您不再需要在客户端状态中维持两个滚动值,只需导出一个三角形,API将其与数据一起发送.
自然与SSE结合
当一个新的指标值发布时,FXMacroData SSE流会发出信号.在接收该事件时,发射单个 /latest 需要重新投票的历史系列.
立即选
没有什么. pct_diff_prev 通过对应的结果,您可以直接建立基于值的屏幕:移动超过±1%的标志指标,表面差异性劳动力印记或根据最近的宏观动力排名货币.
没有什么. /latest 终点从 Firestore 发布商店读取的数据相同的数据支持完整的历史系列因此没有单独的缓存或延迟由总结调用引入.您获得的数据与单独查询每个指标相同.
实用例子:美元宏观快照
您正在监视纽约开幕前的美国宏观情况. /latest 终点返回每个跟踪指标的当前状态,每个指标都有其之前的打印和它们之间的变化:
curl "https://fxmacrodata.com/api/v1/announcements/usd/latest?api_key=YOUR_API_KEY"代表性反应 (缩短为三个指标):
{
"currency": "USD",
"source": "store",
"as_of": "2026-03-31",
"count": 14,
"data": [
{
"indicator": "inflation",
"unit": "%",
"frequency": "Monthly",
"has_official_forecast": false,
"latest": {
"date": "2026-02-28",
"val": 2.8,
"announcement_datetime": 1772433000
},
"previous": {
"date": "2026-01-31",
"val": 2.9,
"announcement_datetime": 1769754600
},
"pct_diff_prev": -3.45
},
{
"indicator": "non_farm_payrolls",
"unit": "Persons",
"frequency": "Monthly",
"has_official_forecast": false,
"latest": {
"date": "2026-03-31",
"val": 228000,
"announcement_datetime": 1774857000
},
"previous": {
"date": "2026-02-28",
"val": 151000,
"announcement_datetime": 1772256600
},
"pct_diff_prev": 50.99
},
{
"indicator": "unemployment",
"unit": "%",
"frequency": "Monthly",
"has_official_forecast": false,
"latest": {
"date": "2026-03-31",
"val": 4.1,
"announcement_datetime": 1774857000
},
"previous": {
"date": "2026-02-28",
"val": 4.1,
"announcement_datetime": 1772256600
},
"pct_diff_prev": 0.0
}
]
}经纪人或模特可以从这个单一的响应中立即读出标题. 美元通货膨胀 农业工资在上个月相比略有放松,而非农业的工资表则明显强. 失业率 较强的就业率与较低的通胀率相比, 足以形成美联储短期走势的看法, 没有打开第二次要求.
实用例子:欧元/美元 COT 扫描
交易者承诺报告每周都会发表. /latest 终点返回最近的完整快照,并与前一周的快照一起返回,每个字段的百分比变化.对于EUR,调用还包括常规的 fx_overlay 图表重叠的对:
curl "https://fxmacrodata.com/api/v1/cot/eur/latest?api_key=YOUR_API_KEY"代表的回答:
{
"currency": "EUR",
"instrument": "EURO FX - CHICAGO MERCANTILE EXCHANGE",
"fx_overlay": { "pair": "EUR/USD" },
"source": "store",
"latest": {
"date": "2026-03-25",
"announcement_datetime": 1774478400,
"open_interest": 612380,
"noncommercial_long": 198450,
"noncommercial_short": 108900,
"noncommercial_net": 89550
},
"previous": {
"date": "2026-03-18",
"announcement_datetime": 1773873600,
"open_interest": 598200,
"noncommercial_long": 184200,
"noncommercial_short": 112100,
"noncommercial_net": 72100
},
"pct_diff_prev": {
"open_interest": 2.37,
"noncommercial_long": 7.74,
"noncommercial_short": -2.86,
"noncommercial_net": 24.2
}
}在一个回应中,一个定位系统可以看到,欧元投机长期的比周增长7.74%,而短期收缩2.86%,使净长期仓位扩大了24%.
实用示例:Python中的商品状态
它们的价值是多少? /latest 终点返回所有支持的商品指标在一个调用中. 这里有一个最小的 Python 例子,取出完整的快照,并标记任何自前打印以来移动超过 2% 的商品:
import requests
FXMD_API_KEY = "YOUR_API_KEY"
BASE_URL = "https://fxmacrodata.com/api/v1"
def commodities_movers(threshold_pct: float = 2.0):
resp = requests.get(
f"{BASE_URL}/commodities/latest",
params={"api_key": FXMD_API_KEY},
timeout=10,
)
resp.raise_for_status()
payload = resp.json()
movers = [
entry for entry in payload["data"]
if entry.get("pct_diff_prev") is not None
and abs(entry["pct_diff_prev"]) >= threshold_pct
]
print(f"Commodities snapshot as of {payload['as_of']}")
for m in movers:
direction = "▲" if m["pct_diff_prev"] > 0 else "▼"
print(
f" {m['indicator']:20s}"
f" latest={m['latest']['val']} {m['unit']}"
f" {direction} {abs(m['pct_diff_prev']):.2f}% vs prior"
)
commodities_movers(threshold_pct=2.0)脚本只会进行一个API调用,不管有多少商品指标被跟踪. 交换门或扩展过条件,以构建适合您的策略的商品警报规则.
如何与完整公告的终点相匹配
没有什么. /latest 终点是为了了解状态而不是历史.当你需要时间序列时, 宣布终点 需要知道货币的当前宏观状况时,使用 /latest现在我们要做什么?
没有什么. /latest 终端点在事件驱动的工作流中很好:查询发布日历,了解何时打印,然后打电话 /latest 为了更新您的当前状态快照,请一次.如果您需要更深入的背景,则为打印指标趋势,季节性比较,修订历史记录进行针对该特定指标的全系列调用.
这使得总请求量与在某个会话中实际发布数据的货币数量相称,而不是与您的指标库存规模相称.
开始
美元公告是公开的.所有其他货币公告,COT数据和商品价格都需要通过 ?api_key= 查询参数
