Currency Amount Ontology
type: Ontology
abstract: This ontology defines currency and monetary amount related concepts for use in defining other FIBO ontology elements. There are two distinct kinds of concepts that correspond to money and amounts: a concrete, actual amount of money, and the monetary measure of something denominated in some currency. These are dimensionally the same but whereas 'money amount' is defined as an amount of money, 'monetary amount' is an abstract monetary measure. The definition of currency provided herein is compliant with the definitions given in ISO 4217. ISO 4217 provides universally applicable coded representations of names of currencies and funds, used internationally for financial transaction support. The ontology has been partitioned into 2 parts: (1) the essential concept system describing the standard (this module), and (2) ISO4217-1-CurrencyCodes, which contains all of the individuals specified in ISO 4217.
license: Copyright (c) 2013-2025 EDM Council, Inc. Copyright (c) 2013-2025 Object Management Group, Inc. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. See https://opensource.org/licenses/MIT.
imports: Relations
imports: AnnotationVocabulary
imports: CodesAndCodeSets
imports: Collections
imports: ContextualDesignators
imports: Designators
imports: Documents
imports: Identifiers
imports: Locations
imports: QuantitiesAndUnits
imports: TextDatatype
version IRI: CurrencyAmount
change note: The FIBO FND 1.0 (https://spec.edmcouncil.org/fibo/ontology/FND/20141101/Accounting/CurrencyAmount.rdf) version of this ontology was modified per the additions introduced in the FIBO FBC RFC and related issue resolutions identified in the FIBO FND 1.1 RTF report and https://spec.edmcouncil.org/fibo/ontology/FND/1.0/AboutFND-1.1/, including adding support for ISO 4217 currency codes.
change note: The FIBO FND 1.1 (https://spec.edmcouncil.org/fibo/ontology/FND/20160201/Accounting/CurrencyAmount.rdf) version of this ontology was modified per FIBO 2.0 RFC, including the addition of a new hasMonetaryAmount property as a superproperty of others required by various FIBO domain teams and integration with LCC.
change note: The https://spec.edmcouncil.org/fibo/ontology/FND/20000601/Accounting/CurrencyAmount/ version of this ontology was modified to replace a redundant concept, calculation formula with formula.
change note: The https://spec.edmcouncil.org/fibo/ontology/FND/20180801/Accounting/CurrencyAmount.rdf version of this ontology was modified to include several classes to support automated inclusion of all ISO 4217 codes published as of 2018-06-04, and to revise definitions per the eighth edition of the specification.
change note: The https://spec.edmcouncil.org/fibo/ontology/FND/20181101/Accounting/CurrencyAmount/ version of this ontology was modified to use the generic statistical measures and measurements now in FND.
change note: The https://spec.edmcouncil.org/fibo/ontology/FND/20190501/Accounting/CurrencyAmount/ version of this ontology was modified to eliminate deprecated elements.
change note: The https://spec.edmcouncil.org/fibo/ontology/FND/20190901/Accounting/CurrencyAmount/ version of this ontology was modified to improve definitions for notional amount and currency identifier.
change note: The https://spec.edmcouncil.org/fibo/ontology/FND/20191201/Accounting/CurrencyAmount/ version of this ontology was modified to correct the explanatory note on currency identifier.
change note: The https://spec.edmcouncil.org/fibo/ontology/FND/20191201/Accounting/CurrencyAmount/ version of this ontology was modified to eliminate duplication with concepts in LCC, dependencies on a couple of ontologies that were unnecessary, eliminate references to external dictionary sites that no longer resolve, clean up ambiguity in definitions, eliminate a redundant property, and add unit price.
change note: The https://spec.edmcouncil.org/fibo/ontology/FND/20210201/Accounting/CurrencyAmount/ version of this ontology was modified to loosen a restriction on currency to allow for more than one numeric currency code, which was necessitated by the October 2021 update to the ISO currency code definitions.
change note: The https://spec.edmcouncil.org/fibo/ontology/FND/20220101/Accounting/CurrencyAmount/ version of this ontology was modified to move the definition of precious metal and the corresponding identifier to this ontology from Products and Services to simplify imports in cases where the broader definitions for commodities are not required and deprecated isTenderIn, given that we have used the property isUsedBy for this purpose in the currency codes themselves.
change note: The https://spec.edmcouncil.org/fibo/ontology/FND/20220201/Accounting/CurrencyAmount/ version of this ontology was modified to add a restriction to indicate the currency on percentage monetary amount, make currency a subclass of unit of measure, and deprecate the notion of monetary measure, which is more about monetary policy and was incorrectly used in a few places, and is out of scope for our current set of use cases.
change note: The https://spec.edmcouncil.org/fibo/ontology/FND/20220301/Accounting/CurrencyAmount/ version of this ontology was modified to eliminate hygiene errors with respect to text formatting.
change note: The https://spec.edmcouncil.org/fibo/ontology/FND/20220701/Accounting/CurrencyAmount.rdf version of this ontology was modified to use the Commons Ontology Library (Commons) Annotation Vocabulary rather than the OMG's Specification Metadata vocabulary.
change note: The https://spec.edmcouncil.org/fibo/ontology/FND/20230101/Accounting/CurrencyAmount.rdf version of this ontology was modified to use the Commons Ontology Library (Commons) rather than the OMG's Languages, Countries and Codes (LCC) and to eliminate redundancies in FIBO as appropriate.
change note: The https://spec.edmcouncil.org/fibo/ontology/FND/20230301/Accounting/CurrencyAmount.rdf version of the ontology was modified to eliminate deprecations that are more than 6 months old.
change note: The https://spec.edmcouncil.org/fibo/ontology/FND/20231101/Accounting/CurrencyAmount.rdf version of this ontology was modified to tease out the distinction between the nominal and notional amount, which were confused (DER-127) and to replace content that is now available in the OMG Commons Ontology Library (Commons) v1.1 (FND-380).
change note: The https://spec.edmcouncil.org/fibo/ontology/FND/20231201/Accounting/CurrencyAmount.rdf version of the ontology was modified to replace additional content that is now available in the OMG Commons Ontology Library (Commons) v1.2 (FND-389).
change note: The https://spec.edmcouncil.org/fibo/ontology/FND/20250301/Accounting/CurrencyAmount.rdf version of the ontology was modified to replace hasConstituent with hasMember for better semantic consistency (FND-396).
editorial note: (1) The present version of the ontology covers the English sections of the ISO 4217 standard only, and (2) UTF-8 character encodings are employed in names in the currency codes ontology to support the broadest number of tools.
has maturity level: Release
copyright: Copyright (c) 2013-2025 EDM Council, Inc.
copyright: Copyright (c) 2013-2025 Object Management Group, Inc.
direct source: ISO 4217 Codes for the representation of currencies and funds, Eighth edition, 2015-08-01
direct source: ISO 4217 Codes for the representation of currencies and funds, Seventh edition, 2008-07-15

amount of money
type: Class
subclass of: ScalarQuantityValue
subclass of: Restriction
  on property: has currency
  on class: currency
  qualified cardinality: 1
definition: amount of readily available cash in banknotes and coins
editorial note: This is an actual sum of money, not the measure of a sum of money in monetary units, although it has the same basic properties (decimal number with a currenct unit).
synonym: cash

calculated price
type: Class
subclass of: monetary price
subclass of: Restriction
  on property: hasExpression
  on class: Expression
  qualified cardinality: 1
definition: monetary price determined by a formula

currency
type: Class
subclass of: MeasurementUnit
subclass of: Restriction
  on property: has minor unit
  max qualified cardinality: 1
  on data range: string
subclass of: Restriction
  on property: has numeric code
  some values from: string
subclass of: Restriction
  on property: isUsedBy
  some values from: GeopoliticalEntity
subclass of: Restriction
  on property: hasTextualName
  some values from: string
definition: medium of exchange value, defined by reference to the geographical location of the monetary authorities responsible for it
definition origin: Codes for the representation of currencies and funds, ISO 4217, Eighth edition, 2015-08-01, section 3.2
synonym: currency unit
synonym: monetary unit

currency basket
type: Class
subclass of: StructuredCollection
subclass of: Restriction
  on property: hasMember
  some values from: currency
definition: selected group of currencies, in which the weighted average is used as a measure of the value or the amount of an obligation
note: A currency basket functions as a benchmark for regional currency movements; its composition and weighting depends on its purpose.
definition origin: Codes for the representation of currencies and funds, ISO 4217, Eighth edition, 2015-08-01, section 3.2

currency identifier
type: Class
subclass of: CodeElement
subclass of: Identifier
subclass of: Restriction
  on property: hasTag
  on data range: string
  qualified cardinality: 1
subclass of: Restriction
  on property: identifies
  some values from: currency
definition: sequence of characters representing some currency
adapted from: Codes for the representation of currencies and funds, ISO 4217, Eighth edition, 2015-08-01, section 3.2
explanatory note: The first (left-most) two characters of the ISO 4217 3-letter currency identifier relate to the currency authority that issues the currency, and is, in most cases the ISO 3166-1 alpha 2 code for the geopolitical entity whose central bank is the issuer. The third (right-most) character of the identifier (alphabetic code) is an indicator derived from the name of the major currency unit or fund. If the currency is not associated with a single geographical entity as described in ISO 3166-1, typically a specially allocated identifier (alpha-2 code) is used to describe the currency authority. This code has been allocated by the Maintenance Agency from within the user-assigned range of codes XA to XZ specified in 8.1.3 of ISO 3166-1:2013. The character following X will be a mnemonic, where possible, derived from the name of the geographical area concerned.

exchange rate
type: Class
subclass of: Ratio
subclass of: Restriction
  on property: has base currency
  on class: currency
  qualified cardinality: 1
subclass of: Restriction
  on property: has dealt currency
  on class: currency
  qualified cardinality: 1
subclass of: Restriction
  on property: has rate value
  on data range: decimal
  qualified cardinality: 1
definition: rate at which one currency can be exchanged for another
example: The exchange rate between the U.S. dollar and British pound is distinct from the exchange rate between the U.S. dollar and the euro.

funds
type: Class
subclass of: currency
subclass of: Restriction
  on property: has currency
  on class: currency
  qualified cardinality: 1
definition: artificial currency used as calculation basis for another currency(s) and accounting purposes
definition origin: Codes for the representation of currencies and funds, ISO 4217, Eighth edition, 2015-08-01, section 3.3

funds identifier
type: Class
subclass of: CodeElement
subclass of: Identifier
subclass of: Restriction
  on property: hasTag
  on data range: string
  qualified cardinality: 1
subclass of: Restriction
  on property: identifies
  some values from: funds
definition: sequence of characters that can be used to uniquely identify funds
adapted from: Codes for the representation of currencies and funds, ISO 4217, Eighth edition, 2015-08-01, section 3.2

interest rate
type: Class
subclass of: percentage monetary amount
subclass of: Restriction
  on property: has rate value
  on data range: decimal
  qualified cardinality: 1
definition: amount charged, expressed as a percentage of principal, in exchange for the use of assets
explanatory note: Interest rates are typically noted on an annual basis, known as the annual percentage rate (APR). The assets borrowed could include cash, consumer goods, and large assets such as a vehicle or building. The rate is derived by dividing the amount of interest by the amount of principal borrowed. Interest rates are quoted on bills, notes, bonds, credit cards, and many kinds of consumer and business loans.

monetary amount
type: Class
subclass of: ScalarQuantityValue
subclass of: Restriction
  on property: has currency
  on class: currency
  qualified cardinality: 1
subclass of: Restriction
  on property: has amount
  on data range: decimal
  qualified cardinality: 1
definition: measure that is an amount of money specified in monetary units

monetary price
type: Class
subclass of: monetary amount
subclass of: price
definition: price that that is expressed as a monetary amount
explanatory note: As the consideration given in exchange for transfer of ownership, price forms the essential basis of commercial transactions. It may be fixed by a contract, left to be determined by an agreed upon formula at a future date, or discovered or negotiated during the course of dealings between the parties involved. In commerce, price is determined by what (1) a buyer is willing to pay, (2) a seller is willing to accept, and (3) the competition is allowing to be charged.

percentage monetary amount
type: Class
subclass of: Percentage
subclass of: Restriction
  on property: has currency
  on class: currency
  qualified cardinality: 1
definition: measure of some amount of money expressed as a percentage of some other amount, some notional amount or some concrete money amount

precious metal
type: Class
subclass of: Restriction
  on property: has numeric code
  on data range: string
  qualified cardinality: 1
subclass of: Restriction
  on property: hasTextualName
  some values from: string
definition: metal that is considered to be rare and/or have a high economic value

precious metal identifier
type: Class
subclass of: CodeElement
subclass of: Identifier
subclass of: Restriction
  on property: hasTag
  on data range: string
  qualified cardinality: 1
subclass of: Restriction
  on property: identifies
  some values from: precious metal
definition: sequence of characters uniquely identifying the precious metal in some context

price
type: Class
subclass of: ScalarQuantityValue
definition: amount of money, goods, or services requested, expected, required, or given in exchange for something else

unit of account
type: Class
subclass of: currency
definition: nominal monetary unit of measure used to represent the real value (or cost) of any economic item; i.e. goods, services, assets, liabilities, income, expenses

unit of account identifier
type: Class
subclass of: CodeElement
subclass of: Identifier
subclass of: Restriction
  on property: hasTag
  on data range: string
  qualified cardinality: 1
subclass of: Restriction
  on property: identifies
  some values from: unit of account
definition: sequence of characters that can be used to uniquely identify a nominal monetary unit

unit price
type: Class
subclass of: monetary price
subclass of: Restriction
  on property: is price for
  some values from: Thing
definition: monetary price expressed in relation to a well-known measurable unit by which the goods or services are allocated
example: For example, gold is commonly measured in troy ounces, grams, etc., and oil is measured in terms of barrels.

has amount
type: DatatypeProperty
sub property of: hasNumericValue
range: decimal
definition: total number or quantity

has base currency
type: ObjectProperty
type: InverseFunctionalProperty
sub property of: has currency
range: currency
definition: specifies a unit of currency representing R units of the dealt currency, where R is the exchange rate value, in an exchange rate

has currency
type: ObjectProperty
sub property of: hasMeasurementUnit
range: currency
definition: specifies the medium of exchange value in which something, such as a monetary amount is denominated

has dealt currency
type: ObjectProperty
sub property of: has currency
range: currency
definition: specifies a unit of currency representing the exchanged (target) currency in an exchange rate; R units of this currency represent one unit of the base currency

has funds type
type: DatatypeProperty
sub property of: hasTextValue
domain: funds
range: string
definition: indicates the type of funds, such as next day for US funds

has minor unit
type: DatatypeProperty
sub property of: hasTextValue
range: string
definition: relates a code for the minor unit of currency to the currency or fund
scope note: Requirements sometimes arise for values to be expressed in terms of minor units of currency. When this occurs, it is necessary to know the decimal relationship that exists between the currency concerned and its minor unit. - 0 means that there is no minor unit for the currency; - 1, 2, and 3 signify a ratio of 10 to 1, 100 to 1 and 1000 to 1 respectively.

has monetary amount
type: ObjectProperty
sub property of: hasQuantityValue
range: monetary amount
definition: specifies a value for something in terms of an amount of money and the currency in which it is denoted

has notional amount
type: ObjectProperty
sub property of: has monetary amount
range: monetary amount
definition: has a generally unchangeable value used for certain calculations, expressed as some monetary amount
adapted from: ISO 10962:2019, Securities and related financial instruments - Classification of financial instruments (CFI) code, Fourth Edition, 2019-10, clause 6.8.2
explanatory note: For certain kinds of derivative instruments, including but not limited to swaps, the notional amount indicates face amount of a swap upon which the payment streams for that swap are based. While this is typically constant throughout the lifetime of a contract, it can be accreting, amortizing, or custom, such as in the case of a notional step schedule.
explanatory note: The notional amount (or notional principal amount or notional value) on a financial instrument is typically the face amount used to calculate payments made on that instrument. This amount generally does not change and is thus referred to as notional. When applied to a swap this is the amount used for calculating the actual value of the interest due. Also known as notional value when describing derivative contracts in the options, futures, and currency markets, this term is often used to value the underlying asset in a derivatives trade. It can be the total value of a position, how much value a position controls, or an agreed-upon amount in a contract. An example is that a firm might have a variable rate loan on $100,000 but decide to swap only $40,000. The $40,000 is the notional amount of the swap and becomes the amount on which interest is paid.

has numeric code
type: DatatypeProperty
sub property of: hasTextValue
range: string
definition: relates a numeric code to something, such as a currency or fund
scope note: In the case of currency codes, the numeric currency code is derived, where possible, from the United Nations Standard Country or Area Code. Additional codes to meet special requirements (as described in 5.1.3) and in respect of funds will be allocated as necessary from within the user-assigned range of codes 950 to 998. Funds codes are allocated in descending order commencing at 998.

has price
type: ObjectProperty
sub property of: hasQuantityValue
range: price
definition: indicates the value of something expressed as an amount of money or goods

has rate value
type: DatatypeProperty
sub property of: hasNumericValue
range: decimal
definition: has a value for a rate expressed as a number (may be a percentage or raw number)

is price for
type: ObjectProperty
sub property of: refersTo
domain: price
inverse of: has price
definition: links a price to something it provides a value for