Add or update an exchange rate.

POST

/api/exchange-rates

const url = 'https://api.tradr.cloud/api/exchange-rates';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"baseCurrency":"USD","effectiveDate":"2026-04-15","quoteCurrency":"EUR","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 \
  --header 'Content-Type: application/json' \
  --data '{ "baseCurrency": "USD", "effectiveDate": "2026-04-15", "quoteCurrency": "EUR", "rate": "example" }'

Authed. A rate is keyed by base, quote, and effective date, so posting the same three again replaces the value rather than adding a duplicate. Because a rate change moves historical converted totals, call the preview endpoint first if you want to show the impact before saving.

Request Body^required

application/json

object

baseCurrency

required

string

>= 3 characters <= 3 characters

Example

USD

effectiveDate

required

string format: date

quoteCurrency

required

string

>= 3 characters <= 3 characters

Example

EUR

rate

required

Positive decimal.

string

Responses

201

The stored rate.

400

Validation error

Add or update an exchange rate.

Request Bodyrequired

Example

Example

Responses

201

400

Request Body^required