Skip to main content
Version: 1.1

Portfolio

A financial portfolio made up of muliple positions (holdings) in several instruments. Contrast this with e.g. the InstrumentList type, which is just a list of instruments.

This is a good example of how types can be composed and extended with extra properties to define more complex types.

The Portfolio type consists of an array of Position types, each of which refers to a single Instrument and a holding amount for that instrument.

Notes:

  • Like all other FDC3 context types, extra properties for the portfolio can be added, the schema just specifies the minimum contract.

  • The portfolio 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.

Type

fdc3.portfolio

Schema

https://fdc3.finos.org/schemas/1.1/portfolio.schema.json

Details

PropertyTypeRequiredExample Value
typestringYes'fdc3.portfolio'
idobjectNo{ portfolioId: '7381' }
namestringNo'My share portfolio'
positionsPosition[]Yes[position1, position2]

Example

const position = {
type: 'fdc3.portfolio',
positions: [
{
type: 'fdc3.position',
instrument: {
type: 'fdc3.instrument'
id: {
ticker: 'AAPL'
}
},
holding: 2000000
},
{
type: 'fdc3.position',
instrument: {
type: 'fdc3.instrument'
id: {
ticker: 'MSFT'
}
},
holding: 1500000
},
{
type: 'fdc3.position',
instrument: {
type: 'fdc3.instrument'
id: {
ticker: 'IBM'
}
},
holding: 3000000
}
]
}

fdc3.raiseIntent('ViewAnalysis', portfolio)

See Also

Other Types

Intents

FINOS Financial Objects