Frankfurter API tỷ giá và tiền tệ
Frankfurter là API tỷ giá hối đoái miễn phí cho 219 loại tiền tệ và 39 tài sản khác từ 112 ngân hàng trung ương và nguồn chính thức. Tỷ giá được cập nhật suốt cả ngày. Dữ liệu hàng ngày có từ năm 1948.
API công khai đặt tại api.frankfurter.dev. Bạn không cần khóa API. Dự án là mã nguồn mở, nên bạn cũng có thể tự triển khai để toàn quyền kiểm soát.
Đây là tỷ giá tham chiếu, không phải giá thị trường theo thời gian thực. Mỗi nguồn công bố tỷ giá một hoặc vài lần mỗi ngày.
Đang dùng AI agent? Hãy trỏ nó tới llms.txt, hoặc thêm MCP server.
Tỷ giá
Lấy tỷ giá mới nhất.
curl https://api.frankfurter.dev/v2/rates
Đổi tiền tệ cơ sở bằng base.
curl https://api.frankfurter.dev/v2/rates?base=usd
Lọc tiền tệ đích bằng quotes.
curl https://api.frankfurter.dev/v2/rates?quotes=usd,gbp
Tỷ giá lịch sử
Tra cứu tỷ giá của một ngày cụ thể.
curl https://api.frankfurter.dev/v2/rates?date=1999-01-04
Chuỗi thời gian
Lấy tỷ giá trong một khoảng thời gian bằng from và to.
curl https://api.frankfurter.dev/v2/rates?from=2026-01-01"es=usd
Mẹo: Giới hạn số tiền tệ giúp phản hồi gọn nhẹ. Với khoảng thời gian dài, hãy yêu cầu NDJSON để nhận kết quả theo từng dòng.
Gom nhóm
Giảm mẫu chuỗi thời gian bằng group. Hỗ trợ week và month.
curl https://api.frankfurter.dev/v2/rates?from=2026-01-01&group=month
Lọc theo nguồn
Giới hạn ở các nguồn cụ thể bằng providers.
curl https://api.frankfurter.dev/v2/rates?providers=ecb
Theo mặc định, tỷ giá được tổng hợp từ tất cả các nguồn. Dùng providers để lấy tỷ giá từ một nguồn cụ thể, hoặc dùng
route theo nguồn để truy vấn trực tiếp
một nguồn.
Một số nguồn công bố nhiều bộ dữ liệu, chẳng hạn bảng hàng ngày và hàng tuần của NBP. Khóa nguồn chọn các bộ dữ liệu mặc định của nguồn đó. Khóa bộ dữ liệu chỉ chọn đúng một bộ.
curl https://api.frankfurter.dev/v2/rates?providers=nbp.b&base=pln"es=ars,ngn
Ghi nhận nguồn
Thêm expand=providers để xem những nguồn nào đã góp vào từng
tỷ giá tổng hợp.
curl https://api.frankfurter.dev/v2/rates?expand=providers
Mỗi dòng có thêm mảng providers gồm khóa của các nguồn đóng góp.
Các dòng của tiền tệ neo giá không có trường này. Tỷ giá đó đến từ cơ chế neo,
không phải từ dữ liệu của nguồn.
Đầu ra CSV
Tỷ giá cũng có ở định dạng CSV. Thêm .csv vào đường dẫn hoặc đặt
header Accept thành text/csv.
curl https://api.frankfurter.dev/v2/rates.csv
Đầu ra NDJSON
Với phản hồi lớn, hãy yêu cầu
NDJSON
(JSON phân tách bằng dòng mới) bằng cách đặt header Accept thành
application/x-ndjson. Mỗi dòng là một đối tượng JSON độc lập,
hữu ích để stream chuỗi thời gian lớn mà không phải giữ toàn bộ phản hồi
trong bộ đệm.
curl https://api.frankfurter.dev/v2/rates?from=2026-01-01
Tỷ giá một cặp
Lấy tỷ giá của một cặp tiền tệ. Có thể thêm date hoặc
providers.
curl https://api.frankfurter.dev/v2/rate/eur/usd
Tiền tệ
Lấy danh sách tiền tệ hiện có kèm phạm vi của các nguồn.
curl https://api.frankfurter.dev/v2/currencies
Bao gồm cả tiền tệ cũ bằng scope.
curl https://api.frankfurter.dev/v2/currencies?scope=all
Một tiền tệ
Lấy thông tin chi tiết và phạm vi nguồn của một tiền tệ.
curl https://api.frankfurter.dev/v2/currency/eur
Nguồn dữ liệu
Liệt kê các nguồn đứng sau API.
curl https://api.frankfurter.dev/v2/providers
Lấy thông tin chi tiết của một nguồn.
curl https://api.frankfurter.dev/v2/providers/ecb
Mỗi nguồn liệt kê các bộ dữ liệu của mình, mỗi bộ có ngày, lịch công bố và tiền tệ riêng.
Tỷ giá theo nguồn
Truy vấn tỷ giá trực tiếp từ một nguồn cụ thể. Hỗ trợ các tham số giống
/v2/rates và /v2/rate.
curl https://api.frankfurter.dev/v2/providers/ecb/rates
Lấy một cặp tiền tệ từ nguồn đó.
curl https://api.frankfurter.dev/v2/providers/ecb/rate/eur/usd
Kết hợp với date, khoảng ngày (from và to)
hoặc gom nhóm. Các định dạng như .csv và ndjson cũng dùng được ở đây.
curl https://api.frankfurter.dev/v2/providers/ecb/rates?date=2024-05-15
Quy đổi
API không có endpoint quy đổi. Hãy lấy tỷ giá rồi quy đổi bằng vài dòng code.
function convert(base, quote, amount) {
const api = "https://api.frankfurter.dev";
return fetch(`${api}/v2/rate/${base}/${quote}`)
.then((r) => r.json())
.then((d) => (amount * d.rate).toFixed(2));
}
convert("eur", "usd", 10).then((result) =>
alert(`10 EUR = ${result} USD`)
);
Lỗi
API trả về mã trạng thái HTTP chuẩn kèm nội dung JSON.
{
"status": 422,
"message": "invalid currency: ABC"
}
400- Tham số không hợp lệ hoặc yêu cầu sai định dạng.
404- Không tìm thấy tiền tệ, tỷ giá hoặc tài nguyên.
422- Yêu cầu hợp lệ nhưng không thể xử lý.
Tự triển khai
Bạn có thể tự triển khai bằng Docker. Xem hướng dẫn Deploy để thiết lập cho môi trường production và cấu hình khóa API.
Câu hỏi thường gặp
- Frankfurter dành cho ai (và không dành cho ai)?
- Frankfurter phù hợp cho thanh toán SaaS, thương mại điện tử, báo cáo thuế, hệ thống ERP và kế toán, cũng như nghiên cứu học thuật với chuỗi lịch sử từ năm 1948. Nó không được xây dựng cho giao dịch thời gian thực, hay cho những tiền tệ ít phổ biến biến động mạnh trong ngày.
- API có miễn phí cho mục đích thương mại không?
- Có. Tỷ giá tổng hợp do Frankfurter tự tính toán và được dùng miễn phí. Truy vấn trực tiếp tới endpoint của từng nguồn vẫn tuân theo điều khoản của nguồn đó.
- Tôi có thể lưu hoặc cache tỷ giá trong cơ sở dữ liệu của mình không?
- Có. Chúng tôi khuyến khích lưu dữ liệu hàng ngày tại chỗ để cache hoặc phân tích lịch sử, giúp giảm lưu lượng tới API.
- API có giới hạn số lần gọi không?
- Không có hạn mức. Yêu cầu được giới hạn tốc độ để chống lạm dụng, nhưng không có giới hạn theo tháng hay theo ngày. Nếu dùng với khối lượng lớn, hãy cân nhắc cache phản hồi, tự triển khai hoặc truy vấn trực tiếp các bộ dữ liệu.
- API có hỗ trợ GraphQL không?
-
Không. REST API đủ đơn giản nên GraphQL chỉ thêm phức tạp mà không mang
lại nhiều lợi ích. Nó còn làm hỏng edge caching, thứ giúp API luôn nhanh.
Hãy dùng các tham số truy vấn như
base,quotesvàfrom/tođể lấy đúng dữ liệu bạn cần. - API v1 có bị ngừng không?
- Không. API v1 đã deprecated để chuyển sang v2, nhưng vẫn được duy trì vô thời hạn. Xem tài liệu v1. Với dữ liệu của Ngân hàng Trung ương châu Âu, hãy dùng /v2/providers/ecb/rates.
- Chính sách quyền riêng tư của API là gì?
- API không thu thập hay ghi lại dữ liệu cá nhân, địa chỉ IP hay URL của yêu cầu. Phiên bản công khai chạy sau Cloudflare để cache và chống DDoS, và Cloudflare chỉ cung cấp thống kê lưu lượng tổng hợp.
- Tôi có cần khai báo API trong nhãn quyền riêng tư của App Store hoặc Google Play không?
- Không. Vì truy vấn là ẩn danh và không lưu nhật ký yêu cầu, các yêu cầu này thuộc diện Data Not Collected (không thu thập dữ liệu) theo hướng dẫn của Apple và Google Play.
- Tôi có thể báo lỗi hoặc đặt câu hỏi ở đâu?
- Mở một issue để báo lỗi, đề xuất tính năng hoặc gợi ý nguồn mới. Dùng Discussions để đặt câu hỏi hoặc chia sẻ thư viện hay công cụ bạn đã xây dựng với Frankfurter.
- Tỷ giá chính xác đến mức nào?
- Để tuân thủ quy định (thuế và kế toán), hãy lọc theo một nguồn cụ thể để có tỷ giá tham chiếu chính thức. Với mục đích chung, tỷ giá tổng hợp mặc định là đủ dùng, dù vài chữ số thập phân cuối có thể thay đổi khi có dữ liệu mới.
- Tỷ giá là giá trung bình, giá mua hay giá bán?
- API trả về tỷ giá trung bình thị trường. Khi một nguồn công bố giá mua và giá bán thay vì tỷ giá tham chiếu, Frankfurter lưu cả hai và tính điểm giữa.
- Mọi tỷ giá đều là hàng ngày?
-
Hầu hết là vậy. Một số nguồn cung cấp dữ liệu hàng tuần, hàng tháng hoặc hàng quý. Các nguồn này không được đưa vào tỷ giá tổng hợp. Hãy truy vấn trực tiếp bằng bộ lọc
providers. - Có tỷ giá kim loại quý hoặc tiền mã hóa không?
-
Có. Một số ngân hàng trung ương công bố giá hàng ngày của vàng (
XAU), bạc (XAG), bạch kim (XPT) và palladium (XPD) theo troy ounce. Với tiền mã hóa, chúng tôi chỉ đưa vào các đồng có hợp đồng tương lai CME hoặc CME CF Reference Rate (nhưBTC,ETH,SOLvàXRP), cùng vớiUSDTvàUSDC. Chỉ vài nguồn có tiền mã hóa nên phạm vi còn hạn chế. - Vì sao một số tiền tệ cũ và mới có ngày trùng nhau?
-
Một số nguồn tính lùi tỷ giá của tiền tệ thay thế vào giai đoạn của tiền
tệ cũ (ví dụ,
TRLkết thúc năm 2010 trong khiTRYbắt đầu từ năm 1996). Chúng tôi ghi lại dữ liệu của nguồn đúng như gốc và chỉ lọc phần trùng khi tổng hợp. - Vì sao lại là Frankfurter?
-
Vì nguồn dữ liệu ban đầu của chúng tôi là