Blotter records

This page describes the FX API’s blotter records.

This documentation is for the FX Integration API 3.29.0.

Blotter record specifications

The FX API provides builders for the following blotter records.

OrderBlotterRecord
CommonFields
CurrencyPair
string
The currency pair for the trade. For example, EURUSD
Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
AllowedActions
string
Comma separated list of Caplin supported values [Edit, Deactivate, Cancel, Activate, InactiveEdit, InactiveDeactivate, InactiveCancel, InactiveActivate]
ActivationType
string
How the order should be activated. Caplin supported statuses are [GFA, EXPLICIT]
ActivationDateTime
datetime
Example: 2013-07-24T17:13:59.985
The time and date the order will become active. This is in ISO-8601 format.
ActivationDisplayTimeZone
timezone
Example: Europe/London
The timezone that the activation time and date should be formatted to for display. This is in the TZ database format.
ExpirationType
string
How the order should be deactivated. Caplin supported statuses are [IOC, GTC, GFD, FOK, EXPLICIT]
ExpirationDateTime
datetime
Example: 2013-07-24T17:13:59.985
The time and date the order will be deactivated. This is in ISO-8601 format.
ExpirationDisplayTimeZone
timezone
Example: Europe/London
The timezone that the expiration time and date should be formatted to for display. This is in the TZ database format.
AlertType
string
The type of alert that an order will send. Caplin supported statuses are [EMAIL, SMS].
StrategyType
string
The strategy the order was submitted with. This field should not be used by the front end for structuring orders. Comma separated list of Caplin supported values are [SINGLE, IF-DONE-OCO, OCO, IF-DONE, IF-TIMEOUT, IF-DONE-LOOP, LOOP]. OTHER denotes a strategy type that is unsupported.
TraderUsername
string
TOBOUser
string
The user the trade is on behalf of. For example, if the logged in user dealer1@novobank.co.za wishes to make a trade on behalf of user bob_treasurer, then the value of this field will be bob_treasurer.
OrderCount
integer
OrderID
string
The id of the order.
ActivationDate
string
What date the strategy should be activated.
ActivationTime
string
What time the strategy should be activated if the ActivationDate was in the format of yyyymmdd.
ActivationLocation
string
Example: Europe/London
When location should be used to evaluate the time to activate if the ActivationDate was in the format of yyyymmdd.
ActivationUTCOffset
string
ExpirationDate
string
What date the strategy should expire.
ExpirationTime
string
What time the strategy should be activated if the ExpirationDate was in the format of yyyymmdd.
ExpirationLocation
string
When location should be used to evaluate the time to expire if the ExpirationDate was in the format of yyyymmdd.
ExpirationUTCOffset
string
LegFields
Editable
boolean
OrderID
string
The id of the order.
Status
string
Use OrderStatus instead.
OrderStatus
string
Caplin supported statuses are [PENDING-ACCEPT, PENDING-ACTIVATION, ACTIVE, PARENT-ACTIVE, PENDING-DEACTIVATION, DEACTIVATED, EXPIRED, COMPLETED, REJECTED, PENDING-CANCEL, CANCELLED, CANCELLED-BY-PARTNER]
SubmittedDateTime
datetime
The time and date a trade was submitted
LastActionBy
string
The last person or system to perform an action on an order.
LastActionDateTime
datetime
The time and date of the last action on an order.
Amount
decimal
The amount of a trade or order in the DealtCurrency.
Filled
decimal
The amount of an order that has been filled.
Remaining
decimal
The amount of an order that has not been filled.
MonitorSide
string
The side that should be monitored for an order to be triggered.
DealtCurrency
string
The currency of the Amount of a trade or order.
BuySell
string
The direction of the trade. This always refers to the BaseCurrency, NOT the DealtCurrency.
ExecutionType
string
The order type. Caplin supported types are [BENCHMARK, CALL_ORDER, MARKET, PEGGED, STOP_LOSS, TAKE_PROFIT]
BenchmarkType
string
The benchmark order name. For example, ECB.
LimitPrice
decimal
The price at which a leg should fill.
Remarks
string
The clients or trader's comments on an order leg - visible to both the Client and the Trader
ChildLegId
integer
ChildRelationship
string
PartnerLegId
integer
PartnerRelationship
string
LoopLegId
integer
FillRate
string
OrderTenor
string
The tenor the order will settle on for Forward and NDF orders. Either OrderTenor or OrderSettlementDate should be provided but not both.
OrderSettlementDate
date
The settlement date the order will settle on for Forward and NDF orders. Either OrderTenor or OrderSettlementDate should be provided but not both.
OrderFixingDate
date
The date an NDF order will fix on if filled.
SalesOrderBlotterRecord
OrderBlotterRecord
CommonFields
CurrencyPair
string
The currency pair for the trade. For example, EURUSD
Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
AllowedActions
string
Comma separated list of Caplin supported values [Edit, Deactivate, Cancel, Activate, InactiveEdit, InactiveDeactivate, InactiveCancel, InactiveActivate]
ActivationType
string
How the order should be activated. Caplin supported statuses are [GFA, EXPLICIT]
ActivationDateTime
datetime
Example: 2013-07-24T17:13:59.985
The time and date the order will become active. This is in ISO-8601 format.
ActivationDisplayTimeZone
timezone
Example: Europe/London
The timezone that the activation time and date should be formatted to for display. This is in the TZ database format.
ExpirationType
string
How the order should be deactivated. Caplin supported statuses are [IOC, GTC, GFD, FOK, EXPLICIT]
ExpirationDateTime
datetime
Example: 2013-07-24T17:13:59.985
The time and date the order will be deactivated. This is in ISO-8601 format.
ExpirationDisplayTimeZone
timezone
Example: Europe/London
The timezone that the expiration time and date should be formatted to for display. This is in the TZ database format.
AlertType
string
The type of alert that an order will send. Caplin supported statuses are [EMAIL, SMS].
StrategyType
string
The strategy the order was submitted with. This field should not be used by the front end for structuring orders. Comma separated list of Caplin supported values are [SINGLE, IF-DONE-OCO, OCO, IF-DONE, IF-TIMEOUT, IF-DONE-LOOP, LOOP]. OTHER denotes a strategy type that is unsupported.
TraderUsername
string
TOBOUser
string
The user the trade is on behalf of. For example, if the logged in user dealer1@novobank.co.za wishes to make a trade on behalf of user bob_treasurer, then the value of this field will be bob_treasurer.
OrderCount
integer
OrderID
string
The id of the order.
ActivationDate
string
What date the strategy should be activated.
ActivationTime
string
What time the strategy should be activated if the ActivationDate was in the format of yyyymmdd.
ActivationLocation
string
Example: Europe/London
When location should be used to evaluate the time to activate if the ActivationDate was in the format of yyyymmdd.
ActivationUTCOffset
string
ExpirationDate
string
What date the strategy should expire.
ExpirationTime
string
What time the strategy should be activated if the ExpirationDate was in the format of yyyymmdd.
ExpirationLocation
string
When location should be used to evaluate the time to expire if the ExpirationDate was in the format of yyyymmdd.
ExpirationUTCOffset
string
LegFields
Editable
boolean
OrderID
string
The id of the order.
Status
string
Use OrderStatus instead.
OrderStatus
string
Caplin supported statuses are [PENDING-ACCEPT, PENDING-ACTIVATION, ACTIVE, PARENT-ACTIVE, PENDING-DEACTIVATION, DEACTIVATED, EXPIRED, COMPLETED, REJECTED, PENDING-CANCEL, CANCELLED, CANCELLED-BY-PARTNER]
SubmittedDateTime
datetime
The time and date a trade was submitted
LastActionBy
string
The last person or system to perform an action on an order.
LastActionDateTime
datetime
The time and date of the last action on an order.
Amount
decimal
The amount of a trade or order in the DealtCurrency.
Filled
decimal
The amount of an order that has been filled.
Remaining
decimal
The amount of an order that has not been filled.
MonitorSide
string
The side that should be monitored for an order to be triggered.
DealtCurrency
string
The currency of the Amount of a trade or order.
BuySell
string
The direction of the trade. This always refers to the BaseCurrency, NOT the DealtCurrency.
ExecutionType
string
The order type. Caplin supported types are [BENCHMARK, CALL_ORDER, MARKET, PEGGED, STOP_LOSS, TAKE_PROFIT]
BenchmarkType
string
The benchmark order name. For example, ECB.
LimitPrice
decimal
The price at which a leg should fill.
Remarks
string
The clients or trader's comments on an order leg - visible to both the Client and the Trader
ChildLegId
integer
ChildRelationship
string
PartnerLegId
integer
PartnerRelationship
string
LoopLegId
integer
FillRate
string
OrderTenor
string
The tenor the order will settle on for Forward and NDF orders. Either OrderTenor or OrderSettlementDate should be provided but not both.
OrderSettlementDate
date
The settlement date the order will settle on for Forward and NDF orders. Either OrderTenor or OrderSettlementDate should be provided but not both.
OrderFixingDate
date
The date an NDF order will fix on if filled.
SalesLegFields
Margin
decimal
The amount of margin
Discretion
decimal
Number of points the trader has discretion to fill the order
TraderRemarks
string
The trader's comments on an order leg - visible to only the Trader
SpotBlotterRecord
CommonBlotterFields
BaseCurrency
string
Example: USD
TradingType
string
Caplin supported values are [SPOT, FWD, NDF, SWAP, TIME_OPTION]. See the constants defined within com.caplin.motif.fx.trading.FXTradingType for further details.
Status
string
Use OrderStatus instead.
IsReversible
boolean
Whether a trade can be reversed.
IsAmendable
boolean
Whether a trade can be amended.
IsCancellable
boolean
Whether a trade can be cancelled.
SpotTradeConfirmation
CommonTradeConfirmationFields
TradeID
string
CurrencyPair
string
The currency pair for the trade. For example, EURUSD
DealtCurrency
string
The currency of the Amount of a trade or order.
SpotRate
decimal
Example: 1.08341
SpotMidRate
decimal
Example: 1.08345
The mid rate between the SpotAskRate and SpotBidRate. Note that this will not always be precisely between.
SpotRateDPS
integer
Example: 5
The number of decimal places to display after the decimal point.
ExecutionDateTime
string
Example: 20160322123621
TradeDate
string
Example: 20160314
Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
TraderUsername
string
TOBOUser
string
The user the trade is on behalf of. For example, if the logged in user dealer1@novobank.co.za wishes to make a trade on behalf of user bob_treasurer, then the value of this field will be bob_treasurer.
AssetType
string
TradingType
string
Caplin supported values are [SPOT, FWD, NDF, SWAP, TIME_OPTION]. See the constants defined within com.caplin.motif.fx.trading.FXTradingType for further details.
DigitsBeforePips
integer
Example: 2
Precision-related field that tells the client how to display rates. This is the number of digits between the decimal point and the pips (i.e the big digits that the client wants to look at). For most currency pairs the value of this bla will be 2, i.e. for a USDGBP rate of 1.23456 the pips are 45 so there are two digits between the decimal point and the pips. For USDJPY the rate could be 103.256 and the pips are the 25, so in this case the value of DigitsBeforePips should be 0.
NumberOfPips
integer
Example: 2
Precision-related field that tells the client how to display rates. This is the number of pips the client wants to look at. Normally this value is 2.
OrderID
string
The id of the order.
WarningCode
string
Example: 001
The code for the warning regarding a quote request.
WarningMessage
string
Example: You do not have sufficient credit for EUR
The message to display for any warnings regarding a quote request
Client
string
Client is a duplicate of TOBOUser
CostAmount
decimal
Example: 12412891.31
The total transactional cost of performing the trade to the client
CostCurrency
string
Example: GBP
The currency that the cost is displayed in, this could be any currency but will typically be set to the Term Currency
CostPercentage
decimal
Example: 13.56
Percentage of the overall price which is the transactional cost to the client of performing the trade. This number should be out of 100, where 100.0 represents 100%.
IsReversible
boolean
Whether a trade can be reversed.
IsAmendable
boolean
Whether a trade can be amended.
IsCancellable
boolean
Whether a trade can be cancelled.
CostCurrencyDPS
integer
Example: 2
The number of decimal places to display after the decimal point.
LegTradeConfirmationFields L1
SettlementTradeFields L1
SettlementFields L1_Pay
L1_PaySettlementId
string
The identifier for the trade.
L1_PaySettlementCurrency
string
Example: GBP
A currency for of settlement instruction
L1_PaySettlementDirection
string
The direction in which the settlement details refer to, supported directions are: PAY, RECEIVE, BOTH
L1_PayIsDefaultSettlementInstruction
boolean
Is this the default settlement instruction for this currency
L1_PaySettlementInstructionType
string
Example: EXISTING
The type of settlement instruction attached to a trade. Supported types are [EXISTING, ADHOC, NONE]
L1_PaySettlementDisplayName
string
Example: [CCY] Account 1
The name of the settlement instruction. This field can be omitted.
L1_PaySettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L1_PayBankAccount
string
Example: 12345678
The account number of the bank
L1_PayBankSwift
string
Example: CAP123
The BIC of the bank
L1_PayBankName
string
Example: Bank Of Caplin
The name of the bank
L1_PayBankAddress1
string
Example: 12 Capitol
The first line of the bank's address
L1_PayBankAddress2
string
Example: The City
The second line of the bank's address
L1_PayBankAddress3
string
Example: London
The third line of the bank's address
L1_PayIndividualAccount
string
Example: 87654321
The account number of the recipient
L1_PayIndividualSwift
string
Example: SOLD987
The BIC of the recipient's account
L1_PayIndividualName
string
Example: Susan Sellers
The name of the payee or payee's bank
L1_PayIndividualAddress1
string
Example: 98 Lane
The first line of the recipient
L1_PayIndividualAddress2
string
Example: Manchester
The second line of the recipient
L1_PayNettingStatus
string
Example: NETTED
The status that denotes the permanent netting state of a settlement. This is required to know which settlements have been netted and which have not
SettlementFields L1_Receive
L1_ReceiveSettlementId
string
The identifier for the trade.
L1_ReceiveSettlementCurrency
string
Example: GBP
A currency for of settlement instruction
L1_ReceiveSettlementDirection
string
The direction in which the settlement details refer to, supported directions are: PAY, RECEIVE, BOTH
L1_ReceiveIsDefaultSettlementInstruction
boolean
Is this the default settlement instruction for this currency
L1_ReceiveSettlementInstructionType
string
Example: EXISTING
The type of settlement instruction attached to a trade. Supported types are [EXISTING, ADHOC, NONE]
L1_ReceiveSettlementDisplayName
string
Example: [CCY] Account 1
The name of the settlement instruction. This field can be omitted.
L1_ReceiveSettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L1_ReceiveBankAccount
string
Example: 12345678
The account number of the bank
L1_ReceiveBankSwift
string
Example: CAP123
The BIC of the bank
L1_ReceiveBankName
string
Example: Bank Of Caplin
The name of the bank
L1_ReceiveBankAddress1
string
Example: 12 Capitol
The first line of the bank's address
L1_ReceiveBankAddress2
string
Example: The City
The second line of the bank's address
L1_ReceiveBankAddress3
string
Example: London
The third line of the bank's address
L1_ReceiveIndividualAccount
string
Example: 87654321
The account number of the recipient
L1_ReceiveIndividualSwift
string
Example: SOLD987
The BIC of the recipient's account
L1_ReceiveIndividualName
string
Example: Susan Sellers
The name of the payee or payee's bank
L1_ReceiveIndividualAddress1
string
Example: 98 Lane
The first line of the recipient
L1_ReceiveIndividualAddress2
string
Example: Manchester
The second line of the recipient
L1_ReceiveNettingStatus
string
Example: NETTED
The status that denotes the permanent netting state of a settlement. This is required to know which settlements have been netted and which have not
L1_CanAffirm
boolean
Can affirm settlement instructions for a trade.
L1_CanConfirm
boolean
Can confirm settlement instructions for a trade.
L1_CanAdHoc
boolean
Can confirm adhoc settlement instructions for a trade.
L1_SettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L1_NextActionDeadline
datetime
Example: 2018-03-16T07:25:16+00:00
The deadline for a user to perform a trade's next action in ISO-8601 format
L1_NextActionDeadlineDisplayTimezone
string
Example: America/New_York
The timezone for the NextActionDeadline field in the form Area/Location
L1_AffirmedBy
string
The name of the user who affirmed a trade.
L1_AffirmedDateTime
datetime
Example: 2018-03-16T07:25:16+00:00
The time at which a trade was affirmed in ISO-8601 format format
L1_ConfirmedBy
string
The name of the user who confirmed a trade.
L1_ConfirmedDateTime
datetime
Example: 2018-03-16T07:25:16+00:00
The time at which a trade was confirmed in ISO-8601 format format
L1_AllInRate
decimal
Example: 1.091790
L1_AllInRateDPS
integer
Example: 5
L1_AllInMidRate
decimal
Example: 1.091790
L1_FwdPoints
decimal
Example: 0.001198
L1_FwdMidPoints
decimal
Example: 0.005390
L1_FwdPips
string
Example: 11.98
L1_BuySell
string
The direction of the trade. This always refers to the BaseCurrency, NOT the DealtCurrency.
L1_Amount
decimal
The amount of a trade or order in the DealtCurrency.
L1_ContraAmount
decimal
Example: 350
The amount that is exchanged for the Amount. This will be defined in the contra currency of the DealtCurrency.
L1_Tenor
string
Example: 1M
Supported types are [ON, [TODAY, TOD, TD], TN, [TOM, ND], SPOT, SN, 1D, 1W, 2W, 3W, 4W, 1M, 2M, 4M, 5M, 6M, 7M, 8M, 9M, 10M, 11M, [1Y, 12M], 15M, 18M, 21M, [2Y, 24M], [3Y, 36M], [4Y, 48M], [5Y, 60M], broken]. broken indicates that a SettlementDate must be sent
L1_SettlementDate
string
L1_Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
L1_Profit
decimal
Example: 1000
The sales profit in the specified currency.
L1_CostAmount
decimal
Example: 12412891.31
The total transactional cost of performing the trade to the client
SpotSalesBlotterRecord
CommonBlotterFields
BaseCurrency
string
Example: USD
TradingType
string
Caplin supported values are [SPOT, FWD, NDF, SWAP, TIME_OPTION]. See the constants defined within com.caplin.motif.fx.trading.FXTradingType for further details.
Status
string
Use OrderStatus instead.
IsReversible
boolean
Whether a trade can be reversed.
IsAmendable
boolean
Whether a trade can be amended.
IsCancellable
boolean
Whether a trade can be cancelled.
SpotSalesTradeConfirmation
SpotTradeConfirmation
CommonTradeConfirmationFields
TradeID
string
CurrencyPair
string
The currency pair for the trade. For example, EURUSD
DealtCurrency
string
The currency of the Amount of a trade or order.
SpotRate
decimal
Example: 1.08341
SpotMidRate
decimal
Example: 1.08345
The mid rate between the SpotAskRate and SpotBidRate. Note that this will not always be precisely between.
SpotRateDPS
integer
Example: 5
The number of decimal places to display after the decimal point.
ExecutionDateTime
string
Example: 20160322123621
TradeDate
string
Example: 20160314
Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
TraderUsername
string
TOBOUser
string
The user the trade is on behalf of. For example, if the logged in user dealer1@novobank.co.za wishes to make a trade on behalf of user bob_treasurer, then the value of this field will be bob_treasurer.
AssetType
string
TradingType
string
Caplin supported values are [SPOT, FWD, NDF, SWAP, TIME_OPTION]. See the constants defined within com.caplin.motif.fx.trading.FXTradingType for further details.
DigitsBeforePips
integer
Example: 2
Precision-related field that tells the client how to display rates. This is the number of digits between the decimal point and the pips (i.e the big digits that the client wants to look at). For most currency pairs the value of this bla will be 2, i.e. for a USDGBP rate of 1.23456 the pips are 45 so there are two digits between the decimal point and the pips. For USDJPY the rate could be 103.256 and the pips are the 25, so in this case the value of DigitsBeforePips should be 0.
NumberOfPips
integer
Example: 2
Precision-related field that tells the client how to display rates. This is the number of pips the client wants to look at. Normally this value is 2.
OrderID
string
The id of the order.
WarningCode
string
Example: 001
The code for the warning regarding a quote request.
WarningMessage
string
Example: You do not have sufficient credit for EUR
The message to display for any warnings regarding a quote request
Client
string
Client is a duplicate of TOBOUser
CostAmount
decimal
Example: 12412891.31
The total transactional cost of performing the trade to the client
CostCurrency
string
Example: GBP
The currency that the cost is displayed in, this could be any currency but will typically be set to the Term Currency
CostPercentage
decimal
Example: 13.56
Percentage of the overall price which is the transactional cost to the client of performing the trade. This number should be out of 100, where 100.0 represents 100%.
IsReversible
boolean
Whether a trade can be reversed.
IsAmendable
boolean
Whether a trade can be amended.
IsCancellable
boolean
Whether a trade can be cancelled.
CostCurrencyDPS
integer
Example: 2
The number of decimal places to display after the decimal point.
LegTradeConfirmationFields L1
SettlementTradeFields L1
SettlementFields L1_Pay
L1_PaySettlementId
string
The identifier for the trade.
L1_PaySettlementCurrency
string
Example: GBP
A currency for of settlement instruction
L1_PaySettlementDirection
string
The direction in which the settlement details refer to, supported directions are: PAY, RECEIVE, BOTH
L1_PayIsDefaultSettlementInstruction
boolean
Is this the default settlement instruction for this currency
L1_PaySettlementInstructionType
string
Example: EXISTING
The type of settlement instruction attached to a trade. Supported types are [EXISTING, ADHOC, NONE]
L1_PaySettlementDisplayName
string
Example: [CCY] Account 1
The name of the settlement instruction. This field can be omitted.
L1_PaySettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L1_PayBankAccount
string
Example: 12345678
The account number of the bank
L1_PayBankSwift
string
Example: CAP123
The BIC of the bank
L1_PayBankName
string
Example: Bank Of Caplin
The name of the bank
L1_PayBankAddress1
string
Example: 12 Capitol
The first line of the bank's address
L1_PayBankAddress2
string
Example: The City
The second line of the bank's address
L1_PayBankAddress3
string
Example: London
The third line of the bank's address
L1_PayIndividualAccount
string
Example: 87654321
The account number of the recipient
L1_PayIndividualSwift
string
Example: SOLD987
The BIC of the recipient's account
L1_PayIndividualName
string
Example: Susan Sellers
The name of the payee or payee's bank
L1_PayIndividualAddress1
string
Example: 98 Lane
The first line of the recipient
L1_PayIndividualAddress2
string
Example: Manchester
The second line of the recipient
L1_PayNettingStatus
string
Example: NETTED
The status that denotes the permanent netting state of a settlement. This is required to know which settlements have been netted and which have not
SettlementFields L1_Receive
L1_ReceiveSettlementId
string
The identifier for the trade.
L1_ReceiveSettlementCurrency
string
Example: GBP
A currency for of settlement instruction
L1_ReceiveSettlementDirection
string
The direction in which the settlement details refer to, supported directions are: PAY, RECEIVE, BOTH
L1_ReceiveIsDefaultSettlementInstruction
boolean
Is this the default settlement instruction for this currency
L1_ReceiveSettlementInstructionType
string
Example: EXISTING
The type of settlement instruction attached to a trade. Supported types are [EXISTING, ADHOC, NONE]
L1_ReceiveSettlementDisplayName
string
Example: [CCY] Account 1
The name of the settlement instruction. This field can be omitted.
L1_ReceiveSettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L1_ReceiveBankAccount
string
Example: 12345678
The account number of the bank
L1_ReceiveBankSwift
string
Example: CAP123
The BIC of the bank
L1_ReceiveBankName
string
Example: Bank Of Caplin
The name of the bank
L1_ReceiveBankAddress1
string
Example: 12 Capitol
The first line of the bank's address
L1_ReceiveBankAddress2
string
Example: The City
The second line of the bank's address
L1_ReceiveBankAddress3
string
Example: London
The third line of the bank's address
L1_ReceiveIndividualAccount
string
Example: 87654321
The account number of the recipient
L1_ReceiveIndividualSwift
string
Example: SOLD987
The BIC of the recipient's account
L1_ReceiveIndividualName
string
Example: Susan Sellers
The name of the payee or payee's bank
L1_ReceiveIndividualAddress1
string
Example: 98 Lane
The first line of the recipient
L1_ReceiveIndividualAddress2
string
Example: Manchester
The second line of the recipient
L1_ReceiveNettingStatus
string
Example: NETTED
The status that denotes the permanent netting state of a settlement. This is required to know which settlements have been netted and which have not
L1_CanAffirm
boolean
Can affirm settlement instructions for a trade.
L1_CanConfirm
boolean
Can confirm settlement instructions for a trade.
L1_CanAdHoc
boolean
Can confirm adhoc settlement instructions for a trade.
L1_SettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L1_NextActionDeadline
datetime
Example: 2018-03-16T07:25:16+00:00
The deadline for a user to perform a trade's next action in ISO-8601 format
L1_NextActionDeadlineDisplayTimezone
string
Example: America/New_York
The timezone for the NextActionDeadline field in the form Area/Location
L1_AffirmedBy
string
The name of the user who affirmed a trade.
L1_AffirmedDateTime
datetime
Example: 2018-03-16T07:25:16+00:00
The time at which a trade was affirmed in ISO-8601 format format
L1_ConfirmedBy
string
The name of the user who confirmed a trade.
L1_ConfirmedDateTime
datetime
Example: 2018-03-16T07:25:16+00:00
The time at which a trade was confirmed in ISO-8601 format format
L1_AllInRate
decimal
Example: 1.091790
L1_AllInRateDPS
integer
Example: 5
L1_AllInMidRate
decimal
Example: 1.091790
L1_FwdPoints
decimal
Example: 0.001198
L1_FwdMidPoints
decimal
Example: 0.005390
L1_FwdPips
string
Example: 11.98
L1_BuySell
string
The direction of the trade. This always refers to the BaseCurrency, NOT the DealtCurrency.
L1_Amount
decimal
The amount of a trade or order in the DealtCurrency.
L1_ContraAmount
decimal
Example: 350
The amount that is exchanged for the Amount. This will be defined in the contra currency of the DealtCurrency.
L1_Tenor
string
Example: 1M
Supported types are [ON, [TODAY, TOD, TD], TN, [TOM, ND], SPOT, SN, 1D, 1W, 2W, 3W, 4W, 1M, 2M, 4M, 5M, 6M, 7M, 8M, 9M, 10M, 11M, [1Y, 12M], 15M, 18M, 21M, [2Y, 24M], [3Y, 36M], [4Y, 48M], [5Y, 60M], broken]. broken indicates that a SettlementDate must be sent
L1_SettlementDate
string
L1_Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
L1_Profit
decimal
Example: 1000
The sales profit in the specified currency.
L1_CostAmount
decimal
Example: 12412891.31
The total transactional cost of performing the trade to the client
SalesLegTradeConfirmationFields L1
L1_TraderAllInRate
decimal
Example: 1.005390
The all-in rate, with no client margin applied to it
L1_TraderFwdPoints
decimal
Example: 0.005390
The forward points with no client margin applied to them.
L1_FwdMargin
decimal
Example: 0.000019
The Forward margin that the user has selected. This field should be sent raw and unformatted.
L1_AllInMargin
decimal
Example: 0.00054
The sales user's selected SpotMargin added to the sales user's selected L1_FwdMargin.
SalesCommonTradeConfirmationFields
ProfitCurrency
string
Example: USD
The profit currency that the ProfitBidRate is being provided for.
ProfitCurrencyDPS
integer
Example: 5
The number of decimal places that should be used for formatting the amount in profit currency field.
ProfitRate
decimal
Example: 1.091790
The conversion rate from the contra currency into the profit currency.
TraderSpotRate
decimal
Example: 1.09174
Can be formatted using DigitsBeforePips, NumberOfPips and SpotRateDPS
SpotMargin
decimal
Example: 0.00054
Can be formatted using DigitsBeforePips, NumberOfPips and SpotRateDPS
Profit
decimal
Example: 1000
The sales profit in the specified currency.
Competition
boolean
Whether a quote request is in competition. For example, true for quotes from an ECN and false for quotes from an SDP
Source
string
The source of a quote request. The name or ID of an ECN, SDP or other channel
Reason
string
The reason that a quote requires intervention. For example, because it exceeds GFA
ForwardBlotterRecord
CommonBlotterFields
BaseCurrency
string
Example: USD
TradingType
string
Caplin supported values are [SPOT, FWD, NDF, SWAP, TIME_OPTION]. See the constants defined within com.caplin.motif.fx.trading.FXTradingType for further details.
Status
string
Use OrderStatus instead.
IsReversible
boolean
Whether a trade can be reversed.
IsAmendable
boolean
Whether a trade can be amended.
IsCancellable
boolean
Whether a trade can be cancelled.
ForwardTradeConfirmation
CommonTradeConfirmationFields
TradeID
string
CurrencyPair
string
The currency pair for the trade. For example, EURUSD
DealtCurrency
string
The currency of the Amount of a trade or order.
SpotRate
decimal
Example: 1.08341
SpotMidRate
decimal
Example: 1.08345
The mid rate between the SpotAskRate and SpotBidRate. Note that this will not always be precisely between.
SpotRateDPS
integer
Example: 5
The number of decimal places to display after the decimal point.
ExecutionDateTime
string
Example: 20160322123621
TradeDate
string
Example: 20160314
Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
TraderUsername
string
TOBOUser
string
The user the trade is on behalf of. For example, if the logged in user dealer1@novobank.co.za wishes to make a trade on behalf of user bob_treasurer, then the value of this field will be bob_treasurer.
AssetType
string
TradingType
string
Caplin supported values are [SPOT, FWD, NDF, SWAP, TIME_OPTION]. See the constants defined within com.caplin.motif.fx.trading.FXTradingType for further details.
DigitsBeforePips
integer
Example: 2
Precision-related field that tells the client how to display rates. This is the number of digits between the decimal point and the pips (i.e the big digits that the client wants to look at). For most currency pairs the value of this bla will be 2, i.e. for a USDGBP rate of 1.23456 the pips are 45 so there are two digits between the decimal point and the pips. For USDJPY the rate could be 103.256 and the pips are the 25, so in this case the value of DigitsBeforePips should be 0.
NumberOfPips
integer
Example: 2
Precision-related field that tells the client how to display rates. This is the number of pips the client wants to look at. Normally this value is 2.
OrderID
string
The id of the order.
WarningCode
string
Example: 001
The code for the warning regarding a quote request.
WarningMessage
string
Example: You do not have sufficient credit for EUR
The message to display for any warnings regarding a quote request
Client
string
Client is a duplicate of TOBOUser
CostAmount
decimal
Example: 12412891.31
The total transactional cost of performing the trade to the client
CostCurrency
string
Example: GBP
The currency that the cost is displayed in, this could be any currency but will typically be set to the Term Currency
CostPercentage
decimal
Example: 13.56
Percentage of the overall price which is the transactional cost to the client of performing the trade. This number should be out of 100, where 100.0 represents 100%.
IsReversible
boolean
Whether a trade can be reversed.
IsAmendable
boolean
Whether a trade can be amended.
IsCancellable
boolean
Whether a trade can be cancelled.
CostCurrencyDPS
integer
Example: 2
The number of decimal places to display after the decimal point.
LegTradeConfirmationFields L1
SettlementTradeFields L1
SettlementFields L1_Pay
L1_PaySettlementId
string
The identifier for the trade.
L1_PaySettlementCurrency
string
Example: GBP
A currency for of settlement instruction
L1_PaySettlementDirection
string
The direction in which the settlement details refer to, supported directions are: PAY, RECEIVE, BOTH
L1_PayIsDefaultSettlementInstruction
boolean
Is this the default settlement instruction for this currency
L1_PaySettlementInstructionType
string
Example: EXISTING
The type of settlement instruction attached to a trade. Supported types are [EXISTING, ADHOC, NONE]
L1_PaySettlementDisplayName
string
Example: [CCY] Account 1
The name of the settlement instruction. This field can be omitted.
L1_PaySettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L1_PayBankAccount
string
Example: 12345678
The account number of the bank
L1_PayBankSwift
string
Example: CAP123
The BIC of the bank
L1_PayBankName
string
Example: Bank Of Caplin
The name of the bank
L1_PayBankAddress1
string
Example: 12 Capitol
The first line of the bank's address
L1_PayBankAddress2
string
Example: The City
The second line of the bank's address
L1_PayBankAddress3
string
Example: London
The third line of the bank's address
L1_PayIndividualAccount
string
Example: 87654321
The account number of the recipient
L1_PayIndividualSwift
string
Example: SOLD987
The BIC of the recipient's account
L1_PayIndividualName
string
Example: Susan Sellers
The name of the payee or payee's bank
L1_PayIndividualAddress1
string
Example: 98 Lane
The first line of the recipient
L1_PayIndividualAddress2
string
Example: Manchester
The second line of the recipient
L1_PayNettingStatus
string
Example: NETTED
The status that denotes the permanent netting state of a settlement. This is required to know which settlements have been netted and which have not
SettlementFields L1_Receive
L1_ReceiveSettlementId
string
The identifier for the trade.
L1_ReceiveSettlementCurrency
string
Example: GBP
A currency for of settlement instruction
L1_ReceiveSettlementDirection
string
The direction in which the settlement details refer to, supported directions are: PAY, RECEIVE, BOTH
L1_ReceiveIsDefaultSettlementInstruction
boolean
Is this the default settlement instruction for this currency
L1_ReceiveSettlementInstructionType
string
Example: EXISTING
The type of settlement instruction attached to a trade. Supported types are [EXISTING, ADHOC, NONE]
L1_ReceiveSettlementDisplayName
string
Example: [CCY] Account 1
The name of the settlement instruction. This field can be omitted.
L1_ReceiveSettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L1_ReceiveBankAccount
string
Example: 12345678
The account number of the bank
L1_ReceiveBankSwift
string
Example: CAP123
The BIC of the bank
L1_ReceiveBankName
string
Example: Bank Of Caplin
The name of the bank
L1_ReceiveBankAddress1
string
Example: 12 Capitol
The first line of the bank's address
L1_ReceiveBankAddress2
string
Example: The City
The second line of the bank's address
L1_ReceiveBankAddress3
string
Example: London
The third line of the bank's address
L1_ReceiveIndividualAccount
string
Example: 87654321
The account number of the recipient
L1_ReceiveIndividualSwift
string
Example: SOLD987
The BIC of the recipient's account
L1_ReceiveIndividualName
string
Example: Susan Sellers
The name of the payee or payee's bank
L1_ReceiveIndividualAddress1
string
Example: 98 Lane
The first line of the recipient
L1_ReceiveIndividualAddress2
string
Example: Manchester
The second line of the recipient
L1_ReceiveNettingStatus
string
Example: NETTED
The status that denotes the permanent netting state of a settlement. This is required to know which settlements have been netted and which have not
L1_CanAffirm
boolean
Can affirm settlement instructions for a trade.
L1_CanConfirm
boolean
Can confirm settlement instructions for a trade.
L1_CanAdHoc
boolean
Can confirm adhoc settlement instructions for a trade.
L1_SettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L1_NextActionDeadline
datetime
Example: 2018-03-16T07:25:16+00:00
The deadline for a user to perform a trade's next action in ISO-8601 format
L1_NextActionDeadlineDisplayTimezone
string
Example: America/New_York
The timezone for the NextActionDeadline field in the form Area/Location
L1_AffirmedBy
string
The name of the user who affirmed a trade.
L1_AffirmedDateTime
datetime
Example: 2018-03-16T07:25:16+00:00
The time at which a trade was affirmed in ISO-8601 format format
L1_ConfirmedBy
string
The name of the user who confirmed a trade.
L1_ConfirmedDateTime
datetime
Example: 2018-03-16T07:25:16+00:00
The time at which a trade was confirmed in ISO-8601 format format
L1_AllInRate
decimal
Example: 1.091790
L1_AllInRateDPS
integer
Example: 5
L1_AllInMidRate
decimal
Example: 1.091790
L1_FwdPoints
decimal
Example: 0.001198
L1_FwdMidPoints
decimal
Example: 0.005390
L1_FwdPips
string
Example: 11.98
L1_BuySell
string
The direction of the trade. This always refers to the BaseCurrency, NOT the DealtCurrency.
L1_Amount
decimal
The amount of a trade or order in the DealtCurrency.
L1_ContraAmount
decimal
Example: 350
The amount that is exchanged for the Amount. This will be defined in the contra currency of the DealtCurrency.
L1_Tenor
string
Example: 1M
Supported types are [ON, [TODAY, TOD, TD], TN, [TOM, ND], SPOT, SN, 1D, 1W, 2W, 3W, 4W, 1M, 2M, 4M, 5M, 6M, 7M, 8M, 9M, 10M, 11M, [1Y, 12M], 15M, 18M, 21M, [2Y, 24M], [3Y, 36M], [4Y, 48M], [5Y, 60M], broken]. broken indicates that a SettlementDate must be sent
L1_SettlementDate
string
L1_Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
L1_Profit
decimal
Example: 1000
The sales profit in the specified currency.
L1_CostAmount
decimal
Example: 12412891.31
The total transactional cost of performing the trade to the client
NDFLegTradeConfirmationFields L1
L1_FixingDate
string
Example: 20150620
L1_FixingCurrency
string
Example: USD
L1_FixingCode
string
Example: [CCY]1/1600/GBLO
L1_FixingDescription
string
Example: WMR [CCY] 4pm London
TimeOptionLegTradeConfirmationFields L1
L1_FilledAmount
decimal
Example: 0
L1_RemainingAmount
decimal
Example: 500
L1_RiskDate
string
Example: 20160314
L1_RiskTenor
string
Example: 1W
L1_StartDate
string
Example: 20150620
L1_StartTenor
string
Example: 1W
ForwardSalesBlotterRecord
CommonBlotterFields
BaseCurrency
string
Example: USD
TradingType
string
Caplin supported values are [SPOT, FWD, NDF, SWAP, TIME_OPTION]. See the constants defined within com.caplin.motif.fx.trading.FXTradingType for further details.
Status
string
Use OrderStatus instead.
IsReversible
boolean
Whether a trade can be reversed.
IsAmendable
boolean
Whether a trade can be amended.
IsCancellable
boolean
Whether a trade can be cancelled.
ForwardSalesTradeConfirmation
ForwardTradeConfirmation
CommonTradeConfirmationFields
TradeID
string
CurrencyPair
string
The currency pair for the trade. For example, EURUSD
DealtCurrency
string
The currency of the Amount of a trade or order.
SpotRate
decimal
Example: 1.08341
SpotMidRate
decimal
Example: 1.08345
The mid rate between the SpotAskRate and SpotBidRate. Note that this will not always be precisely between.
SpotRateDPS
integer
Example: 5
The number of decimal places to display after the decimal point.
ExecutionDateTime
string
Example: 20160322123621
TradeDate
string
Example: 20160314
Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
TraderUsername
string
TOBOUser
string
The user the trade is on behalf of. For example, if the logged in user dealer1@novobank.co.za wishes to make a trade on behalf of user bob_treasurer, then the value of this field will be bob_treasurer.
AssetType
string
TradingType
string
Caplin supported values are [SPOT, FWD, NDF, SWAP, TIME_OPTION]. See the constants defined within com.caplin.motif.fx.trading.FXTradingType for further details.
DigitsBeforePips
integer
Example: 2
Precision-related field that tells the client how to display rates. This is the number of digits between the decimal point and the pips (i.e the big digits that the client wants to look at). For most currency pairs the value of this bla will be 2, i.e. for a USDGBP rate of 1.23456 the pips are 45 so there are two digits between the decimal point and the pips. For USDJPY the rate could be 103.256 and the pips are the 25, so in this case the value of DigitsBeforePips should be 0.
NumberOfPips
integer
Example: 2
Precision-related field that tells the client how to display rates. This is the number of pips the client wants to look at. Normally this value is 2.
OrderID
string
The id of the order.
WarningCode
string
Example: 001
The code for the warning regarding a quote request.
WarningMessage
string
Example: You do not have sufficient credit for EUR
The message to display for any warnings regarding a quote request
Client
string
Client is a duplicate of TOBOUser
CostAmount
decimal
Example: 12412891.31
The total transactional cost of performing the trade to the client
CostCurrency
string
Example: GBP
The currency that the cost is displayed in, this could be any currency but will typically be set to the Term Currency
CostPercentage
decimal
Example: 13.56
Percentage of the overall price which is the transactional cost to the client of performing the trade. This number should be out of 100, where 100.0 represents 100%.
IsReversible
boolean
Whether a trade can be reversed.
IsAmendable
boolean
Whether a trade can be amended.
IsCancellable
boolean
Whether a trade can be cancelled.
CostCurrencyDPS
integer
Example: 2
The number of decimal places to display after the decimal point.
LegTradeConfirmationFields L1
SettlementTradeFields L1
SettlementFields L1_Pay
L1_PaySettlementId
string
The identifier for the trade.
L1_PaySettlementCurrency
string
Example: GBP
A currency for of settlement instruction
L1_PaySettlementDirection
string
The direction in which the settlement details refer to, supported directions are: PAY, RECEIVE, BOTH
L1_PayIsDefaultSettlementInstruction
boolean
Is this the default settlement instruction for this currency
L1_PaySettlementInstructionType
string
Example: EXISTING
The type of settlement instruction attached to a trade. Supported types are [EXISTING, ADHOC, NONE]
L1_PaySettlementDisplayName
string
Example: [CCY] Account 1
The name of the settlement instruction. This field can be omitted.
L1_PaySettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L1_PayBankAccount
string
Example: 12345678
The account number of the bank
L1_PayBankSwift
string
Example: CAP123
The BIC of the bank
L1_PayBankName
string
Example: Bank Of Caplin
The name of the bank
L1_PayBankAddress1
string
Example: 12 Capitol
The first line of the bank's address
L1_PayBankAddress2
string
Example: The City
The second line of the bank's address
L1_PayBankAddress3
string
Example: London
The third line of the bank's address
L1_PayIndividualAccount
string
Example: 87654321
The account number of the recipient
L1_PayIndividualSwift
string
Example: SOLD987
The BIC of the recipient's account
L1_PayIndividualName
string
Example: Susan Sellers
The name of the payee or payee's bank
L1_PayIndividualAddress1
string
Example: 98 Lane
The first line of the recipient
L1_PayIndividualAddress2
string
Example: Manchester
The second line of the recipient
L1_PayNettingStatus
string
Example: NETTED
The status that denotes the permanent netting state of a settlement. This is required to know which settlements have been netted and which have not
SettlementFields L1_Receive
L1_ReceiveSettlementId
string
The identifier for the trade.
L1_ReceiveSettlementCurrency
string
Example: GBP
A currency for of settlement instruction
L1_ReceiveSettlementDirection
string
The direction in which the settlement details refer to, supported directions are: PAY, RECEIVE, BOTH
L1_ReceiveIsDefaultSettlementInstruction
boolean
Is this the default settlement instruction for this currency
L1_ReceiveSettlementInstructionType
string
Example: EXISTING
The type of settlement instruction attached to a trade. Supported types are [EXISTING, ADHOC, NONE]
L1_ReceiveSettlementDisplayName
string
Example: [CCY] Account 1
The name of the settlement instruction. This field can be omitted.
L1_ReceiveSettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L1_ReceiveBankAccount
string
Example: 12345678
The account number of the bank
L1_ReceiveBankSwift
string
Example: CAP123
The BIC of the bank
L1_ReceiveBankName
string
Example: Bank Of Caplin
The name of the bank
L1_ReceiveBankAddress1
string
Example: 12 Capitol
The first line of the bank's address
L1_ReceiveBankAddress2
string
Example: The City
The second line of the bank's address
L1_ReceiveBankAddress3
string
Example: London
The third line of the bank's address
L1_ReceiveIndividualAccount
string
Example: 87654321
The account number of the recipient
L1_ReceiveIndividualSwift
string
Example: SOLD987
The BIC of the recipient's account
L1_ReceiveIndividualName
string
Example: Susan Sellers
The name of the payee or payee's bank
L1_ReceiveIndividualAddress1
string
Example: 98 Lane
The first line of the recipient
L1_ReceiveIndividualAddress2
string
Example: Manchester
The second line of the recipient
L1_ReceiveNettingStatus
string
Example: NETTED
The status that denotes the permanent netting state of a settlement. This is required to know which settlements have been netted and which have not
L1_CanAffirm
boolean
Can affirm settlement instructions for a trade.
L1_CanConfirm
boolean
Can confirm settlement instructions for a trade.
L1_CanAdHoc
boolean
Can confirm adhoc settlement instructions for a trade.
L1_SettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L1_NextActionDeadline
datetime
Example: 2018-03-16T07:25:16+00:00
The deadline for a user to perform a trade's next action in ISO-8601 format
L1_NextActionDeadlineDisplayTimezone
string
Example: America/New_York
The timezone for the NextActionDeadline field in the form Area/Location
L1_AffirmedBy
string
The name of the user who affirmed a trade.
L1_AffirmedDateTime
datetime
Example: 2018-03-16T07:25:16+00:00
The time at which a trade was affirmed in ISO-8601 format format
L1_ConfirmedBy
string
The name of the user who confirmed a trade.
L1_ConfirmedDateTime
datetime
Example: 2018-03-16T07:25:16+00:00
The time at which a trade was confirmed in ISO-8601 format format
L1_AllInRate
decimal
Example: 1.091790
L1_AllInRateDPS
integer
Example: 5
L1_AllInMidRate
decimal
Example: 1.091790
L1_FwdPoints
decimal
Example: 0.001198
L1_FwdMidPoints
decimal
Example: 0.005390
L1_FwdPips
string
Example: 11.98
L1_BuySell
string
The direction of the trade. This always refers to the BaseCurrency, NOT the DealtCurrency.
L1_Amount
decimal
The amount of a trade or order in the DealtCurrency.
L1_ContraAmount
decimal
Example: 350
The amount that is exchanged for the Amount. This will be defined in the contra currency of the DealtCurrency.
L1_Tenor
string
Example: 1M
Supported types are [ON, [TODAY, TOD, TD], TN, [TOM, ND], SPOT, SN, 1D, 1W, 2W, 3W, 4W, 1M, 2M, 4M, 5M, 6M, 7M, 8M, 9M, 10M, 11M, [1Y, 12M], 15M, 18M, 21M, [2Y, 24M], [3Y, 36M], [4Y, 48M], [5Y, 60M], broken]. broken indicates that a SettlementDate must be sent
L1_SettlementDate
string
L1_Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
L1_Profit
decimal
Example: 1000
The sales profit in the specified currency.
L1_CostAmount
decimal
Example: 12412891.31
The total transactional cost of performing the trade to the client
NDFLegTradeConfirmationFields L1
L1_FixingDate
string
Example: 20150620
L1_FixingCurrency
string
Example: USD
L1_FixingCode
string
Example: [CCY]1/1600/GBLO
L1_FixingDescription
string
Example: WMR [CCY] 4pm London
TimeOptionLegTradeConfirmationFields L1
L1_FilledAmount
decimal
Example: 0
L1_RemainingAmount
decimal
Example: 500
L1_RiskDate
string
Example: 20160314
L1_RiskTenor
string
Example: 1W
L1_StartDate
string
Example: 20150620
L1_StartTenor
string
Example: 1W
SalesLegTradeConfirmationFields L1
L1_TraderAllInRate
decimal
Example: 1.005390
The all-in rate, with no client margin applied to it
L1_TraderFwdPoints
decimal
Example: 0.005390
The forward points with no client margin applied to them.
L1_FwdMargin
decimal
Example: 0.000019
The Forward margin that the user has selected. This field should be sent raw and unformatted.
L1_AllInMargin
decimal
Example: 0.00054
The sales user's selected SpotMargin added to the sales user's selected L1_FwdMargin.
SalesCommonTradeConfirmationFields
ProfitCurrency
string
Example: USD
The profit currency that the ProfitBidRate is being provided for.
ProfitCurrencyDPS
integer
Example: 5
The number of decimal places that should be used for formatting the amount in profit currency field.
ProfitRate
decimal
Example: 1.091790
The conversion rate from the contra currency into the profit currency.
TraderSpotRate
decimal
Example: 1.09174
Can be formatted using DigitsBeforePips, NumberOfPips and SpotRateDPS
SpotMargin
decimal
Example: 0.00054
Can be formatted using DigitsBeforePips, NumberOfPips and SpotRateDPS
Profit
decimal
Example: 1000
The sales profit in the specified currency.
Competition
boolean
Whether a quote request is in competition. For example, true for quotes from an ECN and false for quotes from an SDP
Source
string
The source of a quote request. The name or ID of an ECN, SDP or other channel
Reason
string
The reason that a quote requires intervention. For example, because it exceeds GFA
SwapTradeBlotterRecord
CommonBlotterFields
BaseCurrency
string
Example: USD
TradingType
string
Caplin supported values are [SPOT, FWD, NDF, SWAP, TIME_OPTION]. See the constants defined within com.caplin.motif.fx.trading.FXTradingType for further details.
Status
string
Use OrderStatus instead.
IsReversible
boolean
Whether a trade can be reversed.
IsAmendable
boolean
Whether a trade can be amended.
IsCancellable
boolean
Whether a trade can be cancelled.
SwapTradeConfirmation
CommonTradeConfirmationFields
TradeID
string
CurrencyPair
string
The currency pair for the trade. For example, EURUSD
DealtCurrency
string
The currency of the Amount of a trade or order.
SpotRate
decimal
Example: 1.08341
SpotMidRate
decimal
Example: 1.08345
The mid rate between the SpotAskRate and SpotBidRate. Note that this will not always be precisely between.
SpotRateDPS
integer
Example: 5
The number of decimal places to display after the decimal point.
ExecutionDateTime
string
Example: 20160322123621
TradeDate
string
Example: 20160314
Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
TraderUsername
string
TOBOUser
string
The user the trade is on behalf of. For example, if the logged in user dealer1@novobank.co.za wishes to make a trade on behalf of user bob_treasurer, then the value of this field will be bob_treasurer.
AssetType
string
TradingType
string
Caplin supported values are [SPOT, FWD, NDF, SWAP, TIME_OPTION]. See the constants defined within com.caplin.motif.fx.trading.FXTradingType for further details.
DigitsBeforePips
integer
Example: 2
Precision-related field that tells the client how to display rates. This is the number of digits between the decimal point and the pips (i.e the big digits that the client wants to look at). For most currency pairs the value of this bla will be 2, i.e. for a USDGBP rate of 1.23456 the pips are 45 so there are two digits between the decimal point and the pips. For USDJPY the rate could be 103.256 and the pips are the 25, so in this case the value of DigitsBeforePips should be 0.
NumberOfPips
integer
Example: 2
Precision-related field that tells the client how to display rates. This is the number of pips the client wants to look at. Normally this value is 2.
OrderID
string
The id of the order.
WarningCode
string
Example: 001
The code for the warning regarding a quote request.
WarningMessage
string
Example: You do not have sufficient credit for EUR
The message to display for any warnings regarding a quote request
Client
string
Client is a duplicate of TOBOUser
CostAmount
decimal
Example: 12412891.31
The total transactional cost of performing the trade to the client
CostCurrency
string
Example: GBP
The currency that the cost is displayed in, this could be any currency but will typically be set to the Term Currency
CostPercentage
decimal
Example: 13.56
Percentage of the overall price which is the transactional cost to the client of performing the trade. This number should be out of 100, where 100.0 represents 100%.
IsReversible
boolean
Whether a trade can be reversed.
IsAmendable
boolean
Whether a trade can be amended.
IsCancellable
boolean
Whether a trade can be cancelled.
CostCurrencyDPS
integer
Example: 2
The number of decimal places to display after the decimal point.
LegTradeConfirmationFields L1
SettlementTradeFields L1
SettlementFields L1_Pay
L1_PaySettlementId
string
The identifier for the trade.
L1_PaySettlementCurrency
string
Example: GBP
A currency for of settlement instruction
L1_PaySettlementDirection
string
The direction in which the settlement details refer to, supported directions are: PAY, RECEIVE, BOTH
L1_PayIsDefaultSettlementInstruction
boolean
Is this the default settlement instruction for this currency
L1_PaySettlementInstructionType
string
Example: EXISTING
The type of settlement instruction attached to a trade. Supported types are [EXISTING, ADHOC, NONE]
L1_PaySettlementDisplayName
string
Example: [CCY] Account 1
The name of the settlement instruction. This field can be omitted.
L1_PaySettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L1_PayBankAccount
string
Example: 12345678
The account number of the bank
L1_PayBankSwift
string
Example: CAP123
The BIC of the bank
L1_PayBankName
string
Example: Bank Of Caplin
The name of the bank
L1_PayBankAddress1
string
Example: 12 Capitol
The first line of the bank's address
L1_PayBankAddress2
string
Example: The City
The second line of the bank's address
L1_PayBankAddress3
string
Example: London
The third line of the bank's address
L1_PayIndividualAccount
string
Example: 87654321
The account number of the recipient
L1_PayIndividualSwift
string
Example: SOLD987
The BIC of the recipient's account
L1_PayIndividualName
string
Example: Susan Sellers
The name of the payee or payee's bank
L1_PayIndividualAddress1
string
Example: 98 Lane
The first line of the recipient
L1_PayIndividualAddress2
string
Example: Manchester
The second line of the recipient
L1_PayNettingStatus
string
Example: NETTED
The status that denotes the permanent netting state of a settlement. This is required to know which settlements have been netted and which have not
SettlementFields L1_Receive
L1_ReceiveSettlementId
string
The identifier for the trade.
L1_ReceiveSettlementCurrency
string
Example: GBP
A currency for of settlement instruction
L1_ReceiveSettlementDirection
string
The direction in which the settlement details refer to, supported directions are: PAY, RECEIVE, BOTH
L1_ReceiveIsDefaultSettlementInstruction
boolean
Is this the default settlement instruction for this currency
L1_ReceiveSettlementInstructionType
string
Example: EXISTING
The type of settlement instruction attached to a trade. Supported types are [EXISTING, ADHOC, NONE]
L1_ReceiveSettlementDisplayName
string
Example: [CCY] Account 1
The name of the settlement instruction. This field can be omitted.
L1_ReceiveSettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L1_ReceiveBankAccount
string
Example: 12345678
The account number of the bank
L1_ReceiveBankSwift
string
Example: CAP123
The BIC of the bank
L1_ReceiveBankName
string
Example: Bank Of Caplin
The name of the bank
L1_ReceiveBankAddress1
string
Example: 12 Capitol
The first line of the bank's address
L1_ReceiveBankAddress2
string
Example: The City
The second line of the bank's address
L1_ReceiveBankAddress3
string
Example: London
The third line of the bank's address
L1_ReceiveIndividualAccount
string
Example: 87654321
The account number of the recipient
L1_ReceiveIndividualSwift
string
Example: SOLD987
The BIC of the recipient's account
L1_ReceiveIndividualName
string
Example: Susan Sellers
The name of the payee or payee's bank
L1_ReceiveIndividualAddress1
string
Example: 98 Lane
The first line of the recipient
L1_ReceiveIndividualAddress2
string
Example: Manchester
The second line of the recipient
L1_ReceiveNettingStatus
string
Example: NETTED
The status that denotes the permanent netting state of a settlement. This is required to know which settlements have been netted and which have not
L1_CanAffirm
boolean
Can affirm settlement instructions for a trade.
L1_CanConfirm
boolean
Can confirm settlement instructions for a trade.
L1_CanAdHoc
boolean
Can confirm adhoc settlement instructions for a trade.
L1_SettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L1_NextActionDeadline
datetime
Example: 2018-03-16T07:25:16+00:00
The deadline for a user to perform a trade's next action in ISO-8601 format
L1_NextActionDeadlineDisplayTimezone
string
Example: America/New_York
The timezone for the NextActionDeadline field in the form Area/Location
L1_AffirmedBy
string
The name of the user who affirmed a trade.
L1_AffirmedDateTime
datetime
Example: 2018-03-16T07:25:16+00:00
The time at which a trade was affirmed in ISO-8601 format format
L1_ConfirmedBy
string
The name of the user who confirmed a trade.
L1_ConfirmedDateTime
datetime
Example: 2018-03-16T07:25:16+00:00
The time at which a trade was confirmed in ISO-8601 format format
L1_AllInRate
decimal
Example: 1.091790
L1_AllInRateDPS
integer
Example: 5
L1_AllInMidRate
decimal
Example: 1.091790
L1_FwdPoints
decimal
Example: 0.001198
L1_FwdMidPoints
decimal
Example: 0.005390
L1_FwdPips
string
Example: 11.98
L1_BuySell
string
The direction of the trade. This always refers to the BaseCurrency, NOT the DealtCurrency.
L1_Amount
decimal
The amount of a trade or order in the DealtCurrency.
L1_ContraAmount
decimal
Example: 350
The amount that is exchanged for the Amount. This will be defined in the contra currency of the DealtCurrency.
L1_Tenor
string
Example: 1M
Supported types are [ON, [TODAY, TOD, TD], TN, [TOM, ND], SPOT, SN, 1D, 1W, 2W, 3W, 4W, 1M, 2M, 4M, 5M, 6M, 7M, 8M, 9M, 10M, 11M, [1Y, 12M], 15M, 18M, 21M, [2Y, 24M], [3Y, 36M], [4Y, 48M], [5Y, 60M], broken]. broken indicates that a SettlementDate must be sent
L1_SettlementDate
string
L1_Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
L1_Profit
decimal
Example: 1000
The sales profit in the specified currency.
L1_CostAmount
decimal
Example: 12412891.31
The total transactional cost of performing the trade to the client
LegTradeConfirmationFields L2
SettlementTradeFields L2
SettlementFields L2_Pay
L2_PaySettlementId
string
The identifier for the trade.
L2_PaySettlementCurrency
string
Example: GBP
A currency for of settlement instruction
L2_PaySettlementDirection
string
The direction in which the settlement details refer to, supported directions are: PAY, RECEIVE, BOTH
L2_PayIsDefaultSettlementInstruction
boolean
Is this the default settlement instruction for this currency
L2_PaySettlementInstructionType
string
Example: EXISTING
The type of settlement instruction attached to a trade. Supported types are [EXISTING, ADHOC, NONE]
L2_PaySettlementDisplayName
string
Example: [CCY] Account 1
The name of the settlement instruction. This field can be omitted.
L2_PaySettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L2_PayBankAccount
string
Example: 12345678
The account number of the bank
L2_PayBankSwift
string
Example: CAP123
The BIC of the bank
L2_PayBankName
string
Example: Bank Of Caplin
The name of the bank
L2_PayBankAddress1
string
Example: 12 Capitol
The first line of the bank's address
L2_PayBankAddress2
string
Example: The City
The second line of the bank's address
L2_PayBankAddress3
string
Example: London
The third line of the bank's address
L2_PayIndividualAccount
string
Example: 87654321
The account number of the recipient
L2_PayIndividualSwift
string
Example: SOLD987
The BIC of the recipient's account
L2_PayIndividualName
string
Example: Susan Sellers
The name of the payee or payee's bank
L2_PayIndividualAddress1
string
Example: 98 Lane
The first line of the recipient
L2_PayIndividualAddress2
string
Example: Manchester
The second line of the recipient
L2_PayNettingStatus
string
Example: NETTED
The status that denotes the permanent netting state of a settlement. This is required to know which settlements have been netted and which have not
SettlementFields L2_Receive
L2_ReceiveSettlementId
string
The identifier for the trade.
L2_ReceiveSettlementCurrency
string
Example: GBP
A currency for of settlement instruction
L2_ReceiveSettlementDirection
string
The direction in which the settlement details refer to, supported directions are: PAY, RECEIVE, BOTH
L2_ReceiveIsDefaultSettlementInstruction
boolean
Is this the default settlement instruction for this currency
L2_ReceiveSettlementInstructionType
string
Example: EXISTING
The type of settlement instruction attached to a trade. Supported types are [EXISTING, ADHOC, NONE]
L2_ReceiveSettlementDisplayName
string
Example: [CCY] Account 1
The name of the settlement instruction. This field can be omitted.
L2_ReceiveSettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L2_ReceiveBankAccount
string
Example: 12345678
The account number of the bank
L2_ReceiveBankSwift
string
Example: CAP123
The BIC of the bank
L2_ReceiveBankName
string
Example: Bank Of Caplin
The name of the bank
L2_ReceiveBankAddress1
string
Example: 12 Capitol
The first line of the bank's address
L2_ReceiveBankAddress2
string
Example: The City
The second line of the bank's address
L2_ReceiveBankAddress3
string
Example: London
The third line of the bank's address
L2_ReceiveIndividualAccount
string
Example: 87654321
The account number of the recipient
L2_ReceiveIndividualSwift
string
Example: SOLD987
The BIC of the recipient's account
L2_ReceiveIndividualName
string
Example: Susan Sellers
The name of the payee or payee's bank
L2_ReceiveIndividualAddress1
string
Example: 98 Lane
The first line of the recipient
L2_ReceiveIndividualAddress2
string
Example: Manchester
The second line of the recipient
L2_ReceiveNettingStatus
string
Example: NETTED
The status that denotes the permanent netting state of a settlement. This is required to know which settlements have been netted and which have not
L2_CanAffirm
boolean
Can affirm settlement instructions for a trade.
L2_CanConfirm
boolean
Can confirm settlement instructions for a trade.
L2_CanAdHoc
boolean
Can confirm adhoc settlement instructions for a trade.
L2_SettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L2_NextActionDeadline
datetime
Example: 2018-03-16T07:25:16+00:00
The deadline for a user to perform a trade's next action in ISO-8601 format
L2_NextActionDeadlineDisplayTimezone
string
Example: America/New_York
The timezone for the NextActionDeadline field in the form Area/Location
L2_AffirmedBy
string
The name of the user who affirmed a trade.
L2_AffirmedDateTime
datetime
Example: 2018-03-16T07:25:16+00:00
The time at which a trade was affirmed in ISO-8601 format format
L2_ConfirmedBy
string
The name of the user who confirmed a trade.
L2_ConfirmedDateTime
datetime
Example: 2018-03-16T07:25:16+00:00
The time at which a trade was confirmed in ISO-8601 format format
L2_AllInRate
decimal
Example: 1.091790
L2_AllInRateDPS
integer
Example: 5
L2_AllInMidRate
decimal
Example: 1.091790
L2_FwdPoints
decimal
Example: 0.001198
L2_FwdMidPoints
decimal
Example: 0.005390
L2_FwdPips
string
Example: 11.98
L2_BuySell
string
The direction of the trade. This always refers to the BaseCurrency, NOT the DealtCurrency.
L2_Amount
decimal
The amount of a trade or order in the DealtCurrency.
L2_ContraAmount
decimal
Example: 350
The amount that is exchanged for the Amount. This will be defined in the contra currency of the DealtCurrency.
L2_Tenor
string
Example: 1M
Supported types are [ON, [TODAY, TOD, TD], TN, [TOM, ND], SPOT, SN, 1D, 1W, 2W, 3W, 4W, 1M, 2M, 4M, 5M, 6M, 7M, 8M, 9M, 10M, 11M, [1Y, 12M], 15M, 18M, 21M, [2Y, 24M], [3Y, 36M], [4Y, 48M], [5Y, 60M], broken]. broken indicates that a SettlementDate must be sent
L2_SettlementDate
string
L2_Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
L2_Profit
decimal
Example: 1000
The sales profit in the specified currency.
L2_CostAmount
decimal
Example: 12412891.31
The total transactional cost of performing the trade to the client
SwapTradeConfirmationFields
SwapPoints
decimal
Example: 0.005390
SwapMidPoints
decimal
Example: 0.004553
SwapPips
string
Example: 53.90
SwapType
string
Example: SPOTFWD
SwapSalesBlotterRecord
CommonBlotterFields
BaseCurrency
string
Example: USD
TradingType
string
Caplin supported values are [SPOT, FWD, NDF, SWAP, TIME_OPTION]. See the constants defined within com.caplin.motif.fx.trading.FXTradingType for further details.
Status
string
Use OrderStatus instead.
IsReversible
boolean
Whether a trade can be reversed.
IsAmendable
boolean
Whether a trade can be amended.
IsCancellable
boolean
Whether a trade can be cancelled.
SwapSalesTradeConfirmation
SwapTradeConfirmation
CommonTradeConfirmationFields
TradeID
string
CurrencyPair
string
The currency pair for the trade. For example, EURUSD
DealtCurrency
string
The currency of the Amount of a trade or order.
SpotRate
decimal
Example: 1.08341
SpotMidRate
decimal
Example: 1.08345
The mid rate between the SpotAskRate and SpotBidRate. Note that this will not always be precisely between.
SpotRateDPS
integer
Example: 5
The number of decimal places to display after the decimal point.
ExecutionDateTime
string
Example: 20160322123621
TradeDate
string
Example: 20160314
Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
TraderUsername
string
TOBOUser
string
The user the trade is on behalf of. For example, if the logged in user dealer1@novobank.co.za wishes to make a trade on behalf of user bob_treasurer, then the value of this field will be bob_treasurer.
AssetType
string
TradingType
string
Caplin supported values are [SPOT, FWD, NDF, SWAP, TIME_OPTION]. See the constants defined within com.caplin.motif.fx.trading.FXTradingType for further details.
DigitsBeforePips
integer
Example: 2
Precision-related field that tells the client how to display rates. This is the number of digits between the decimal point and the pips (i.e the big digits that the client wants to look at). For most currency pairs the value of this bla will be 2, i.e. for a USDGBP rate of 1.23456 the pips are 45 so there are two digits between the decimal point and the pips. For USDJPY the rate could be 103.256 and the pips are the 25, so in this case the value of DigitsBeforePips should be 0.
NumberOfPips
integer
Example: 2
Precision-related field that tells the client how to display rates. This is the number of pips the client wants to look at. Normally this value is 2.
OrderID
string
The id of the order.
WarningCode
string
Example: 001
The code for the warning regarding a quote request.
WarningMessage
string
Example: You do not have sufficient credit for EUR
The message to display for any warnings regarding a quote request
Client
string
Client is a duplicate of TOBOUser
CostAmount
decimal
Example: 12412891.31
The total transactional cost of performing the trade to the client
CostCurrency
string
Example: GBP
The currency that the cost is displayed in, this could be any currency but will typically be set to the Term Currency
CostPercentage
decimal
Example: 13.56
Percentage of the overall price which is the transactional cost to the client of performing the trade. This number should be out of 100, where 100.0 represents 100%.
IsReversible
boolean
Whether a trade can be reversed.
IsAmendable
boolean
Whether a trade can be amended.
IsCancellable
boolean
Whether a trade can be cancelled.
CostCurrencyDPS
integer
Example: 2
The number of decimal places to display after the decimal point.
LegTradeConfirmationFields L1
SettlementTradeFields L1
SettlementFields L1_Pay
L1_PaySettlementId
string
The identifier for the trade.
L1_PaySettlementCurrency
string
Example: GBP
A currency for of settlement instruction
L1_PaySettlementDirection
string
The direction in which the settlement details refer to, supported directions are: PAY, RECEIVE, BOTH
L1_PayIsDefaultSettlementInstruction
boolean
Is this the default settlement instruction for this currency
L1_PaySettlementInstructionType
string
Example: EXISTING
The type of settlement instruction attached to a trade. Supported types are [EXISTING, ADHOC, NONE]
L1_PaySettlementDisplayName
string
Example: [CCY] Account 1
The name of the settlement instruction. This field can be omitted.
L1_PaySettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L1_PayBankAccount
string
Example: 12345678
The account number of the bank
L1_PayBankSwift
string
Example: CAP123
The BIC of the bank
L1_PayBankName
string
Example: Bank Of Caplin
The name of the bank
L1_PayBankAddress1
string
Example: 12 Capitol
The first line of the bank's address
L1_PayBankAddress2
string
Example: The City
The second line of the bank's address
L1_PayBankAddress3
string
Example: London
The third line of the bank's address
L1_PayIndividualAccount
string
Example: 87654321
The account number of the recipient
L1_PayIndividualSwift
string
Example: SOLD987
The BIC of the recipient's account
L1_PayIndividualName
string
Example: Susan Sellers
The name of the payee or payee's bank
L1_PayIndividualAddress1
string
Example: 98 Lane
The first line of the recipient
L1_PayIndividualAddress2
string
Example: Manchester
The second line of the recipient
L1_PayNettingStatus
string
Example: NETTED
The status that denotes the permanent netting state of a settlement. This is required to know which settlements have been netted and which have not
SettlementFields L1_Receive
L1_ReceiveSettlementId
string
The identifier for the trade.
L1_ReceiveSettlementCurrency
string
Example: GBP
A currency for of settlement instruction
L1_ReceiveSettlementDirection
string
The direction in which the settlement details refer to, supported directions are: PAY, RECEIVE, BOTH
L1_ReceiveIsDefaultSettlementInstruction
boolean
Is this the default settlement instruction for this currency
L1_ReceiveSettlementInstructionType
string
Example: EXISTING
The type of settlement instruction attached to a trade. Supported types are [EXISTING, ADHOC, NONE]
L1_ReceiveSettlementDisplayName
string
Example: [CCY] Account 1
The name of the settlement instruction. This field can be omitted.
L1_ReceiveSettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L1_ReceiveBankAccount
string
Example: 12345678
The account number of the bank
L1_ReceiveBankSwift
string
Example: CAP123
The BIC of the bank
L1_ReceiveBankName
string
Example: Bank Of Caplin
The name of the bank
L1_ReceiveBankAddress1
string
Example: 12 Capitol
The first line of the bank's address
L1_ReceiveBankAddress2
string
Example: The City
The second line of the bank's address
L1_ReceiveBankAddress3
string
Example: London
The third line of the bank's address
L1_ReceiveIndividualAccount
string
Example: 87654321
The account number of the recipient
L1_ReceiveIndividualSwift
string
Example: SOLD987
The BIC of the recipient's account
L1_ReceiveIndividualName
string
Example: Susan Sellers
The name of the payee or payee's bank
L1_ReceiveIndividualAddress1
string
Example: 98 Lane
The first line of the recipient
L1_ReceiveIndividualAddress2
string
Example: Manchester
The second line of the recipient
L1_ReceiveNettingStatus
string
Example: NETTED
The status that denotes the permanent netting state of a settlement. This is required to know which settlements have been netted and which have not
L1_CanAffirm
boolean
Can affirm settlement instructions for a trade.
L1_CanConfirm
boolean
Can confirm settlement instructions for a trade.
L1_CanAdHoc
boolean
Can confirm adhoc settlement instructions for a trade.
L1_SettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L1_NextActionDeadline
datetime
Example: 2018-03-16T07:25:16+00:00
The deadline for a user to perform a trade's next action in ISO-8601 format
L1_NextActionDeadlineDisplayTimezone
string
Example: America/New_York
The timezone for the NextActionDeadline field in the form Area/Location
L1_AffirmedBy
string
The name of the user who affirmed a trade.
L1_AffirmedDateTime
datetime
Example: 2018-03-16T07:25:16+00:00
The time at which a trade was affirmed in ISO-8601 format format
L1_ConfirmedBy
string
The name of the user who confirmed a trade.
L1_ConfirmedDateTime
datetime
Example: 2018-03-16T07:25:16+00:00
The time at which a trade was confirmed in ISO-8601 format format
L1_AllInRate
decimal
Example: 1.091790
L1_AllInRateDPS
integer
Example: 5
L1_AllInMidRate
decimal
Example: 1.091790
L1_FwdPoints
decimal
Example: 0.001198
L1_FwdMidPoints
decimal
Example: 0.005390
L1_FwdPips
string
Example: 11.98
L1_BuySell
string
The direction of the trade. This always refers to the BaseCurrency, NOT the DealtCurrency.
L1_Amount
decimal
The amount of a trade or order in the DealtCurrency.
L1_ContraAmount
decimal
Example: 350
The amount that is exchanged for the Amount. This will be defined in the contra currency of the DealtCurrency.
L1_Tenor
string
Example: 1M
Supported types are [ON, [TODAY, TOD, TD], TN, [TOM, ND], SPOT, SN, 1D, 1W, 2W, 3W, 4W, 1M, 2M, 4M, 5M, 6M, 7M, 8M, 9M, 10M, 11M, [1Y, 12M], 15M, 18M, 21M, [2Y, 24M], [3Y, 36M], [4Y, 48M], [5Y, 60M], broken]. broken indicates that a SettlementDate must be sent
L1_SettlementDate
string
L1_Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
L1_Profit
decimal
Example: 1000
The sales profit in the specified currency.
L1_CostAmount
decimal
Example: 12412891.31
The total transactional cost of performing the trade to the client
LegTradeConfirmationFields L2
SettlementTradeFields L2
SettlementFields L2_Pay
L2_PaySettlementId
string
The identifier for the trade.
L2_PaySettlementCurrency
string
Example: GBP
A currency for of settlement instruction
L2_PaySettlementDirection
string
The direction in which the settlement details refer to, supported directions are: PAY, RECEIVE, BOTH
L2_PayIsDefaultSettlementInstruction
boolean
Is this the default settlement instruction for this currency
L2_PaySettlementInstructionType
string
Example: EXISTING
The type of settlement instruction attached to a trade. Supported types are [EXISTING, ADHOC, NONE]
L2_PaySettlementDisplayName
string
Example: [CCY] Account 1
The name of the settlement instruction. This field can be omitted.
L2_PaySettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L2_PayBankAccount
string
Example: 12345678
The account number of the bank
L2_PayBankSwift
string
Example: CAP123
The BIC of the bank
L2_PayBankName
string
Example: Bank Of Caplin
The name of the bank
L2_PayBankAddress1
string
Example: 12 Capitol
The first line of the bank's address
L2_PayBankAddress2
string
Example: The City
The second line of the bank's address
L2_PayBankAddress3
string
Example: London
The third line of the bank's address
L2_PayIndividualAccount
string
Example: 87654321
The account number of the recipient
L2_PayIndividualSwift
string
Example: SOLD987
The BIC of the recipient's account
L2_PayIndividualName
string
Example: Susan Sellers
The name of the payee or payee's bank
L2_PayIndividualAddress1
string
Example: 98 Lane
The first line of the recipient
L2_PayIndividualAddress2
string
Example: Manchester
The second line of the recipient
L2_PayNettingStatus
string
Example: NETTED
The status that denotes the permanent netting state of a settlement. This is required to know which settlements have been netted and which have not
SettlementFields L2_Receive
L2_ReceiveSettlementId
string
The identifier for the trade.
L2_ReceiveSettlementCurrency
string
Example: GBP
A currency for of settlement instruction
L2_ReceiveSettlementDirection
string
The direction in which the settlement details refer to, supported directions are: PAY, RECEIVE, BOTH
L2_ReceiveIsDefaultSettlementInstruction
boolean
Is this the default settlement instruction for this currency
L2_ReceiveSettlementInstructionType
string
Example: EXISTING
The type of settlement instruction attached to a trade. Supported types are [EXISTING, ADHOC, NONE]
L2_ReceiveSettlementDisplayName
string
Example: [CCY] Account 1
The name of the settlement instruction. This field can be omitted.
L2_ReceiveSettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L2_ReceiveBankAccount
string
Example: 12345678
The account number of the bank
L2_ReceiveBankSwift
string
Example: CAP123
The BIC of the bank
L2_ReceiveBankName
string
Example: Bank Of Caplin
The name of the bank
L2_ReceiveBankAddress1
string
Example: 12 Capitol
The first line of the bank's address
L2_ReceiveBankAddress2
string
Example: The City
The second line of the bank's address
L2_ReceiveBankAddress3
string
Example: London
The third line of the bank's address
L2_ReceiveIndividualAccount
string
Example: 87654321
The account number of the recipient
L2_ReceiveIndividualSwift
string
Example: SOLD987
The BIC of the recipient's account
L2_ReceiveIndividualName
string
Example: Susan Sellers
The name of the payee or payee's bank
L2_ReceiveIndividualAddress1
string
Example: 98 Lane
The first line of the recipient
L2_ReceiveIndividualAddress2
string
Example: Manchester
The second line of the recipient
L2_ReceiveNettingStatus
string
Example: NETTED
The status that denotes the permanent netting state of a settlement. This is required to know which settlements have been netted and which have not
L2_CanAffirm
boolean
Can affirm settlement instructions for a trade.
L2_CanConfirm
boolean
Can confirm settlement instructions for a trade.
L2_CanAdHoc
boolean
Can confirm adhoc settlement instructions for a trade.
L2_SettlementStatus
string
Caplin supported statuses are [PENDING, AFFIRMED, CONFIRMED, OVERDUE, REJECTED]
L2_NextActionDeadline
datetime
Example: 2018-03-16T07:25:16+00:00
The deadline for a user to perform a trade's next action in ISO-8601 format
L2_NextActionDeadlineDisplayTimezone
string
Example: America/New_York
The timezone for the NextActionDeadline field in the form Area/Location
L2_AffirmedBy
string
The name of the user who affirmed a trade.
L2_AffirmedDateTime
datetime
Example: 2018-03-16T07:25:16+00:00
The time at which a trade was affirmed in ISO-8601 format format
L2_ConfirmedBy
string
The name of the user who confirmed a trade.
L2_ConfirmedDateTime
datetime
Example: 2018-03-16T07:25:16+00:00
The time at which a trade was confirmed in ISO-8601 format format
L2_AllInRate
decimal
Example: 1.091790
L2_AllInRateDPS
integer
Example: 5
L2_AllInMidRate
decimal
Example: 1.091790
L2_FwdPoints
decimal
Example: 0.001198
L2_FwdMidPoints
decimal
Example: 0.005390
L2_FwdPips
string
Example: 11.98
L2_BuySell
string
The direction of the trade. This always refers to the BaseCurrency, NOT the DealtCurrency.
L2_Amount
decimal
The amount of a trade or order in the DealtCurrency.
L2_ContraAmount
decimal
Example: 350
The amount that is exchanged for the Amount. This will be defined in the contra currency of the DealtCurrency.
L2_Tenor
string
Example: 1M
Supported types are [ON, [TODAY, TOD, TD], TN, [TOM, ND], SPOT, SN, 1D, 1W, 2W, 3W, 4W, 1M, 2M, 4M, 5M, 6M, 7M, 8M, 9M, 10M, 11M, [1Y, 12M], 15M, 18M, 21M, [2Y, 24M], [3Y, 36M], [4Y, 48M], [5Y, 60M], broken]. broken indicates that a SettlementDate must be sent
L2_SettlementDate
string
L2_Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
L2_Profit
decimal
Example: 1000
The sales profit in the specified currency.
L2_CostAmount
decimal
Example: 12412891.31
The total transactional cost of performing the trade to the client
SwapTradeConfirmationFields
SwapPoints
decimal
Example: 0.005390
SwapMidPoints
decimal
Example: 0.004553
SwapPips
string
Example: 53.90
SwapType
string
Example: SPOTFWD
SalesLegTradeConfirmationFields L1
L1_TraderAllInRate
decimal
Example: 1.005390
The all-in rate, with no client margin applied to it
L1_TraderFwdPoints
decimal
Example: 0.005390
The forward points with no client margin applied to them.
L1_FwdMargin
decimal
Example: 0.000019
The Forward margin that the user has selected. This field should be sent raw and unformatted.
L1_AllInMargin
decimal
Example: 0.00054
The sales user's selected SpotMargin added to the sales user's selected L1_FwdMargin.
SalesLegTradeConfirmationFields L2
L2_TraderAllInRate
decimal
Example: 1.005390
The all-in rate, with no client margin applied to it
L2_TraderFwdPoints
decimal
Example: 0.005390
The forward points with no client margin applied to them.
L2_FwdMargin
decimal
Example: 0.000019
The Forward margin that the user has selected. This field should be sent raw and unformatted.
L2_AllInMargin
decimal
Example: 0.00054
The sales user's selected SpotMargin added to the sales user's selected L1_FwdMargin.
SalesCommonTradeConfirmationFields
ProfitCurrency
string
Example: USD
The profit currency that the ProfitBidRate is being provided for.
ProfitCurrencyDPS
integer
Example: 5
The number of decimal places that should be used for formatting the amount in profit currency field.
ProfitRate
decimal
Example: 1.091790
The conversion rate from the contra currency into the profit currency.
TraderSpotRate
decimal
Example: 1.09174
Can be formatted using DigitsBeforePips, NumberOfPips and SpotRateDPS
SpotMargin
decimal
Example: 0.00054
Can be formatted using DigitsBeforePips, NumberOfPips and SpotRateDPS
Profit
decimal
Example: 1000
The sales profit in the specified currency.
Competition
boolean
Whether a quote request is in competition. For example, true for quotes from an ECN and false for quotes from an SDP
Source
string
The source of a quote request. The name or ID of an ECN, SDP or other channel
Reason
string
The reason that a quote requires intervention. For example, because it exceeds GFA
SalesSwapTradeConfirmationFields
TraderSwapPoints
decimal
Example: 0.004211
The spot points with no client margins applied to them.
SwapMargin
decimal
Example: 0.000040
The swap margin that the sales user has selected. It should be sent as a raw value, and unformatted.
InterventionSpotBlotterRecord
SpotTradeDetails
CommonTradeDetailsFields
Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
TOBOUser
string
The user the trade is on behalf of. For example, if the logged in user dealer1@novobank.co.za wishes to make a trade on behalf of user bob_treasurer, then the value of this field will be bob_treasurer.
OneWayDirection
string
LastActionDateTime
datetime
The time and date of the last action on an order.
RequestedDateTime
datetime
TradeDetailsFields
CurrencyPair
string
The currency pair for the trade. For example, EURUSD
DealtCurrency
string
The currency of the Amount of a trade or order.
NettedAmount
decimal
TradingType
string
Caplin supported values are [SPOT, FWD, NDF, SWAP, TIME_OPTION]. See the constants defined within com.caplin.motif.fx.trading.FXTradingType for further details.
InterventionTradeDetailsFields
InterventionStatus
string
Use the TradeStatus field instead
TradeStatus
string
Example: AWAITING-PRICE
The current status of the trade. Supported types are [AWAITING-TRADER, AWAITING-PRICE, PRICED, EXECUTING, CLOSED, REJECTED, ERRORED, COMPLETED]. CLOSED means the client cancelled the trade request, REJECTED indicates it was rejected by the dealer.
Dealable
boolean
Whether a trade request can be picked up by a sales trader
PricingMode
string
Example: AUTO
Whether the trade is being automatically or manually priced. Supported types are [AUTO, MANUAL]
Competition
boolean
Whether a quote request is in competition. For example, true for quotes from an ECN and false for quotes from an SDP
Reason
string
The reason that a quote requires intervention. For example, because it exceeds GFA
TradeRequestID
string
Source
string
The source of a quote request. The name or ID of an ECN, SDP or other channel
Trader
string
LegTradeDetailsFields L1
L1_Amount
decimal
The amount of a trade or order in the DealtCurrency.
L1_SettlementDate
string
L1_Tenor
string
Example: 1M
Supported types are [ON, [TODAY, TOD, TD], TN, [TOM, ND], SPOT, SN, 1D, 1W, 2W, 3W, 4W, 1M, 2M, 4M, 5M, 6M, 7M, 8M, 9M, 10M, 11M, [1Y, 12M], 15M, 18M, 21M, [2Y, 24M], [3Y, 36M], [4Y, 48M], [5Y, 60M], broken]. broken indicates that a SettlementDate must be sent
L1_BuySell
string
The direction of the trade. This always refers to the BaseCurrency, NOT the DealtCurrency.
L1_Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
InterventionForwardBlotterRecord
ForwardTradeDetails
CommonTradeDetailsFields
Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
TOBOUser
string
The user the trade is on behalf of. For example, if the logged in user dealer1@novobank.co.za wishes to make a trade on behalf of user bob_treasurer, then the value of this field will be bob_treasurer.
OneWayDirection
string
LastActionDateTime
datetime
The time and date of the last action on an order.
RequestedDateTime
datetime
TradeDetailsFields
CurrencyPair
string
The currency pair for the trade. For example, EURUSD
DealtCurrency
string
The currency of the Amount of a trade or order.
NettedAmount
decimal
TradingType
string
Caplin supported values are [SPOT, FWD, NDF, SWAP, TIME_OPTION]. See the constants defined within com.caplin.motif.fx.trading.FXTradingType for further details.
InterventionTradeDetailsFields
InterventionStatus
string
Use the TradeStatus field instead
TradeStatus
string
Example: AWAITING-PRICE
The current status of the trade. Supported types are [AWAITING-TRADER, AWAITING-PRICE, PRICED, EXECUTING, CLOSED, REJECTED, ERRORED, COMPLETED]. CLOSED means the client cancelled the trade request, REJECTED indicates it was rejected by the dealer.
Dealable
boolean
Whether a trade request can be picked up by a sales trader
PricingMode
string
Example: AUTO
Whether the trade is being automatically or manually priced. Supported types are [AUTO, MANUAL]
Competition
boolean
Whether a quote request is in competition. For example, true for quotes from an ECN and false for quotes from an SDP
Reason
string
The reason that a quote requires intervention. For example, because it exceeds GFA
TradeRequestID
string
Source
string
The source of a quote request. The name or ID of an ECN, SDP or other channel
Trader
string
LegTradeDetailsFields L1
L1_Amount
decimal
The amount of a trade or order in the DealtCurrency.
L1_SettlementDate
string
L1_Tenor
string
Example: 1M
Supported types are [ON, [TODAY, TOD, TD], TN, [TOM, ND], SPOT, SN, 1D, 1W, 2W, 3W, 4W, 1M, 2M, 4M, 5M, 6M, 7M, 8M, 9M, 10M, 11M, [1Y, 12M], 15M, 18M, 21M, [2Y, 24M], [3Y, 36M], [4Y, 48M], [5Y, 60M], broken]. broken indicates that a SettlementDate must be sent
L1_BuySell
string
The direction of the trade. This always refers to the BaseCurrency, NOT the DealtCurrency.
L1_Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
NDFLegTradeDetailsFields L1
L1_FixingDate
string
Example: 20150620
TimeOptionLegTradeDetailsFields L1
L1_StartDate
string
Example: 20150620
L1_StartTenor
string
Example: 1W
InterventionSwapBlotterRecord
SwapTradeDetails
CommonTradeDetailsFields
Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
TOBOUser
string
The user the trade is on behalf of. For example, if the logged in user dealer1@novobank.co.za wishes to make a trade on behalf of user bob_treasurer, then the value of this field will be bob_treasurer.
OneWayDirection
string
LastActionDateTime
datetime
The time and date of the last action on an order.
RequestedDateTime
datetime
TradeDetailsFields
CurrencyPair
string
The currency pair for the trade. For example, EURUSD
DealtCurrency
string
The currency of the Amount of a trade or order.
NettedAmount
decimal
TradingType
string
Caplin supported values are [SPOT, FWD, NDF, SWAP, TIME_OPTION]. See the constants defined within com.caplin.motif.fx.trading.FXTradingType for further details.
InterventionTradeDetailsFields
InterventionStatus
string
Use the TradeStatus field instead
TradeStatus
string
Example: AWAITING-PRICE
The current status of the trade. Supported types are [AWAITING-TRADER, AWAITING-PRICE, PRICED, EXECUTING, CLOSED, REJECTED, ERRORED, COMPLETED]. CLOSED means the client cancelled the trade request, REJECTED indicates it was rejected by the dealer.
Dealable
boolean
Whether a trade request can be picked up by a sales trader
PricingMode
string
Example: AUTO
Whether the trade is being automatically or manually priced. Supported types are [AUTO, MANUAL]
Competition
boolean
Whether a quote request is in competition. For example, true for quotes from an ECN and false for quotes from an SDP
Reason
string
The reason that a quote requires intervention. For example, because it exceeds GFA
TradeRequestID
string
Source
string
The source of a quote request. The name or ID of an ECN, SDP or other channel
Trader
string
LegTradeDetailsFields L1
L1_Amount
decimal
The amount of a trade or order in the DealtCurrency.
L1_SettlementDate
string
L1_Tenor
string
Example: 1M
Supported types are [ON, [TODAY, TOD, TD], TN, [TOM, ND], SPOT, SN, 1D, 1W, 2W, 3W, 4W, 1M, 2M, 4M, 5M, 6M, 7M, 8M, 9M, 10M, 11M, [1Y, 12M], 15M, 18M, 21M, [2Y, 24M], [3Y, 36M], [4Y, 48M], [5Y, 60M], broken]. broken indicates that a SettlementDate must be sent
L1_BuySell
string
The direction of the trade. This always refers to the BaseCurrency, NOT the DealtCurrency.
L1_Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>
LegTradeDetailsFields L2
L2_Amount
decimal
The amount of a trade or order in the DealtCurrency.
L2_SettlementDate
string
L2_Tenor
string
Example: 1M
Supported types are [ON, [TODAY, TOD, TD], TN, [TOM, ND], SPOT, SN, 1D, 1W, 2W, 3W, 4W, 1M, 2M, 4M, 5M, 6M, 7M, 8M, 9M, 10M, 11M, [1Y, 12M], 15M, 18M, 21M, [2Y, 24M], [3Y, 36M], [4Y, 48M], [5Y, 60M], broken]. broken indicates that a SettlementDate must be sent
L2_BuySell
string
The direction of the trade. This always refers to the BaseCurrency, NOT the DealtCurrency.
L2_Account
string
Example: Garfields|GARF
The account a trade or order has been submitted against. The format is <description>|<name> or <name>|<name>