Preview what a rate change would do to the dashboard total.

POST

/api/exchange-rates/preview

const url = 'https://api.tradr.cloud/api/exchange-rates/preview';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"intent":"upsert","rate":{"baseCurrency":"example","effectiveDate":"2026-04-15","quoteCurrency":"example","rate":"example"}}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.tradr.cloud/api/exchange-rates/preview \
  --header 'Content-Type: application/json' \
  --data '{ "intent": "upsert", "rate": { "baseCurrency": "example", "effectiveDate": "2026-04-15", "quoteCurrency": "example", "rate": "example" } }'

Authed. Read-only — it stores nothing. Computes the converted total before and after a proposed rate upsert or deletion so the change can be confirmed before it is applied. exceedsThreshold marks a move large enough to be worth an explicit confirmation.

Request Body^required

application/json

One of:

object
object

object

intent

required

string

Allowed values: upsert

rate

required

object

baseCurrency

required

string

>= 3 characters <= 3 characters

effectiveDate

required

string format: date

quoteCurrency

required

string

>= 3 characters <= 3 characters

rate

required

string

Responses

200

The before/after comparison.

application/json

object

afterTotal

string

nullable

beforeTotal

string

nullable

displayCurrency

string

nullable

exceedsThreshold

boolean

Example^generated

{
  "afterTotal": "example",
  "beforeTotal": "example",
  "displayCurrency": "example",
  "exceedsThreshold": true
}

400

Validation error.

404

The rate named for deletion does not exist.

Preview what a rate change would do to the dashboard total.

Request Bodyrequired

Responses

200

Examplegenerated

400

404

Request Body^required

Example^generated