Có câu hỏi hoặc gặp sự cố? Hãy đăng trên GitHub Discussions.

Bạn không cần SDK. Frankfurter chỉ là HTTPS thông thường trả về JSON phẳng, nên thư viện HTTP bạn đang dùng là đủ. Không cần khóa API, không cần tài khoản.

Bắt đầu nhanh

Lấy tỷ giá và quy đổi:

import requests

res = requests.get("https://api.frankfurter.dev/v2/rate/usd/eur")
data = res.json()
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}. Mã tiền tệ không hợp lệ sẽ trả về 422 kèm thông báo JSON.

Tính toán an toàn cho tiền tệ

Số thực dấu phẩy động ổn cho hiển thị nhưng sai cho kế toán. Hãy phân tích tỷ giá thành Decimal bằng cách truyền parse_float xuống json.loads:

from decimal import Decimal

import requests

res = requests.get("https://api.frankfurter.dev/v2/rate/usd/eur")
data = res.json(parse_float=Decimal)
total = Decimal("100") * data["rate"]

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 một comprehension. Bỏ quotes để lấy mọi tiền tệ.

res = requests.get(
    "https://api.frankfurter.dev/v2/rates",
    params={"base": "usd", "quotes": "eur,gbp,jpy"},
)
rates = {row["quote"]: row["rate"] for row in res.json()}

Cache những gì không thay đổi

Tỷ giá lịch sử của một nguồn được cố định không thay đổi, nên bạn có thể cache bao lâu tùy thích. Tỷ giá tổng hợp có thể thay đổi khi có dữ liệu mới, còn tỷ giá mới nhất thay đổi khi các nguồn công bố, tối đa vài lần mỗi ngày làm việc, nên hãy đặt TTL ngắn cho chúng. Với requests-cache, cache chỉ cần một dòng:

import requests_cache

session = requests_cache.CachedSession("frankfurter", expire_after=3600)
res = session.get("https://api.frankfurter.dev/v2/rate/usd/eur")
data = res.json()

Bất đồng bộ

Trong ứng dụng web bất đồng bộ, hãy dùng httpx:

import httpx

API = "https://api.frankfurter.dev"


async def rate(base, quote):
    async with httpx.AsyncClient(base_url=API) as client:
        res = await client.get(f"/v2/rate/{base}/{quote}")
        res.raise_for_status()
        return res.json()["rate"]

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.

res = requests.get(
    "https://api.frankfurter.dev/v2/rate/usd/eur",
    params={"providers": "ecb"},
)
data = res.json()

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.

Phân tích một chuỗi?

Với khoảng ngày, gom nhóm theo tháng và biểu đồ, endpoint CSV nạp thẳng vào DataFrame. Xem pandas.