Reference exchange rates

GET/v1/fx/reference/{base}

Mid-market rates from the merchant's currency to every other one, from ExchangeRate-API (Rates By Exchange Rate API, https://www.exchangerate-api.com), at most 48 hours old. The agent binds them into a purchase's evidence as an api.fx_reference item, commitReference of this answer, which a countersign accepts only for references the API issued in the last 6 hours. The pay-click gate checks the rate PayPal converts the charge at against them, within the mandate's fx.max_spread_bps.

Path parameters

baseAUDRequired

Responses

200The rates
503No current reference rates: a converted charge is then never paid

200 response

vstringRequired: One of keelson.fx_reference/1
providerstringRequired
sourcestringRequired
basestringRequired
as_ofstringRequired: When the provider last updated the rates.
fetched_atstringRequired
ratesobjectRequired: Units of each currency one unit of base buys, as decimal strings.

curl -X GET https://api.keelson.finance/v1/fx/reference/{base}

const res = await fetch("https://api.keelson.finance/v1/fx/reference/{base}", {
  method: "GET",
});
const data = await res.json();

Response · shape from the schema

{
  "v": "keelson.fx_reference/1",
  "provider": "string",
  "source": "string",
  "base": "string",
  "as_of": "string",
  "fetched_at": "string",
  "rates": {}
}