Trang chủ › API dữ liệu

API tỷ giá và giá vàng

Phần mềm kế toán cần tỷ giá của đúng ngày phát sinh để hạch toán ngoại tệ; phần mềm bán hàng cần giá vàng mới để báo giá; báo cáo cần tỷ giá trung tâm làm mốc. API tỷ giá và giá vàng trả các con số đó theo ngày, dưới dạng JSON, thay cho việc chép tay từ trang ngân hàng.

Ba endpoint

Ba endpoint của API tỷ giá và giá vàng
EndpointDữ liệuTài liệu
GET /v1/exchange-ratesTỷ giá ngoại tệ niêm yết: mua tiền mặt, mua chuyển khoản, bán ra.Xem
GET /v1/gold-pricesGiá vàng mua vào, bán ra theo hãng và loại vàng.Xem
GET /v1/sbv-central-ratesTỷ giá trung tâm USD/VND của Ngân hàng Nhà nước.Xem

Ví dụ: tỷ giá USD mới nhất

Lệnh gọi (thay dlpl_live_xxx bằng key của bạn)

curl -s "https://api.dulieuphapluat.vn/v1/exchange-rates?currency_code=USD&per_page=2" \
  -H "Authorization: Bearer dlpl_live_xxx"

Dạng kết quả trả về

{
    "success": true,
    "data": [
        {
            "source": "…",
            "currency_code": "…",
            "buy_cash": "…",
            "buy_transfer": "…",
            "sell": "…",
            "rate_date": "…"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 2,
        "has_more": true
    }
}

Giá vàng miếng SJC

Lệnh gọi (thay dlpl_live_xxx bằng key của bạn)

curl -s "https://api.dulieuphapluat.vn/v1/gold-prices?brand=sjc&per_page=2" \
  -H "Authorization: Bearer dlpl_live_xxx"

Dạng kết quả trả về

{
    "success": true,
    "data": [
        {
            "brand_name": "…",
            "product_name": "…",
            "buy_price": "…",
            "sell_price": "…",
            "price_date": "…"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 2,
        "has_more": true
    }
}

Tỷ giá trung tâm

Lệnh gọi (thay dlpl_live_xxx bằng key của bạn)

curl -s "https://api.dulieuphapluat.vn/v1/sbv-central-rates?per_page=2" \
  -H "Authorization: Bearer dlpl_live_xxx"

Dạng kết quả trả về

{
    "success": true,
    "data": [
        {
            "rate_date": "…",
            "usd_vnd": "…",
            "document_no": "…"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 2,
        "has_more": true
    }
}

Tham số chính

Tham số của ba endpoint
Tham sốDùng ởÝ nghĩa
currency_codeTỷ giáMã ngoại tệ ba chữ cái: USD, EUR, JPY…
brandGiá vàngThương hiệu: sjc, pnj, bao-tin-minh-chau…
qGiá vàngTìm theo tên sản phẩm, ví dụ "nhẫn".
metalGiá vàngLoại kim loại.
dateCả baMột ngày cụ thể, dạng YYYY-MM-DD.
date_from, date_toCả baKhoảng ngày.
page, per_pageCả baPhân trang; per_page mặc định 10, tối đa theo gói.

Các trường trả về

Tỷ giá ngoại tệ

Trường của tỷ giá ngoại tệ
TrườngÝ nghĩa
sourceNgân hàng niêm yết.
currency_code, currency_nameMã và tên ngoại tệ.
buy_cash, buy_transfer, sellGiá mua tiền mặt, mua chuyển khoản, bán ra, tính bằng đồng cho một đơn vị ngoại tệ.
rate_date, quoted_atNgày áp dụng và thời điểm niêm yết.

Giá vàng

Trường của giá vàng
TrườngÝ nghĩa
brand, brand_nameMã và tên thương hiệu vàng.
product_code, product_nameMã và tên sản phẩm (vàng miếng, nhẫn trơn…).
karat, purityTuổi vàng, hàm lượng.
buy_price, sell_priceGiá mua vào, bán ra, tính bằng đồng cho một lượng.
source, branchĐơn vị niêm yết bảng giá và khu vực.
price_date, quoted_atNgày và thời điểm niêm yết.

Tỷ giá trung tâm

Trường của tỷ giá trung tâm
TrườngÝ nghĩa
rate_date, usd_vndNgày áp dụng và tỷ giá trung tâm USD/VND.
document_no, issued_on, noteSố văn bản công bố, ngày công bố, ghi chú.

Bản ghi trong danh sách chỉ mang các trường chính; gọi chi tiết /v1/{bộ dữ liệu}/{id} để có đủ trường.

Dữ liệu lấy từ đâu, cập nhật bao lâu một lần

  • Tỷ giá ngoại tệ: bảng tỷ giá công bố của Vietcombank. Hệ thống lấy lại 2 giờ một lần trong khung 8h–18h hằng ngày; lần lấy cuối trong ngày là tỷ giá được lưu cho ngày đó.
  • Giá vàng: bảng giá công khai của Bảo Tín Minh Châu và PNJ; giá vàng miếng SJC lấy từ chính hai bảng giá này. Lấy lại mỗi giờ trong khung 8h–18h.
  • Tỷ giá trung tâm: số liệu Ngân hàng Nhà nước công bố trên sbv.gov.vn.

Gói nào dùng được

Cả ba endpoint đều mở cho mọi gói, kể cả Free. Gói cao hơn tăng hạn mức lượt gọi và số bản ghi mỗi trang.

Các gói của DLPL API
GóiGiáLượt gọi mỗi thángLượt gọi mỗi ngàyBản ghi mỗi trang
Free0đ / tháng1.00010010
Starter199.000đ / tháng20.0002.00020
Pro699.000đ / tháng120.0008.00050
Business2.490.000đ / tháng600.00030.000100

Giá chưa gồm VAT, theo bảng giá ngày 01/10/2026. Bảng giá đang áp dụng: xem trên trang API.

Câu hỏi thường gặp khi tích hợp

Tỷ giá trong API là của ngân hàng nào?

Bộ exchange-rates là tỷ giá niêm yết của Vietcombank, ghi rõ trong trường source. Tỷ giá trung tâm USD/VND do Ngân hàng Nhà nước công bố nằm ở bộ riêng sbv-central-rates.

Lấy tỷ giá của một khoảng ngày thế nào?

Gọi GET /v1/exchange-rates?currency_code=USD&date_from=2026-09-01&date_to=2026-09-30. Kết quả xếp theo ngày mới nhất trước; dùng page để lấy tiếp các trang sau.

Giá vàng tính theo đơn vị nào?

buy_price và sell_price là số nguyên, đơn vị đồng cho một lượng, đã quy đổi về cùng đơn vị dù mỗi hãng niêm yết theo chỉ hay theo lượng.

Sao gọi /v1/gold-prices không truyền gì lại báo lỗi?

Bộ giá vàng cần ít nhất một trong brand, date hoặc q; bộ tỷ giá cần currency_code hoặc date. Điều kiện này tránh việc một lượt gọi kéo cả lịch sử về.

Gói miễn phí có dùng được ba bộ này không?

Có. Cả tỷ giá ngoại tệ, giá vàng và tỷ giá trung tâm đều mở cho gói Free, trong hạn mức 100 lượt gọi mỗi ngày và 1.000 lượt mỗi tháng. Gói Free bắt buộc ghi nguồn dulieuphapluat.vn khi hiển thị.

Bắt đầu với gói miễn phí

Đăng ký bằng email, lấy key và gọi thử ngay, không cần thanh toán.

Công cụ và bài viết liên quan

Muốn xem các con số này trên web, hãy mở trang tỷ giá ngoại tệ hôm nay hoặc giá vàng hôm nay. Các bộ dữ liệu khác nằm ở trang API dữ liệu.