Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Wise comparison API

The comparison API can be used to request price and speed information about various money transfer providers. This includes not only Wise but other providers in the market.Price Estimation {% #comparison-price-estimation .title-3 .m-t-5 %}The quotes (price and speed) provided by this API are based off of real quotes collected from 3rd party websites. We collect both the advertised exchange rate and fee for each provider for various amounts. When a comparison is requested, we calculate the markup percentage of the collected exchange rate on the mid-market rate at the time of collection. We then apply this markup to the current mid-market rate to provide a realistic estimate of what each provider offers. We collect data for all providers around once per hour to ensure we provide as accurate and up-to-date information as possible.Note: Today, we only provide estimations for FX transactions with a Bank Transfer pay-in and pay-out option. This is important to stress as many providers offer significantly different fees and exchange rates when used debit/credit card, cash etc.For more details on the data collection process please see the following page:[https://wise.com/gb/compare/disclaimer](https://wise.com/gb/compare/disclaimer)If you have questions or suspect any data to be inaccurate or incomplete please contact us at: [comparison@wise.com](mailto:comparison@wise.com)Delivery Estimation {% #comparison-delivery-estimation .title-3 .m-t-5 %}Similar to price, we collect speed data for most (if not all) providers which we have price information for. Many providers display speed estimates to their customers in a number of different ways.Some examples:- "The transfer should be complete within 2-5 days"- "The money should arrive in your account within 48 hours"- "Should arrive by 26th Aug"- "Could take up to 4 working days"The below API intends to model these in a consistent format by providing a minimum and maximum range for all delivery estimations. An estimate that states "up to X" will have "max" set to a duration but "min" as null; "from X" will have "min" set to a duration and "max" as null. Finally, for those providers who offer a specific, point in time estimation (like Wise), the API will surface a duration where "min" and "max" are equal.Quotes structure {% #comparison-quotes-structure .title-3 .m-t-5 %}In order to provide the most flexible and accurate data for clients, we surface a denormalized list of quotes per provider where each quote represents a unique collection of comparison "dimensions".A single given provider may expose multiple quotes for the same currency route. The most common example is where a provider offers different pricing for two different countries which use the same currency, e.g.:Provider X:- GBP EUR 1000 [GB -> ES] fee: 10, rate: 1.5- GBP EUR 1000 [GB -> DE] fee: 8, rate: 1.5- GBP EUR 1000 [GB -> FR] fee: 10, rate: 1.35The same principle applies for speed, i.e. a provider may have different speed estimates for different target countries. Hence, we expose these as discrete quotes, where a quote is a unique combination of route, country, speed and price factors.A client may choose to reduce this set of quotes down to a single or several quotes in order to display a relevant quote to a given user. An example where we take the cheapest quote for a given currency route (and also surface the target country) can be seen at the below link:[https://wise.com/gb/compare/?sourceCurrency=GBP&targetCurrency=EUR&sendAmount=1000](https://wise.com/gb/compare/?sourceCurrency=GBP&targetCurrency=EUR&sendAmount=1000)

Wise comparison API is one of 47 APIs that Wise publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include comparison. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an AsyncAPI specification.

This API exposes 2 operations across 2 paths, and defines 2 schemas. It is described by OpenAPI 3.1.0.

Requests are made against 2 base URLs: https://api.wise.com, https://api.wise-sandbox.com.

2 operations 2 paths 2 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
Base URL
https://api.wise.com/v2
Authentication
HTTP Bearer, HTTP Bearer, HTTP Bearer, HTTP Basic
Resource Areas
1

Authentication & Security 4

Wise comparison API declares 4 security schemes for authenticating requests. It accepts HTTP bearer tokens (JWT) (UserToken). It accepts HTTP bearer tokens (JWT) (PersonalToken). It accepts HTTP bearer tokens (JWT) (ClientCredentialsToken). It accepts HTTP basic authentication (BasicAuth).

  • UserToken — User Access Token for making API calls on behalf of a Wise user. Can be obtained via two OAuth 2.0 flows: - registrationcode grant: For partners creating users…
  • PersonalToken — Personal API Token for individual personal or small business users. Generated from Wise.com Settings Connect and manage apps API tokens. Has limited API access…
  • ClientCredentialsToken — Application-level token for partner operations that don't require a specific user context, such as bulk settlement and card spend controls. Obtained via POST /…
  • BasicAuth — Basic Authentication using your Client ID and Client Secret as the username and password. Client credentials are provided by Wise when your partnership begins.…

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.

comparison 2

The comparison API can be used to request price and speed information about various money transfer providers. This includes not only Wise but other providers in the market. Price…

GET
/v3/comparisonsdeprecated
Request a comparison quote (V3)
comparisonGetV3 15 params → 200429
GET
/v4/comparisons
Request a comparison quote
comparisonGet 19 params → 200429

Schemas 2

The contract defines 2 schemas that model the data the API accepts and returns. The most detailed are ComparisonV3 (9 properties), Comparison (9 properties). Each schema is shown below with its type and property counts.

Comparison
object
V4 comparison response containing price and speed estimates from various money transfer providers.
9 properties
ComparisonV3
object
V3 comparison response containing price and speed estimates from various money transfer providers.
9 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wise-comparison-api-openapi.yml Raw ↑

Other APIs Wise publishes across the network.

Wise 3ds API
Wise activity API
Wise address API
Wise balance API
Wise balance-statement API
Wise bank-account-details API
Wise batch-group API
Wise bulk-settlement API
Wise card API
Wise card-kiosk-collection API
Wise card-order API
Wise card-sensitive-details API