Trade

@experiemental context type representing a trade. To be used with execution systems.

This type currently only defines a required id field, which should provide a reference to the trade in one or more systems, an optional human readable name field to be used to summarize the trade and a required product field that may be used to provide additional detail about the trade, which is currently typed as a unspecified Context type, but product is expected to be standardized in future.

The Trade 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://github.com/finos/FDC3/tree/main/schemas/context/trade.schema.json

Type

fdc3.trade

Properties

id

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

Type: object

Example Value:

{
  "myEMS": "12345"
}

name

A human-readable summary of the trade.

Type: string

Example Value: ...

product

A product that is the subject of the trade.

Reference: product

Example Value:

{
  "type": "fdc3.product",
  "id": {
    "productId": "ABC123"
  },
  "instrument": {
    "type": "fdc3.instrument",
    "id": {
      "ticker": "MSFT"
    }
  }
}

Example

{
  "type": "fdc3.trade",
  "name": "...",
  "id": {
    "myEMS": "12345"
  },
  "product": {
    "type": "fdc3.product",
    "id": {
      "productId": "ABC123"
    },
    "instrument": {
      "type": "fdc3.instrument",
      "id": {
        "ticker": "MSFT"
      }
    }
  }
}