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
| Endpoint | Dữ liệu | Tài liệu |
|---|---|---|
GET /v1/exchange-rates | Tỷ 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-prices | Giá vàng mua vào, bán ra theo hãng và loại vàng. | Xem |
GET /v1/sbv-central-rates | Tỷ 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
curl -s "https://api.dulieuphapluat.vn/v1/exchange-rates?currency_code=USD&per_page=2" \
-H "Authorization: Bearer dlpl_live_xxx"{
"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
curl -s "https://api.dulieuphapluat.vn/v1/gold-prices?brand=sjc&per_page=2" \
-H "Authorization: Bearer dlpl_live_xxx"{
"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
curl -s "https://api.dulieuphapluat.vn/v1/sbv-central-rates?per_page=2" \
-H "Authorization: Bearer dlpl_live_xxx"{
"success": true,
"data": [
{
"rate_date": "…",
"usd_vnd": "…",
"document_no": "…"
}
],
"meta": {
"page": 1,
"per_page": 2,
"has_more": true
}
}Tham số chính
| Tham số | Dùng ở | Ý nghĩa |
|---|---|---|
currency_code | Tỷ giá | Mã ngoại tệ ba chữ cái: USD, EUR, JPY… |
brand | Giá vàng | Thương hiệu: sjc, pnj, bao-tin-minh-chau… |
q | Giá vàng | Tìm theo tên sản phẩm, ví dụ "nhẫn". |
metal | Giá vàng | Loại kim loại. |
date | Cả ba | Một ngày cụ thể, dạng YYYY-MM-DD. |
date_from, date_to | Cả ba | Khoảng ngày. |
page, per_page | Cả ba | Phân trang; per_page mặc định 10, tối đa theo gói. |
Các trường trả về
| Trường | Ý nghĩa |
|---|---|
| Tỷ giá ngoại tệ | |
source | Ngân hàng niêm yết. |
currency_code, currency_name | Mã và tên ngoại tệ. |
buy_cash, buy_transfer, sell | Giá mua tiền mặt, mua chuyển khoản, bán ra — đồng cho một đơn vị ngoại tệ. |
rate_date, quoted_at | Ngày áp dụng và thời điểm niêm yết. |
| Giá vàng | |
brand, brand_name | Mã và tên thương hiệu vàng. |
product_code, product_name | Mã và tên sản phẩm (vàng miếng, nhẫn trơn…). |
karat, purity | Tuổi vàng, hàm lượng. |
buy_price, sell_price | Giá mua vào, bán ra — đồng cho một lượng. |
source, branch | Đơn vị niêm yết bảng giá và khu vực. |
price_date, quoted_at | Ngày và thời điểm niêm yết. |
| Tỷ giá trung tâm | |
rate_date, usd_vnd | Ngày áp dụng và tỷ giá trung tâm USD/VND. |
document_no, issued_on, note | Số 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.
| Gói | Giá / tháng | Lượt gọi / tháng | Lượt gọi / ngày | Bản ghi / trang |
|---|---|---|---|---|
| Free | 0đ | 1.000 | 100 | 10 |
| Starter | 199.000đ | 20.000 | 2.000 | 20 |
| Pro | 699.000đ | 120.000 | 8.000 | 50 |
| Business | 2.490.000đ | 600.000 | 30.000 | 100 |
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.