fx-gap-v2

Methodology

A reproducible comparison between an applicable UN Operational Rate of Exchange (UNORE) and one named observable reference. The result is decision evidence, not a transaction quote or route recommendation.

Live coverage

Tracked

32 countries

28 currencies

Comparison status

31 comparable

0 unavailable · 1 excluded

Selected-source mix

USDC 18 · USDT 9 · spot 4

Latest calculation 2026-07-13

What is compared

UNORE is used for applicable agency accounting and transactions. Whether a specific payment is converted at UNORE depends on the organisation, funding instrument and treasury process; the tracker does not assume universal use.

The selected observable reference follows the public best_available policy: USDC, then USDT, then reliable international spot FX. A P2P rate is a retail asking-price proxy. It does not demonstrate an available institutional quote, completed trade, payout method, fees, volume or compliance outcome.

Four canonical formulas

Rates use local-currency units per USD-equivalent unit. Percentage spread and cents per USD use different denominators and must not be substituted for one another.

Rate spread (%)
(reference − UNORE) / UNORE × 100
USD-equivalent gap fraction
(reference − UNORE) / reference
Cents per USD
gap fraction × 100
Difference per USD 1 million
round(gap fraction × 1,000,000)

Worked example

UNORE 621.53 and selected reference 802.33 produce 621.53 → 802.33 = 29.09% spread, 22.53¢/$, $225,344/$1M. The 29.09% rate spread is not 29.09 cents per dollar.

Sources and collection rules

UN Operational Rates of Exchange

Published by UN Treasury. The API exposes the effective date separately from the daily calculation date. SOS comparisons are excluded because the published operational rate is not a reliable benchmark for that currency in this dataset.

USDC and USDT P2P observations

Collectors request up to 20 returned ads per side from Binance and Bybit. Each platform midpoint uses the buy and sell medians. One-sided observations, fewer than 3 ads in total, or more than 25% symmetric width between the two medians are suppressed. The selected asset rate averages all included Binance and Bybit platform mids; one platform is not silently preferred over the other.

International spot FX

The provider order is ExchangeRate-API, then Open ER-API. Spot is suppressed from the selected comparison when its divergence from usable P2P evidence crosses the reliability threshold. Spot remains an international reference and may not describe an in-country route.

Public API vocabulary

Responses identify metric_version: fx-gap-v2 and selection policy best_available. CSV preserves existing columns and appends the canonical fields.

Scroll horizontally to review every column on a narrow screen.

Canonical public FX API fields and their meanings
FieldMeaning
headline_sourceSelected source key: usdc, usdt or spot.
headline_source_labelHuman-readable selected source.
headline_rateSelected observable reference rate.
headline_observed_atExact contributing observation time where provenance proves it.
headline_spread_pctRate spread using the UNORE denominator.
gap_cents_per_usdUSD-equivalent gap in cents using the reference denominator.
gap_per_million_usdRounded USD-equivalent difference per USD 1 million.
comparison_statuscomparable, unavailable or excluded.
exclusion_reasonPublic reason for unavailable or excluded rows.
estimated_value_loss_pctdeprecated compatibility field; do not use for new displays.

GET /api/fx/rates/{ISO}/provenance lists included and suppressed platform observations, liquidity status, ad counts, width, provider, timestamp and aggregation method so a selected rate can be reproduced.

Limitations and appropriate use

  • Asking prices do not include an organisation's volume, payment method, settlement path or negotiated fees.
  • Digital P2P participants are not representative of every person, merchant or locality.
  • Rates can vary within a country and over the hours between collector runs.
  • Funding exposure is illustrative only when every included funding row has one authoritative stored year.
  • Independent legal, sanctions, safeguarding, liquidity, custody and accounting review remains necessary.