Position

A financial position made up of an instrument and a holding in that instrument. This type is a good example of how new context types can be composed from existing types.

In this case, the instrument and the holding amount for that instrument are required values.

The Position type goes hand-in-hand with the Portfolio type, which represents multiple holdings in a combination of instruments.

The position schema does not explicitly include identifiers in the id section, as there is not a common standard for such identifiers. Applications can, however, populate this part of the contract with custom identifiers if so desired.

Schema

https://fdc3.finos.org/schemas/next/context/position.schema.json (github)

Type

fdc3.position

Properties

instrument (required)

type: Instrument

holding (required)

type: number

The amount of the holding, e.g. a number of shares

id

type: object

Additional Properties

type: string

One or more identifiers that refer to the position in an OMS, EMS or related system. Specific key names for systems are expected to be standardized in future.

name

type: string

An optional human-readable name for the position

Example

{
  "type": "fdc3.position",
  "instrument": {
    "type": "fdc3.instrument",
    "id": {
      "ticker": "AAPL"
    }
  },
  "holding": 2000000
}