Free FX Data API
Selection and Integration Guide免费外汇数据 API
选择与接入指南
Find a free FX data API, compare the limits and data semantics that matter, test a JSON request, and validate the result before your app depends on it.
查找免费的外汇数据 API，比较真正影响使用的数据口径与限制，测试 JSON 请求，并在应用依赖该接口前完成校验。
Free FX data API: what to look for first免费外汇数据 API：先检查哪些条件
A useful free FX API exposes a documented HTTPS endpoint, identifies the base and quote currencies, returns a source timestamp, and explains its source, update frequency, quota, authentication, license, and error behavior. “Free” can mean a public endpoint, a limited plan, or a trial, so verify the current documentation before building a dependency.
可用的免费外汇接口应提供有文档的 HTTPS 端点，明确基准币与目标币，返回来源时间，并说明数据来源、更新频率、额度、认证、许可和错误结构。“免费”可能指公共端点、限额套餐或试用，因此建立依赖前必须核对最新文档。
| Need需求 | Verify检查 | Common mismatch常见错配 |
|---|---|---|
| Current conversion当前换算 | Latest timestamp and base rules最新时间与基准币规则 | Daily reference rate presented as live把日频参考价当成实时价 |
| App or dashboard应用或看板 | Quota, CORS, caching, status page额度、CORS、缓存与状态页 | Trial mistaken for a permanent free tier把试用当成长期免费层 |
| Trading use交易用途 | Bid/ask, latency, venue, license买卖价、延迟、场所与许可 | Midpoint used as an executable quote把中间价当成可成交报价 |
Define the job before choosing a free currency exchange API选择免费汇率 API 前先定义任务
Current exchange rates or live forex data?需要当前汇率还是实时外汇行情？
“Latest” may mean a daily central-bank reference, an hourly aggregate, a delayed market snapshot, or an intraday quote. For accounting, display, checkout, alerts, or trading research, document the maximum acceptable data age and whether you need a midpoint or bid and ask.
“最新”可能是央行日频参考价、小时聚合价、延迟市场快照或盘中报价。用于会计、展示、结账、告警或交易研究时，应先写明可接受的数据时效，以及需要中间价还是买卖价。
Currency pairs, base currency, and ISO 4217 codes币种对、基准币与 ISO 4217 代码
Confirm supported fiat currencies, restricted base currencies, direct versus derived crosses, decimal precision, and pair direction. Use the ISO 4217 currency code standard when normalizing identifiers.
确认支持的法币、受限基准币、直接或推导交叉盘、小数精度与币种对方向。统一标识符时可参考 ISO 4217 币种代码标准。
Latest, conversion, and historical endpoints最新、换算与历史端点
The dominant SERP pages repeatedly expose latest rates, pair conversion, supported-currency lists, and historical endpoints. This page targets current and general FX API selection; browse the QVeris Guides Hub for separate date-range and historical-data guidance.
当前结果页反复出现最新汇率、币种换算、支持币种列表与历史端点。本页聚焦当前与通用外汇 API 的选择；按日期或区间查询可浏览 QVeris 指南中心中的独立历史数据指南。
How to compare free forex API options如何比较免费外汇 API
| Criterion维度 | Question问题 | Evidence to keep保留证据 |
|---|---|---|
| Freshness时效 | How often is the source updated?来源多久更新一次？ | Source timestamp and retrieval time来源时间与抓取时间 |
| Free access免费权限 | Keyless, quota, trial, or attribution?无密钥、额度、试用还是署名？ | Plan page and terms date套餐页与条款日期 |
| Provenance来源链 | Central bank, market feed, or aggregate?央行、市场源还是聚合价？ | Methodology and provider field方法说明与供应商字段 |
| Operations运行 | Timeouts, limits, status, versioning?超时、限频、状态与版本？ | Headers, errors, and status URL响应头、错误与状态页 |
| Rights权利 | Caching, commercial use, redistribution?缓存、商用与再分发？ | License and attribution rules许可与署名规则 |
A free exchange rate API without an API key无 API 密钥的免费汇率接口
Keyless access reduces setup, but it does not imply unlimited calls, guaranteed availability, unrestricted commercial use, or permission to redistribute data. Check rate-limit headers, attribution, acceptable use, and a recovery plan.
无密钥能减少配置，但不代表无限调用、可用性保证、无限制商用或允许再分发。仍需检查限频响应头、署名、可接受使用政策与恢复方案。
Choose the right FX data source and rate type选择正确的外汇数据源与汇率类型
API features are only useful when the underlying rate matches the job. Before comparing request limits or SDKs, identify whether the provider returns an official reference series, an aggregated midpoint, a delayed market snapshot, or venue-specific bid and ask prices. Two valid APIs can disagree because they observe different markets, fixing times, contributors, and calculation rules.
只有底层汇率口径符合任务，API 功能才有意义。比较请求额度或 SDK 前，应先确认供应商返回的是官方参考序列、聚合中间价、延迟市场快照，还是特定交易场所的买卖价。两个都有效的接口可能因为市场、定盘时间、报价来源和计算规则不同而出现差异。
| Source type来源类型 | What it represents代表什么 | Suitable uses适合场景 | Watch for注意事项 |
|---|---|---|---|
| Central-bank reference央行参考汇率 | A scheduled official fixing or reference value按计划发布的官方定盘或参考值 | Reporting, statistics, reconciliation报表、统计、对账 | Business-day schedule and limited intraday freshness工作日发布，盘中时效有限 |
| Aggregated midpoint聚合中间价 | A calculated value from one or more contributors由一个或多个报价来源计算的数值 | Displays, estimates, general conversion展示、估算、通用换算 | Methodology, source disclosure, and delay计算方法、来源披露与延迟 |
| Market bid and ask市场买价与卖价 | Observable quotes at a stated venue or feed指定场所或数据源的可观察报价 | Trading analysis and valuation交易分析与估值 | Latency, entitlement, spread, and redistribution延迟、授权、点差与再分发 |
| Derived cross rate推导交叉汇率 | A pair calculated through an intermediate currency通过中间币种计算得到的币种对 | Broad pair coverage扩展币种对覆盖 | Rounding, path choice, and source consistency舍入、计算路径与来源一致性 |
Midpoint, bid, ask, open, high, low, and close中间价、买价、卖价与 OHLC
A single rate field is ambiguous unless the documentation defines it. A trading-oriented feed may provide bid, ask, midpoint, and OHLC values for an interval, while a conversion API may expose one reference value. Store the rate type with every observation so downstream code does not treat a midpoint as an executable price.
如果文档没有定义，单独一个 rate 字段存在歧义。交易类数据源可能提供买价、卖价、中间价以及某个周期的 OHLC，而换算接口可能只返回一个参考值。应为每条观测保存汇率类型，避免下游代码把中间价当成可成交价格。
Base currency restrictions and cross-rate calculations基准币限制与交叉汇率计算
Some free plans allow only one base currency. Converting through that base can expand coverage, but it introduces two observations, extra rounding, and a dependency on consistent timestamps. Record whether a pair was supplied directly or derived, the calculation path, and the precision used.
部分免费套餐只允许一个基准币。通过该基准币换算可以扩大覆盖，但会引入两条观测、额外舍入，并依赖时间戳一致性。应记录币种对是直接返回还是推导得到、计算路径以及采用的精度。
Test a free FX data API JSON response测试免费外汇数据 API 的 JSON 响应
Provider-neutral latest-rates request与供应商无关的最新汇率请求
GET /latest?base=USD&symbols=EUR,JPY
Accept: application/json
{
"base": "USD",
"timestamp": "SOURCE_TIMESTAMP",
"rates": {
"EUR": "RATE_VALUE",
"JPY": "RATE_VALUE"
}
}The endpoint and values are placeholders, not claims about a provider or current market rates. Replace them with the selected API documentation, then verify direction, timestamp, numeric type, missing symbols, and error behavior.
端点与数值均为占位示例，不代表任何供应商或当前市场汇率。请按选定接口文档替换，并校验方向、时间戳、数值类型、缺失币种和错误行为。
Fields a production response should make unambiguous生产响应中应明确的字段
| Field字段 | Validation校验要求 |
|---|---|
base / quote | Valid currency identifiers with an explicit pair direction有效币种标识，并明确币种对方向 |
rate / rates | Positive decimal values with a documented rate type and precision正数十进制值，并说明汇率类型和精度 |
timestamp | Source observation time, timezone, and freshness—not only server response time来源观测时间、时区与时效，而不只是服务器响应时间 |
source | Provider or methodology identifier sufficient for provenance足以追溯来源的供应商或方法标识 |
success / error | Machine-readable error code, message, and retry classification机器可读的错误码、错误信息及可重试性分类 |
Integration checklist for a free currency API免费汇率接口接入清单
- Validate base and quote codes before sending the request.
- Set an explicit timeout and handle 4xx, 5xx, and rate-limit responses separately.
- Store the source timestamp, retrieval time, provider, and raw response checksum.
- Use decimal arithmetic and make cache or database writes idempotent.
- Alert on stale timestamps, schema changes, missing pairs, and quota exhaustion.
- 发送请求前校验基准币与目标币代码。
- 设置明确超时，分别处理 4xx、5xx 与限频响应。
- 保存来源时间、抓取时间、供应商与原始响应校验值。
- 使用十进制运算，并让缓存或数据库写入具备幂等性。
- 对陈旧时间戳、结构变化、缺失币种对与额度耗尽告警。
Validate FX data before production use外汇数据用于生产前的校验
Reference rates are not executable prices参考汇率不是可成交价格
A midpoint or official reference rate does not include a bank spread, card fee, slippage, or a venue-specific bid and ask. Label the data accurately and do not present it as an execution guarantee.
中间价或官方参考价不包含银行点差、银行卡费用、滑点或特定交易场所的买卖价。应准确标注数据口径，不能将其描述为成交保证。
Freshness, continuity, and outlier checks时效、连续性与异常值检查
Reject non-positive or malformed rates, detect stale source timestamps, compare reciprocal pairs within a defined tolerance, and classify missing observations. A second source can trigger review, but should not silently manufacture a replacement value.
拒绝非正数或异常结构，检测陈旧来源时间，在设定容差内比较倒数币种对，并分类缺失观测。第二来源可触发复核，但不应静默创造替代值。
Quota-aware caching and refresh design感知额度的缓存与刷新设计
Match cache duration to the provider’s actual update schedule. Calling a daily reference endpoint every minute wastes quota without improving freshness. Keep a short-lived stale-on-error window for non-critical displays, but expose the observation timestamp so users and downstream services can distinguish cached data from a fresh response.
缓存时间应与供应商的实际更新计划匹配。每分钟调用一次日频参考接口只会浪费额度，不会提升时效。非关键展示可在接口出错时短暂沿用旧数据，但必须展示观测时间，让用户和下游服务能够区分缓存数据与最新响应。
Retries, circuit breakers, and provider fallback重试、熔断与供应商回退
Retry only transient failures with exponential backoff and jitter. Do not retry invalid currencies, authentication failures, or exhausted monthly quotas as if they were network timeouts. A fallback provider must be normalized to the same pair direction, timestamp rules, and rate type before its values can replace the primary source.
只对暂时性故障使用带随机抖动的指数退避。无效币种、认证失败或月度额度耗尽不能当作网络超时反复重试。备用供应商的数据必须先统一币种对方向、时间戳规则和汇率类型，才能替代主数据源。
Licensing, attribution, and redistribution许可、署名与再分发
Free access to an endpoint does not automatically grant the right to cache indefinitely, publish a bulk download, resell the data, or remove attribution. Keep the terms version and review date with the integration record, and re-check them before changing how the data is displayed or distributed.
免费访问端点并不自动授予无限期缓存、公开批量下载、转售数据或移除署名的权利。应在接入记录中保存条款版本和复核日期，并在改变数据展示或分发方式前重新检查。
How QVeris helps you find a free FX data APIQVeris 如何帮助查找免费外汇数据 API
QVeris helps developers and agents discover and inspect callable capabilities. Use the QVeris Tool Finder to find relevant capabilities, inspect their inputs and outputs, then follow the QVeris documentation to connect them. QVeris can reduce discovery and schema-inspection work; it does not change a provider’s rates, license, quota, or service level.
QVeris 帮助开发者与 Agent 发现并检查可调用能力。可通过 QVeris 工具查找器寻找相关能力，检查输入输出，再按 QVeris 文档完成接入。QVeris 能减少发现与结构检查工作，但不会改变供应商的汇率、许可、额度或服务水平。
Free FX API questions免费外汇 API 常见问题
Yes. Public endpoints and free plans exist, but freshness, coverage, source, attribution, and quotas differ.
Yes, for reference rates and some market data. Verify whether the response is daily, delayed, intraday, midpoint, or bid/ask.
There is no universal best option. Match the provider to required pairs, freshness, source, quota, rights, and reliability.
Some endpoints are keyless, but they may require attribution, enforce limits, or restrict redistribution.
Do not treat a search converter as an official supported API. Choose a documented endpoint with explicit terms.
Not necessarily. “Latest” may be daily, hourly, delayed, or intraday; inspect the source timestamp and methodology.
有，但公共端点和免费套餐在时效、覆盖、来源、署名和额度上不同。
有，既有参考汇率接口，也有部分市场数据接口。使用前应确认返回的是日频、延迟、盘中、中间价还是买卖价。
没有适合所有场景的最佳选择。应根据所需币种对、时效、来源、额度、使用权利和可靠性选择供应商。
部分接口无需密钥，但仍可能要求署名、实施限频或限制数据再分发。
不要把搜索结果中的换算器当成官方支持的 API。应选择文档完整、使用条款明确的接口。
不一定。“最新”可能代表日频、小时、延迟或盘中数据，应检查来源时间戳和计算方法。