pandas
Endpoint CSV của Frankfurter nạp thẳng vào DataFrame, nên lấy tỷ giá chỉ mất một dòng. Lý do nên dùng nó thay vì tra nhanh tỷ giá thị trường là khả năng tái lập: cố định một nguồn và lịch sử của nó giữ nguyên như khi công bố, nên backtest bạn chạy hôm nay sẽ khớp với lần bạn chạy năm ngoái.
Bắt đầu nhanh
Trỏ read_csv tới endpoint CSV:
import pandas as pd
df = pd.read_csv("https://api.frankfurter.dev/v2/rates.csv?base=usd"es=eur,gbp")
Bạn nhận được một frame date,base,quote,rate, mỗi tiền tệ đích một dòng.
Quy đổi số tiền
CSV cho bạn tỷ giá, không phải tổng số tiền đã quy đổi. Hãy nhân số tiền với cột rate. Để lấy một giá trị đơn lẻ mà không cần pandas, hãy gọi endpoint tỷ giá phẳng bằng requests:
import requests
rate = requests.get("https://api.frankfurter.dev/v2/rate/usd/eur").json()["rate"]
total = 100 * 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 duy nhất, giúp phân tích có thể kiểm toán được: nhiều khu vực pháp lý yêu cầu dùng tỷ giá do chính ngân hàng trung ương của họ công bố khi quy đổi các khoản ngoại tệ.
df = pd.read_csv("https://api.frankfurter.dev/v2/rates.csv?base=usd"es=eur&providers=ecb")
ECB- Tỷ giá tham chiếu của Ngân hàng Trung ương châu Âu, chuẩn cho VAT và hải quan EU.
NBP- Narodowy Bank Polski. VAT và thuế thu nhập doanh nghiệp (CIT) của Ba Lan quy đổi theo tỷ giá NBP.
CNB- Tỷ giá fixing của Ngân hàng Quốc gia Séc, dùng cho kế toán và thuế tại Séc.
BCB- PTAX của Banco Central do Brasil, tham chiếu cho hợp đồng và thuế tại Brazil.
BANXICO- Tỷ giá FIX của Banco de México để thanh toán các nghĩa vụ bằng đô la Mỹ.
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.
Chuỗi lịch sử
Dùng from cho khoảng ngày và group=month để có một dòng mỗi tháng. Phân tích cột ngày và đặt nó làm chỉ mục, rồi vẽ biểu đồ hoặc resample. Lịch sử tổng hợp có thể thay đổi nhẹ khi có dữ liệu mới, vì vậy hãy cố định một nguồn cho mọi thứ bạn cần tái lập.
df = pd.read_csv(
"https://api.frankfurter.dev/v2/rates.csv?from=1949-12-01&base=usd"es=gbp&providers=bbk&group=month",
parse_dates=["date"],
index_col="date",
)
df["rate"].plot()
Truy vấn này lấy tỷ giá đô la Mỹ so với bảng Anh từ năm 1949 trong kho lưu trữ của Deutsche Bundesbank. Bạn có thể thấy mức neo 2,80 đô la của đồng bảng đứng yên nhiều năm rồi vỡ vào năm 1967. Dữ liệu lịch sử xa đến từ các phiên fixing tại Frankfurt của Bundesbank: đô la so với mác Đức từ năm 1948, phần lớn các cặp chéo khác với đô la từ năm 1949 đến 1970. Ngân hàng Trung ương châu Âu tiếp nối từ năm 1999, nên một chuỗi hiện đại liên tục dùng tỷ giá tổng hợp mặc định hoặc providers=ecb.