FDC3 aims to provide an open standard for interoperability on the financial desktop. This includes standardized verbs to invoke actions between applications (called "intents"), a standardized data format, an OpenAPI app directory standard, and standardized API operations.
The standard currently consists of four specifications:
The specifications are informed by agreed business use cases, and implemented and used by leading financial industry participants.
See https://fdc3.finos.org for more information, including on compliance and the FDC3 charter, as well as a comprehensive API Reference. You can also take the free FDC3 Training for an introduction to FDC3's core concepts and usage.
As an open standard, FDC3 can be implemented on any platform and in any language.
All that is required is a "desktop agent" that supports the FDC3 standard, which is responsible for co-ordinating application interactions.
For web applications to be FDC3-enabled, they need to run in the context of an agent that makes the FDC3 API available to the application. This desktop agent is also responsible for lauching and co-ordinating applications. It could be a browser extension, web app, or full-fledged desktop container framework.
// declare FDC3-compliant data
const instrument = {
type: 'fdc3.instrument',
id: {
ticker: 'AAPL',
ISIN: 'US0378331005',
FIGI : 'BBG000B9XRY4'
}
}
// invoke an action in another application, with the required data
const result = await fdc3.raiseIntent('ViewAnalysis', instrument)
// join the red channel and broadcast data to subscribers
await fdc3.joinChannel('red')
fdc3.broadcast(instrument)
// set up a listener for incoming data
const listener = fdc3.addContextListener('fdc3.contact', contact => { })To access the APIs in your application, simply install the FDC3 npm package:
# npm
npm install @finos/fdc3
# yarn
yarn add @finos/fdc3
# pnpm
pnpm install @finos/fdc3Note that the web application still needs to run in the context of an FDC3 desktop agent to work. For more details, please see the relevant documentation.
FDC3 can be accessed either via the global window object:
if (window.fdc3) {
const channel = await window.fdc3.getOrCreateChannel('myChannel')
channel.broadcast({ ... })
}Or by importing relevant FDC3 functions with ES6 module syntax:
import { getOrCreateChannel } from '@finos/fdc3'
// will throw if window.fdc3 is not available
const channel = await getOrCreateChannel('myChannel')
channel.broadcast({ ... })The FDC3 standard does not define wire formats for communication. Hence, for native applications to be FDC3-enabled, they need to make use of a library (e.g. a DLL in .Net or Jar file in Java) that provides them with an implementation of the FDC3 API. FDC3-enabled native applications are therefore specific to particular desktop container frameworks (or other suitable environments) that provide the necessary libraries.
Despite this limitation, implementing support for FDC3 in a native application can allow it to interact with a wide variety of FDC3-enabled web applications.
- Publish versioned NPM packages to ease adoption and implementation of FDC3 APIs.
- Release version 1.2 of the standard with expanded API capabilities.
- Establish a process to accelerate community-contributed context data definitions.
- Release version 2.0 of the standard with support for app instances, two-way data flow and joining multiple channels.
- Improve the app directory specification, with support for container-agnostic app manifests, and more type metadata around channels and launching apps.
- Introduce a hosted app directory example with sample application definitions.
- Continue building out business use cases to inform future versions of the FDC3 Standard.
If you are an existing individual or corporate user of the FDC3 standard, we would love to hear from you: just email fdc3@finos.org with details about how you are using the standard.
If you'd like to be listed as a user of the standard, you can directly send a pull request to update the FDC3 website: upload your logo to this folder and update this file with your company's details. If listing your logo publicly requires legal evaluation, you can reach out privately to FDC3 Maintainers.
FDC3 activity primarily happens in this FDC3 GitHub repository. Watch the repository in order to be notified of new Pull Requests and issues.
The fastest and more interactive way to connect and ask questions to the FDC3 community is to join the #fdc3 channel on the FINOS slack.
If you'd like to receive official updates, and/or you don't have access to Slack, please send an email to fdc3@finos.org. You can join the list by sending an email to fdc3+subscribe@finos.org.
Finally, another great way to interact with the community, is to attend the monthly FDC3 Standard Working Group Meeting and/or the quarterly FDC3 General Meeting: email help@finos.org to be added to the meeting invite directly, or find the meeting in the FINOS Community Calendar.
Email fdc3@finos.org if you need help getting started in the FDC3 Community. If you encounter technical difficulties accessing repositories, joining Slack, mailing lists or meetings, please email help@finos.org.
Email fdc3@finos.org if you would like to become an FDC3 Participant, Editor or Maintainer. For more details on FDC3's governance please see our Governance document.
FDC3 Participants are those that make and have made contributions to the FDC3 Standard Working Group. The FDC3 Standard Working Group has the specific purpose of defining and releasing subsequent updates to the standard.
If you would like to formally enroll as a voting participant to the standard (as described in our standards governance), please email fdc3-participants+subscribe@finos.org making your intent to participate in the standard process explicit. Please note that standard participants are bound to the provisions in the FINOS IP Policy as described in the FINOS standards governance.
Upon enrollment as an FDC3 voting participant, you will be invited to join the FINOS GitHub organization and the fdc3-participants GitHub team.
FDC3 Editors are responsible for ensuring that the contents of the document accurately reflect the decisions that have been made by the group, and that the specification adheres to formatting and content guidelines. The appointment of an Editor is approved by the FDC3 Standards Working Group Participants.
FDC3 Maintainers are responsible for organizing activities around developing, maintaining, and updating the specification developed by the FDC3 Standard Working Group. Maintainers are also responsible for determining consensus and coordinating appeals, as well as FDC3-related planning and communications. The appointment of a Maintainer is approved by the FDC3 Standards Working Group Participants.
You can contact the FDC3 maintainers by sending an email to fdc3-maintainers@finos.org.
An archive of FDC3 documentation and meeting notes is available at https://finosfoundation.atlassian.net/wiki/spaces/FDC3/overview. The mailing list archive for fdc3@finos.org is available at https://groups.google.com/a/finos.org/g/fdc3
If you'd like to contribute to the FDC3 standard, or have noticed something that needs correcting, the first step is to raise an issue on the FDC3 Github Repo and describe what you'd like to see changed. There are a number of issue templates that you can choose from here.
Issues that change the Standard usually need discussion. You can post comments directly on the issue or can ask for it to be added to a Standards Working Group meeting agenda by emailing fdc3@finos.org, sending a message to the #fdc3 channel on the FINOS slack or tag the FDC3 maintainers (@finos/fdc3-maintainers) in your issue.
To implement changes in the FDC3 repository resolving an issue please read our contribution guidelines.
Contributions merged into the master branch of the FDC3 repository will form part of the next pre-draft of the FDC3 Standard (as defined by the FDC3 Governance document), which must be approved by the Standard Working Group voting participants before it is accepted as a draft and subsequently released as the next version of the Standard.
NOTE: Commits and pull requests to FINOS repositories will only be accepted from those contributors with an active, executed Individual Contributor License Agreement (ICLA) with FINOS, OR who are covered under an existing and active Corporate Contribution License Agreement (CCLA) executed with FINOS. Commits from individuals not covered under an ICLA or CCLA will be flagged and blocked by the Linux Foundation EasyCLA tool. Please note that some CCLAs require individuals/employees to be explicitly named on the CCLA.
Need an ICLA? Unsure if you are covered under an existing CCLA? Email help@finos.org.
Copyright 2017-2022 FINOS and FDC3 Participants
Version 1.0 of the FDC3 specification is licensed under the FDC3 1.0 Final Specification License.
Subsequent FDC3 specifications and draft specifications are subject to the FINOS IP Policy, which authorizes implementation of FDC3 specifications without charge, on a RAND basis, subject to the terms of the policy. For details of the IP commitments made by contributors to FDC3, please refer to the policy.
Reference implementations and other software contained in FDC3 repositories is licensed under the Apache License, Version 2.0 unless otherwise noted. SPDX-License-Identifier: Apache-2.0.