JavaScript
Bạn không cần SDK. fetch có sẵn trong mọi trình duyệt, Node, Deno, Bun và edge runtime. CORS được mở và không có khóa nào có thể bị lộ, nên bạn có thể gọi API trực tiếp từ code phía client.
Bắt đầu nhanh
Lấy tỷ giá và quy đổi:
const res = await fetch("https://api.frankfurter.dev/v2/rate/usd/eur");
const data = await res.json();
const total = 100 * data.rate;
Phản hồi là một đối tượng phẳng: {"date": "2026-07-17", "base": "USD", "quote": "EUR", "rate": 0.8739}. fetch vẫn resolve khi gặp lỗi HTTP, nên hãy kiểm tra res.ok; mã tiền tệ không hợp lệ sẽ trả về 422 kèm thông báo JSON.
Định dạng bằng Intl
Đừng tự đặt ký hiệu tiền tệ. Intl.NumberFormat biết ký hiệu, vị trí của nó và số chữ số thập phân của mọi loại tiền tệ, ở mọi locale:
const res = await fetch("https://api.frankfurter.dev/v2/rate/usd/eur");
const { rate } = await res.json();
const eur = new Intl.NumberFormat("en", {
style: "currency",
currency: "EUR",
});
eur.format(100 * rate); // "€87.39"
Ký hiệu và số chữ số thập phân
Không cần tự mang theo bảng siêu dữ liệu về đơn vị phụ hay ký hiệu. Hãy hỏi bộ định dạng:
const yen = new Intl.NumberFormat("en", {
style: "currency",
currency: "JPY",
});
yen.resolvedOptions().maximumFractionDigits; // 0, the yen has no subunits
yen.formatToParts(1).find((part) => part.type === "currency").value; // "¥"
Xem tất cả tiền tệ mà Frankfurter cung cấp, kèm mã và ký hiệu.
Nhiều tiền tệ cùng lúc
/v2/rates trả về một mảng phẳng, mỗi tiền tệ đích một dòng. Chuyển nó thành bảng tra cứu bằng Object.fromEntries. Bỏ quotes để lấy mọi tiền tệ.
const api = "https://api.frankfurter.dev";
const res = await fetch(`${api}/v2/rates?base=usd"es=eur,gbp,jpy`);
const rows = await res.json();
const rates = Object.fromEntries(rows.map((row) => [row.quote, row.rate]));
// { EUR: 0.8739, GBP: 0.74388, JPY: 162.33 }
Cố định một nguồn chính thức
Theo mặc định, bạn nhận được tỷ giá tổng hợp từ mọi nguồn. Thêm providers để cố định một cơ quan cụ thể, điều quan trọng khi một khu vực pháp lý yêu cầu dùng tỷ giá do ngân hàng trung ương của họ công bố, như tỷ giá tham chiếu của ECB cho VAT ở EU.
const api = "https://api.frankfurter.dev";
const res = await fetch(`${api}/v2/rate/usd/eur?providers=ecb`);
Xem tất cả nguồn dữ liệu. Nguồn được cố định tuân theo lịch công bố riêng, nên tỷ giá mới nhất của nó có thể chậm hơn tỷ giá tổng hợp mới nhất một ngày.
Dùng thử trực tiếp
Soạn truy vấn và xem phản hồi ngay trong trình duyệt tại playground.