Currency Exchange Convert for Foreign Catalogue Values
Convert explicit source minor units to target minor units using a caller verified rational minor-unit rate; no FX feed or equal decimal-scale assumption. Caller independently verifies observations, reference edition, units and applicability; not a grading-service certificate, authentication, conservation treatment, actual market price or legal/insurance entitlement.
Description
Catalogue currency conversion requires an explicit rate and matching source and target minor-unit conventions.
Catalogue currency conversion requires an explicit rate and matching source and target minor-unit conventions.1
This converter applies a supplied rational rate without fetching an exchange rate or selecting one by currency name.
When to use Currency Exchange Convert for Foreign Catalogue Values
Use this tool when you need to summarize the supplied collecting records or matched observations. Prepare independently verified observations, reference edition/context, and matching units or currency basis.
How to use Currency Exchange Convert for Foreign Catalogue Values and understand its results
- Prepare independently verified observations, reference edition/context, and matching units or currency basis.
- Enter sourceValueMinor, targetMinorPerSourceMinorNumerator, targetMinorPerSourceMinorDenominator, following the field table and calculation rules below, then run the tool.
- Read targetValueMinor. For result objects, inspect the nested output fields below, including any missing evidence or selected indices.
- Correct any input issues and run again. Before using a successful result, review its units, signs, evidence coverage, and stated model or reference assumptions.
| Input field | Meaning | Value type | Requirement |
|---|---|---|---|
| sourceValueMinor | Source value minor; integer minor units in the explicit currency basis. | number | Required |
| targetMinorPerSourceMinorNumerator | Target minor per source minor numerator | number | Required |
| targetMinorPerSourceMinorDenominator | Target minor per source minor denominator | number | Required |
Require nonnegative safe-integer source value and positive safe-integer numerator and denominator. The ratio is target minor units per source minor unit, so different currency decimal scales must already be incorporated. Multiply exactly and round to target minor units with overflow checking.
targetMinor=roundMinor(sourceMinor×rateNumerator/rateDenominator) Read these symbols with the field meanings and branch or reference rules above.
| Output field | Meaning | Value type |
|---|---|---|
| targetValueMinor | Target value minor; integer minor units in the explicit currency basis. | number |
Where monetary amounts are used, keep one explicit currency and minor-unit basis; one basis point is 0.01 percent. Monetary integers and exact products must remain in JavaScript’s safe-integer range. Rational rounding uses nearest minor unit with half ties away from zero, rather than binary floating-point rounding. An input called a reference amount does not fetch or establish an actual price.
{
"input": {
"sourceValueMinor": 10001,
"targetMinorPerSourceMinorNumerator": 3,
"targetMinorPerSourceMinorDenominator": 2
},
"output": {
"targetValueMinor": 15002
}
}Limitations and assumptions
Observations, reference edition, and applicability are independently supplied. Arithmetic and reference summaries do not provide authentication, a certified grade, or an actual market price.
Missing required fields, unknown fields, wrong types, and violated calculation rules return input issues. Numeric values must be finite; nonfinite numeric outputs are rejected.
Alternative or Complementary methods
For a related task, use Inflation Adjusted Historical Stamp Price Converter: Inflation adjustment compares a historic amount using two indices on the same basis. This converter applies a supplied index ratio and rounds to currency minor units without fetching an inflation series. For a complementary step, use Catalogue Value Base Lookup by Number Entry: A catalogue base value belongs to a specific edition, currency, issue, and condition convention. This lookup returns the minor-unit amount paired with an exact supplied key, without retrieving a current catalogue.
References
Similar or alternative tools
- Inflation Adjusted Historical Stamp Price Converter
Inflation adjustment compares a historic amount using two indices on the same basis. This converter applies a supplied index ratio and rounds to currency minor units without fetching an inflation series.
- Catalogue Value Base Lookup by Number Entry
A catalogue base value belongs to a specific edition, currency, issue, and condition convention. This lookup returns the minor-unit amount paired with an exact supplied key, without retrieving a current catalogue.