Wise 汇率 API 详解：如何获取 Wise 汇率，以及何时应该换一个方案

如果你曾尝试在自己的产品里展示 Wise 的汇率，多半已经发现 Wise 汇率 API 并不是你以为的那个东西。Wise 确实发布了非常优质的中间市场汇率数据，也确实通过 REST 端点对外提供——但它藏在合作伙伴审核流程之后，它活在一个支付 API 里而不是行情数据 API 里，而且你拿到的汇率被刻意设计成不是你的用户实际支付的价格。

本文讲清楚 Wise 到底开放了什么、如何鉴权、每个端点实际返回什么，以及决定 Wise 是否适合你项目的五个结构性限制。文章也会诚实回答大多数人真正想问的问题：如果你只是需要在应用里拿到可靠的中间市场汇率，Wise 是合适的工具吗？

Wise 汇率 API 究竟是什么

Wise 是一家跨境汇款公司。它的 API——品牌名为 Wise Platform——是为「搬运资金」而建的：创建报价、登记收款人、为转账注资、对账余额、发行卡片。汇率之所以出现在这个 API 里，是因为不知道汇率就无法为一笔转账定价，而不是因为 Wise 在卖行情数据。

这个定位几乎解释了开发者遇到的所有意外。汇率只是支付平台里的一个小模块，并且被限制在 Wise 实际支持的货币通道范围内。

三个独立接口，三条不同的接入路径

最大的困惑来源在于：「Wise 汇率 API」至少指三件不同的事。

1. GET /rates —— 汇率端点。返回 Wise 对某一货币对的中间市场汇率，可取当前值或历史值。大多数人说的就是它。
2. POST /quotes —— 报价端点。返回一笔已定价的转账：汇率、手续费、预计到账时间，以及汇率过期时间戳。
3. GET /comparisons —— 比价端点。返回某条通道上 Wise 以及竞争服务商和银行的价格与速度估算。

三者写在同一份参考文档里，使用不同的鉴权方式，回答的却是完全不同的问题。选错端点，正是「为什么这个汇率和 wise.com 上显示的不一样」的常见原因。

如何获得 Wise 汇率数据的访问权限

没有自助式 API Key。接入分为两条路径：

平台合作伙伴。 你以 Wise Platform 合作伙伴身份完成入驻，使用 OAuth 2.0（client ID 与 client secret）鉴权换取令牌。/rates 参考文档写明，该端点「对非联盟合作伙伴仅支持 Bearer 鉴权」，使用 User Token 或 Personal Token。

联盟（affiliate）合作伙伴。 你先加入 Wise 联盟计划，然后写邮件到 partnerwise@wise.com 申请凭据。Wise 会审核申请，通过后签发 Basic auth 凭据，解锁的恰好是两个端点：Exchange Rates List 与 Get Temporary Quote。仅此而已。

这就是分岔口。如果你在做比价站点、旅游博客小组件或金融科技营销页，联盟路径就是为你设计的。如果你在做产品功能——多币种定价、开票、一个换算页面、一份内部报表——那你是在请一个支付合作团队为你审批行情数据访问权，这对双方而言都不是这段关系应有的内容。

另外注意：Wise 把 API 版本写死在 URL 路径里。生产环境是 https://api.wise.com/2026Q3/rates，沙箱是 https://api.wise-sandbox.com/2026Q3/rates。旧版联盟文档仍在引用 api.transferwise.com 上的 /v1/rates。版本嵌在路径中意味着：只要没人负责升级，你的集成就会悄无声息地老化。

调用 Wise 汇率端点

拿到令牌后，端点本身简洁且设计良好。文档给出了四种调用形式：

# Latest rates for every supported currency
curl -X GET 'https://api.wise.com/2026Q3/rates' \
  -H 'Authorization: Bearer <YOUR_TOKEN>'

# Latest rate for a single pair
curl -X GET 'https://api.wise.com/2026Q3/rates?source=EUR&target=USD' \
  -H 'Authorization: Bearer <YOUR_TOKEN>'

# Rate at a specific historical moment
curl -X GET 'https://api.wise.com/2026Q3/rates?source=EUR&target=USD&time=2019-02-13T14:53:01' \
  -H 'Authorization: Bearer <YOUR_TOKEN>'

# A time series, grouped by day, hour or minute
curl -X GET 'https://api.wise.com/2026Q3/rates?source=EUR&target=USD&from=2019-02-13&to=2019-03-13&group=day' \
  -H 'Authorization: Bearer <YOUR_TOKEN>'

响应是一个数组，每个时间区间对应一个对象：

[
  {
    "rate": 1.166,
    "source": "EUR",
    "target": "USD",
    "time": "2018-08-31T10:43:31+0000"
  }
]

两个细节值得标注。第一，group 接受 day、hour 或 minute——分钟级历史数据相当慷慨，对回测确实有用。第二，响应永远是数组，即使只查一个货币对也是如此，解析时要注意：

import requests

TOKEN = "<YOUR_TOKEN>"
BASE = "https://api.wise.com/2026Q3"

def wise_rate(source: str, target: str) -> float:
    r = requests.get(
        f"{BASE}/rates",
        params={"source": source, "target": target},
        headers={"Authorization": f"Bearer {TOKEN}"},
        timeout=10,
    )
    r.raise_for_status()
    payload = r.json()
    if not payload:
        raise LookupError(f"No rate returned for {source}/{target}")
    return payload[0]["rate"]  # array, even for one pair

print(wise_rate("EUR", "USD"))

还有一个在实践中被充分记录的坑：如果你在同一个请求里同时发送 time 和 from/to，区间参数会胜出，time 被忽略。这导致 n8n 的 Wise 节点存在一个长期缺陷，最终靠上游补丁修复。二者只发其一，绝不同时发送。

中间市场汇率不是你的用户支付的价格

Wise 的 /rates 端点返回的是中间市场汇率（mid-market rate）——银行间市场买价与卖价的中点。这是所谓「真实」汇率，也是 Wise 的营销核心。但按定义，它也是一个没有人真正按其成交的汇率。

如果你需要知道一笔转账实际要花多少钱，你需要的是 /quotes：

curl -X POST 'https://api.wise.com/2026Q3/quotes' \
  -H 'Authorization: Bearer <YOUR_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "sourceCurrency": "GBP",
    "targetCurrency": "USD",
    "sourceAmount": 100
  }'

报价响应里带着定价逻辑真正需要的字段：rate、rateType（例如 FIXED）、rateExpirationTime、fee 明细、feePercentage，以及包含各付款方式 estimatedDelivery 的 paymentOptions 数组。它还会返回 notices——Wise 自己的文档示例就警告：客户最多同时持有三笔锁定汇率的未完成转账，超出后将回退到实时汇率。

实际影响是：报价是一个绑定在具体转账上的、短生命周期的有状态对象，不是可以定时轮询的汇率查询。如果你的场景是「在定价页展示今天的美元价格」，报价是错误的原语，汇率才是对的。如果你的场景是「精确告诉用户能收到多少」，只用汇率会高估金额。混淆这一区别，是我们在货币舍入与小数位一文中描述的那类舍入与对账偏差的常见来源。

比价 API 实际返回的是什么

比价端点是整个平台里最有意思、也最常被误解的部分。它按服务商逐一返回某条通道上银行与汇款服务的价格与速度估算：

curl -X GET 'https://api.wise.com/2026Q3/comparisons?sourceCurrency=GBP&targetCurrency=EUR&sendAmount=10000&filter=POPULAR'

在此之上构建任何东西之前，请仔细阅读 Wise 自己的方法论说明。Wise 表示：它从第三方网站采集对外公布的汇率与手续费，计算每家服务商在采集时刻相对中间市场汇率的加价幅度，随后把这个存下来的加价幅度重新应用到当前的中间市场汇率上，从而得出你收到的数字。采集大约每小时运行一次。

换句话说，这个端点给出的竞品价格是基于每小时采样推算出的建模估值，不是实时报价。Wise 把这一点讲得很明白，这值得称道——但这也意味着：凡是你需要为竞品数字负责的场景，这份数据都不适用。Wise 还把估算限制在仅银行转账的入金与出金方式，并指出许多服务商对刷卡和现金的定价差异很大。

结构上，响应是反范式化的：同一家服务商可能针对同一货币对返回多条报价，因为价格与速度会随目的地国家而变。你拿到的是一个 providers 数组，每项内含一个 quotes 数组；把它归约成每家服务商一个代表数字，是你的工作，不是 API 的工作。

在 Wise 汇率上构建之前要知道的五个限制

1. 接入是一段商业关系，不是一次注册。 联盟审批或 Platform 入驻是每一次汇率调用的前置条件。没有哪个控制台能让你三十秒生成一把 Key。
2. 覆盖范围跟着汇款通道走。 Wise 支持它能搬运资金的货币。专门的数据服务商覆盖的是它能定价的货币，范围更广——Finexly 覆盖 170 多种货币，包括一些根本不存在汇款通道的货币。
3. 汇率只是支付 API 里的一个模块。 它周围是报价、收款人、KYC、卡片和 Webhook。当你只想要一个数字时，这是一套庞大且对安全高度敏感的集成负担。
4. 没有公开配额。 /rates 参考文档记录了 429 响应，却没有公布公开的请求额度，于是你只能对着一个未言明的上限做容量规划。与之相对的是显式模型：每个响应里都带着配额头部。
5. 每次调用两种货币。 /rates 只接受一个 source 和一个 target。为八种货币定价意味着八次调用，或者全表拉取后在客户端过滤。

以上都不是缺陷。当你把一个支付 API 当作数据 API 使用时，它本来就长这样。

什么时候该选 Wise，什么时候不该

改用专用汇率 API

数据 API 把权衡关系反转过来：不需要入驻沟通、覆盖更广、配额显式，响应里除了汇率什么都没有。

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.finexly.com/v1/rate?from=EUR&to=USD"

{ "pair": "EUR_USD", "rate": 1.0852 }

为一个页面上的多种货币定价，只需一次往返，而不是每个货币对一次调用：

const apiKey = process.env.FINEXLY_API_KEY;

async function priceTable(base, quotes) {
  const q = quotes.map((c) => `${base}_${c}`).join(',');
  const res = await fetch(`https://api.finexly.com/v1/convert?q=${q}`, {
    headers: { Authorization: `Bearer ${apiKey}` },
  });
  if (!res.ok) throw new Error(`Finexly ${res.status}`);
  return res.json();
}

const rates = await priceTable('USD', ['EUR', 'GBP', 'JPY', 'CAD', 'AUD']);
// { "USD_EUR": { "rate": 0.9215 }, "USD_GBP": { "rate": 0.7892 }, ... }

如果你要的是换算后的金额而不是乘数，就让 API 来做算术，让舍入只发生在一个地方：

import requests

def convert(amount, src, dst, api_key):
    r = requests.get(
        "https://api.finexly.com/v1/convert-amount",
        params={"from": src, "to": dst, "amount": amount},
        headers={"Authorization": f"Bearer {api_key}"},
        timeout=10,
    )
    r.raise_for_status()
    return r.json()["result"]

print(convert(100, "USD", "EUR", "YOUR_API_KEY"))

每个响应都带有 X-RateLimit-Limit、X-RateLimit-Used 和 X-RateLimit-Units，配额是可观测的而不是靠猜。汇率在交易时段内每分钟刷新一次。免费档提供每月 1,000 次请求、每分钟 10 次，付费方案从每月 6.99 美元 3,500 次请求起，Professional 方案可达 100,000 次——完整明细见价格页。

关于用量补一句：每月 1,000 次听起来很少，直到你开始做缓存。一个每十五分钟刷新一次完整汇率表的定时任务，每月大约消耗 2,900 次调用；每六十分钟一次约为 730 次。缓存让你的调用量变成时间的函数而不是流量的函数，这正是小额度方案能在任何规模下成立的原因。相关模式见货币 API 的缓存与错误处理。

从 Wise /rates 迁移

如果你在搬迁一个已有集成，映射关系几乎是一一对应的：

最后一点：请不要爬取 wise.com。有几个市场平台的商品页提供的正是这个，它们脆弱、法律上含糊，而且页面结构一变就会失效。如果你确实需要 Wise 的那个数字，就走联盟路径、正正当当地从 API 取。如果你只是需要一个数字，就用一个专为提供数字而建的 API。我们对免费货币 API 的对比，以及 Frankfurter 替代方案指南，对免 Key 方案有更深入的讨论。

常见问题

Wise 汇率 API 免费吗？ 汇率端点没有公布按次计费的价格，但访问权限并不开放。你必须是获批的 Wise Platform 合作伙伴或获批的联盟伙伴，这意味着一次申请与审核，而不是填一个注册表单。对多数项目而言，成本是时间，不是金钱。

没有账号能用 Wise API 吗？ 不能。两条已记录的路径都需要凭据——Platform 合作伙伴用 Bearer 令牌，联盟伙伴用 Basic auth 的 client ID 与 secret。唯一在文档示例中未带授权头的端点是 /comparisons，但据此承载生产流量并不明智。

Wise API 返回的汇率和 wise.com 显示的一样吗？ /rates 返回中间市场汇率，也就是 Wise 对外宣传的那个头条数字。客户实际收到的金额来自 /quotes，其中包含 Wise 的手续费。如果你的数字和网站对不上，几乎可以肯定你是在拿中间市场汇率去比一个已定价的报价。

Wise 的历史汇率数据能追溯多久？ 该端点接受任意 from/to 时间戳，并支持按 day、hour 或 minute 分组；Wise 在参考文档中没有公布固定的最早日期，因此请针对你需要的具体区间实测，不要假定一定有覆盖。

Wise 汇率 API 的最佳替代方案是什么？ 取决于你要替代的是什么。竞品价格比价没有替代方案——Wise 的比价 API 是独一份。若是在产品中使用中间市场汇率，专用的货币数据 API 能给你更广的覆盖、即时的 Key 和明确的配额。可在我们的 API 对比页比较各方案。

我能合法地向用户展示 Wise 的汇率吗？ 如果你是获批的联盟或 Platform 合作伙伴，可以，在该协议条款范围内。爬取公开网站以取得同样的数字则是另一回事，我们不建议在此之上建立业务。

准备好跳过合作伙伴入驻、直接拿到汇率了吗？获取你的免费 Finexly API Key——无需信用卡。从每月 1,000 次免费请求、170 多种货币起步，等流量涨了再升级。你也可以先用我们的货币换算器在浏览器里试一下。