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&quotes=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&quotes=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, quotes và 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, SOL và XRP), cùng với USDT và 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ụ, TRL kết thúc năm 2010 trong khi TRY bắ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à
European Central Bank