最近在做一个小项目，需要把黄金价格实时拿到程序里。最初只是想快速看到数据波动，把它放到工具里观察，不想每隔几秒刷新网页。于是决定用代码直接接入实时行情。

接入的思路

我选择了 Websocket 推送的方式。这样价格一更新，程序就能收到消息，无需轮询。以AllTick API 为例，订阅黄金现货价格后，数据会持续推送到程序里，整个体验自然流畅，没有额外复杂操作。

在实际操作中，每条数据一到，屏幕上就像有一条信息流在跳动，让人能直观感受到价格变化。这种方式比单纯刷新网页舒服很多，也让调试过程更有趣。

Node.js 实例

下面是我用 Node.js 写的脚本，用来接收黄金现货价格：

import WebSocket from "ws" ;

const WS_URL = "wss://realtime.alltick.co/ws" ;

const ws = new WebSocket(WS_URL, {
headers: { "Authorization" : "Bearer YOUR_API_KEY" },
});

ws.on( "open" , () => {
console.log( "连接成功，可以接收黄金价格" );

// 订阅黄金现货行情
ws.send(JSON.stringify({
type: "subscribe" ,
instruments: [ "XAUUSD" ]
}));
});

ws.on( "message" , (msg) => {
const data = JSON.parse(msg);
if (data.type === "tick" ) {
const { instrument, price, ts } = data;
console.log(`${instrument}: ${price} (更新时间 ${new Date(ts).toLocaleTimeString()})`);
}
});

ws.on( "error" , err => console.error( "出错:" , err));
ws.on( "close" , () => console.log( "连接关闭" ));

这段代码可以直接运行，接收到的数据结构很简单：标的名称、当前价格、时间戳。打印或存储都很方便，后续分析或者绘图都能直接用。

数据结构参考

字段	描述
instrument	标的名称，例如 XAUUSD
price	最新价格
ts	时间戳（毫秒级）

开发者体验

程序运行时，看着黄金价格不断刷新，有时幅度不大，有时突然跳一下，心里会有点小惊喜。每条数据像一条信息流，程序和数据像在互动，而不是在“处理接口”。偶尔停下观察几秒，会发现数字跳动带着节奏感，让人忍不住一直盯着屏幕。

整个过程很自然，也挺有趣，比单纯刷新网页或轮询来的直观得多。接入后，剩下的逻辑完全可以交给程序处理，无需频繁干预。

使用感受

接入后，数据稳定、持续推送，可以直接存储或者绘图；
时间戳一定要保留，方便统计或者做曲线展示；
如果程序需要长时间运行，简单的错误和重连处理就够了。

像以上这种方式，整个过程从接入到收到数据，大约半小时就能完成，体验非常顺畅。

记录下这次接入黄金价格api的过程，更像是一段开发笔记：从连接、订阅到数据刷新，每一步都直观。看着数据跳动的过程，有种和信息流互动的感觉，让人对实时数据有了更直观的理解和感受。

黄金价格api实践：一次实时数据接入体验

接入的思路

Node.js 实例

数据结构参考

开发者体验

使用感受