/v1/latest/USD 返回包含汇率、来源和观测时间的 JSON。计算金额时使用 Decimal,避免不必要的精度误差。
- urllib 不需要额外依赖。
- requests 便于处理认证、超时和错误。
- forex-python 可以作为迁移阶段的接口。
- 把 source、effective_at 和 data_updated_at 与汇率一起保存。
- 历史数据可以用日期接口或
/v1/range。
第一次请求
标准库足以完成第一次请求。涉及金额时,用 Decimal 读取 JSON 数字。
使用带密钥的 requests
服务端代码应使用 timeout,密钥从环境变量读取,并在保存结果前检查 HTTP 状态。
从 forex-python 迁移
forex-python 使用自己的数据提供方,不会自动连接 exchangerate.dev。迁移时可以保留熟悉的调用界面,但不要丢掉 exchangerate.dev 返回的 source 和观测时间。
正确处理历史数据
日期接口可能返回没有新发布值时的延续值。/v1/range 返回保存的观测,JSON 每页最多366行。
常见问题
python · standard library
import jsonfrom decimal import Decimalimport urllib.requesturl = "https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP"with urllib.request.urlopen(url, timeout=10) as response: data = json.load(response, parse_float=Decimal)print(data["rates"]["EUR"])print(data["sources"]["EUR"], data["effective_at"]["EUR"])print(data["market_session"])python · requests
# Install first: python -m pip install requestsimport osfrom decimal import Decimalimport requestsresponse = requests.get( "https://api.exchangerate.dev/v1/latest/USD", headers={"Authorization": f"Bearer {os.environ['EXCHANGERATE_API_KEY']}"}, timeout=10, allow_redirects=False,)if response.status_code == 429: raise RuntimeError(f"Rate limited; Retry-After: {response.headers.get('Retry-After')}")if 300 <= response.status_code < 400: raise RuntimeError("Unexpected redirect")response.raise_for_status()data = response.json(parse_float=Decimal)print(data["rates"]["GBP"], data["effective_at"]["GBP"])python · convert 100 USD to EUR
import osfrom decimal import Decimalimport requestsresponse = requests.get( "https://api.exchangerate.dev/v1/convert/USD/EUR/100", headers={"Authorization": f"Bearer {os.environ['EXCHANGERATE_API_KEY']}"}, timeout=10, allow_redirects=False,)if not 200 <= response.status_code < 300: raise RuntimeError(f"HTTP {response.status_code}; Retry-After: {response.headers.get('Retry-After')}")data = response.json(parse_float=Decimal)print(data["rate"], data["converted"])python · rate on a past date
import osfrom decimal import Decimalimport requestsresponse = requests.get( "https://api.exchangerate.dev/v1/2026-03-14/USD?symbols=JPY", headers={"Authorization": f"Bearer {os.environ['EXCHANGERATE_API_KEY']}"}, timeout=10, allow_redirects=False,)if not 200 <= response.status_code < 300: raise RuntimeError(f"HTTP {response.status_code}; Retry-After: {response.headers.get('Retry-After')}")data = response.json(parse_float=Decimal)print(data["rates"]["JPY"], data["is_forward_filled"])