Mọi nguồn đều hiển thị

Truyền nguyên giá theo từng nguồn

Phần lớn API kim loại thu thập giá từ nhiều luồng dữ liệu, tính trung vị có trọng số, loại bỏ dữ liệu đầu vào rồi đưa cho bạn một con số. Cách pha trộn không minh bạch. Khi giá giữa các sàn giao dịch khác nhau (điều xảy ra hằng ngày quanh thời điểm chuyển kỳ hợp đồng, thanh toán và mỗi lần thị trường đóng cửa), bạn không thể biết con số của API phản ánh thực tế hay cách gán trọng số nội bộ của API.

Giá giao ngay được truyền nguyên từ một nguồn chính được cấp phép, không pha trộn hay tính trung bình. Khi có gián đoạn, một nguồn dự phòng được cấp phép cung cấp giá vàng và bạc. Đồng không có nguồn dự phòng. Thêm ?include=sources để xem nguồn đã cung cấp giá, giá của nguồn đó, fetched_at và source_timestamp.

GET /v1/prices?symbol=XAU-USD-SPOT&include=sources

{
  "symbol": "XAU",
  "price": "4803.94",
  "is_stale": false,
  "computed_at": "2026-05-01T02:34:02Z",
  "sources": [
    { "source": "oracle.xau_usd", "display_name": "Live spot", "price": "4803.94", "fetched_at": "...", "source_timestamp": "..." }
  ]
}

Các nguồn chúng tôi tiếp nhận

Nhóm nguồn ở mỗi cấp. Bằng chứng theo từng lượt gọi về các luồng dữ liệu đã được dùng cho một giá cụ thể nằm trong phản hồi /v1/prices của bạn.

Mã định danh nguồn, tần suất làm mới và chi tiết điểm cuối của nhà cung cấp được ghi trong tài liệu nội bộ và thay đổi theo từng bản phát hành. Nếu cần mức chi tiết này để đánh giá pháp lý, hãy gửi trường hợp sử dụng của bạn đến hello@goldprice.dev và chúng tôi sẽ phản hồi.

Giá không tính bằng USD trên các trang tiền tệ là giá vàng giao ngay bằng USD nhân với tỷ giá trực tiếp từ exchangerate.dev, API tiền tệ cùng hệ thống của chúng tôi. Các dòng giá giao ngay không tính bằng USD không dùng tỷ giá đã lưu làm dự phòng. Nếu tỷ giá trực tiếp ngừng cập nhật, /v1/convert và /v1/carat dùng tỷ giá đã lưu mới nhất có tuổi tối đa 3 ngày; các dòng giá giao ngay không tính bằng USD giữ lại giá cũ.

Luồng giá giao ngay dự phòng

Giá giao ngay sử dụng dữ liệu thị trường chính được cấp phép. Giá mua/bán chỉ dành cho gói trả phí và là tùy chọn, yêu cầu một báo giá hai chiều nhất quán. Nếu nguồn chính ngừng hoạt động, vàng và bạc chuyển sang nguồn dự phòng được cấp phép cho đến khi nguồn chính trở lại. Giá dự phòng có thể chậm hơn thị trường tới khoảng hai phút. Trong thời gian sử dụng nguồn này, phản hồi không có giá mua hoặc giá bán.

Chúng tôi không dùng nguồn dự phòng khi thị trường kim loại đóng cửa: hằng ngày từ 17:00 đến 18:00 và từ 17:00 thứ Sáu đến 18:00 Chủ nhật, tất cả theo giờ New York. Đồng không có nguồn dự phòng. Nếu luồng dữ liệu của đồng ngừng hoạt động, giá đồng cuối cùng được đánh dấu là cũ.

Độ lệch giữa các nguồn

Các dòng có ít nhất hai nguồn chính còn mới bao gồm divergence_bps: chênh lệch giữa chúng tính bằng điểm cơ bản so với giá trị trung bình. Các dòng giá giao ngay dùng một nguồn và bỏ qua trường này. GET /v1/prices/divergence liệt kê các mã vượt ngưỡng chênh lệch ở mọi cấp.

divergence_flag luôn là false trên XAU-USD-SPOT; giá vàng không tính bằng USD sử dụng giá giao ngay bằng USD × tỷ giá trực tiếp của exchangerate.dev.

Về giá ấn định LBMA

Trạng thái cũ theo từng nguồn

is_stale ở cấp cao nhất chuyển thành true khi nguồn cung cấp giá vượt quá khoảng thời gian làm mới dự kiến. Thêm ?include=sources để xem giá của nguồn đó, fetched_at và source_timestamp, rồi tự đánh giá độ mới.

Góc nhìn tương lai: đường cong hợp đồng tương lai

Lộ trình giá tương lai hàm ý từ thị trường được cung cấp qua /v1/forward-view/{asset}. Phần giải thích bên dưới trình bày cách tính, nguồn và tần suất làm mới.

Đường cong hợp đồng tương lai

5 hợp đồng tương lai vàng kế tiếp. Giá thanh toán chậm ~15 phút qua chuỗi dữ liệu từ luồng trễ chính của chúng tôi, kèm một nguồn dự phòng thứ cấp. Giá trị hợp đồng tương lai lấy từ các luồng dữ liệu trễ công khai và không phải dữ liệu thời gian thực được cấp phép. Đường nét đứt nối 5 điểm giá thanh toán; khoảng trống xuất hiện khi cả luồng chính lẫn dự phòng đều không cung cấp được dữ liệu cho một hợp đồng. Số hợp đồng mở và khối lượng được xử lý theo khả năng tốt nhất, có giá trị null và không hiển thị trong phản hồi.

Độ mới của dữ liệu

Giá thanh toán hợp đồng tương lai được cập nhật vào các ngày trong tuần lúc 20:30 UTC: một lịch duy nhất quanh năm, +2h sau thanh toán theo EDT, +1h theo EST, không đổi khi chuyển giờ mùa hè.

Những gì chúng tôi không làm

• Giá ấn định LBMA Xem bên trên.
• Sổ lệnh L2 ở cấp độ tick Chúng tôi công bố giá, không công bố độ sâu thị trường. Sổ lệnh ở cấp độ tick nằm ngoài phạm vi của API này.
• Cam kết độ trễ dưới một giây Chúng tôi không công bố SLA độ trễ bằng con số.
• Pha trộn ngầm Toàn bộ mục đích của trang này.

Câu hỏi thường gặp

Nguồn gốc giá của chúng tôi và cách hoạt động của phạm vi dự phòng.

Nhà cung cấp dữ liệu chính và dự phòng của bạn là ai?

Chúng tôi dùng một nhà cung cấp dữ liệu thị trường chính được cấp phép cho vàng, bạc và đồng. Một nhà cung cấp dự phòng được cấp phép hỗ trợ vàng và bạc. Chúng tôi không công bố tên của hai nhà cung cấp.

Giá giao ngay của bạn là giá tổng hợp hay báo giá từ một bên đóng góp?

Chúng tôi truyền nguyên giá của nhà cung cấp chính, không pha trộn hay tính trung bình. Đây không phải giá chuẩn chính thức hay giá ấn định LBMA. ?include=sources trả về sources[] với fetched_at và source_timestamp.

Điều gì xảy ra nếu luồng dữ liệu chính ngừng hoạt động?

Một nguồn dự phòng được cấp phép cung cấp giá vàng và bạc khi nguồn chính không khả dụng. Nguồn này có thể chậm khoảng hai phút và không có giá mua hoặc giá bán. Đồng không có nguồn dự phòng. is_stale chuyển thành true khi nguồn đang được dùng vượt quá khoảng thời gian làm mới dự kiến.

Nhật ký thay đổi phương pháp

Để xem các bản phát hành điểm cuối API, cấp và sản phẩm ngoài những lần sửa đổi phương pháp, hãy xem nhật ký thay đổi sản phẩm.

Có câu hỏi về API? Đọc tài liệu.