Update Currency Rate
Adds or updates the exchange rate for a currency on a given date. If a rate already exists for that currency and date, it is overwritten.
Authentication
Every request needs both of the following:
- An authorized UserID, passed in to the request body — this is the user's cieTrade.net email.
- A Bearer Token in the Authorization header of your tool or code call. The token is found under Settings → Integration → Api Token.
The user must have Can Access cieTrade API checked under Settings → Users & Roles, and must have an email address on their user record — the create and update endpoints record that user against every change they make.
Request Example
{
"UserID": "example@email.net",
"CurrencyCode": "AUD",
"Rate": 0.70639478,
"Date": "2026-09-29"
}
Body Parameters
| Parameter | Description | Required |
|---|---|---|
UserID |
cieTrade.NET User Email. Used for Authentication and Logging. | REQUIRED |
CurrencyCode |
3-character currency code (e.g. "AUD"). Must already exist in cieTrade. | REQUIRED |
Rate |
Exchange rate to the system home currency. The value of 1 unit of the currency in the home currency (e.g. if the home currency is USD, 0.70639478 means 1 AUD = 0.70639478 USD). Must be greater than 0. Supports up to 14 decimal places. |
REQUIRED |
Date |
Date the rate applies to (e.g. "2026-09-29"). Defaults to today's date if not provided. | OPTIONAL |
Response Example
On Success [HTTP 201]:
{
"Msg": "Successfully Added Rate for Currency AUD"
}
On Error [HTTP 500/HTTP 401/HTTP 400]:
{
"ErrMsg": "Error: Currency XXX not found in cieTrade."
}