Chart

A context type representing details of a Chart, which may be used to request plotting of a particular chart or to otherwise share details of its composition, such as:

• A list of instruments for comparison
• The time period to plot the chart over
• The style of chart (line, bar, mountain, candle etc.)
• Other settings such as indicators to calculate, or data representing drawings and annotations

In addition to handling requests to plot charts, a charting application may use this type to output a representation of what it is currently displaying so that it can be recorded by another application.

Type

fdc3.chart

Schema

https://fdc3.finos.org/schemas/next/context/chart.schema.json

Details

Property	Type	Required	Example Value
type	string	Yes	'fdc3.chart'
instruments	Instrument[]	Yes	[   {     "type": "fdc3.instrument",     "id": {       "ticker": "AAPL"     }   },   {     "type": "fdc3.instrument",     "id": {       "ticker": "MSFT"     }   } ]
range	TimeRange	No	{   "type": "fdc3.timerange",   "startTime": "2022-03-30T15:44:44+00:00",   "endTime": "2022-04-30T23:59:59+00:00" }
style	string	No	one of: 'line', 'bar', 'stacked-bar', 'mountain', 'candle', 'pie', 'scatter', 'histogram', 'heatmap', 'custom'
otherConfig*	array	No	[ {/* additional config context objects */} ]

::: info

It is common for charts to support other configuration, such as indicators, annotations etc., which do not have standardized formats, but may be included in the otherConfig array as context objects.

:::

Example

const chart = {
    type: "fdc3.chart",
    instruments: [
        {
            type: "fdc3.instrument",
            id: {
                ticker: "AAPL"
            }
        },
        {
            type: "fdc3.instrument",
            id: {
                ticker: "GOOG"
            }
        }
    ],
    range: {
        type: "fdc3.timeRange",
        startTime: "2020-09-01T08:00:00.000Z",
        endTime: "2020-10-31T08:00:00.000Z"
    },
    style: "line",
    otherConfig: [
        {
            type: "somevendor.someproduct.indicator",
            name: "stddev",
            parameters: {
                period: 10,
                matype: "exponential"
            }
        },
        {
            type: "someothervendor.someotherproduct.formula",
            formula: "standard-deviation",
            fields: {
                lookback: 10,
                type: "ema"
            }
        }
    ]
};

fdc3.raiseIntent("ViewChart", chart);

See Also

Other Types

• Instrument
• TimeRange

Intents

• ViewChart