ZagTrader

fxtr: Foreign Exchange Trade

fxtr.017 Foreign Exchange Trade Status And Details Notification

Written and maintained by ZagTrader. Last reviewed . How this page is sourced and checked

fxtr.017 is the ISO 20022 ForeignExchangeTradeStatusAndDetailsNotification message in the Foreign Exchange Trade business area (fxtr). The latest version is fxtr.017.001.06, and 5 versions are in the repository.

Message
ForeignExchangeTradeStatusAndDetailsNotification
Latest version
fxtr.017.001.06
Submitting organisation
CLS
MT equivalent
None listed

In use: published in the current ISO 20022 catalogue.

What fxtr.017 is for

The ForeignExchangeTradeStatusAndDetails message is sent by a central system to the participant to provide notification of the status and details of a foreign exchange trade.

The notification is sent by a central settlement system to the two trading parties after it has received foreign exchange trade instructions from both.

Definition from the ISO 20022 e-Repository, release of 24 April 2025.

fxtr.017 versions

Every version published in the e-Repository, newest first. A message keeps its business purpose across versions; each new version is a separate schema with its own namespace.

VersionRegistration statusPublished in
fxtr.017.001.06latestRegisteredLatest version set
fxtr.017.001.05RegisteredPrevious version set
fxtr.017.001.04RegisteredArchive
fxtr.017.001.03RegisteredArchive
fxtr.017.001.02RegisteredArchive

fxtr.017 message structure

The building blocks of fxtr.017.001.06 and the elements directly under them, with multiplicity ([0..1] optional, [1..1] mandatory, * any number) and the data type or component. Element names and definitions are from the ISO 20022 repository; usage guidelines such as CBPR+ or a market infrastructure's rules can restrict them further.

  • Document [1..1]
    • FXTradStsAndDtlsNtfctn ForeignExchangeTradeStatusAndDetailsNotification [1..1]
      • StsDtls Status Details [1..1]TradeData14

        Provides information on the status of a foreign exchange trade in the central system.

        • MtchgSysUnqRef Matching System Unique Reference [1..1]Max35Text

          Reference to the unique system identification assigned to the trade by the central matching system.

        • MtchgSysMtchgRef Matching System Matching Reference [0..1]Max35Text

          Reference to the unique matching identification assigned to the trade and to the matching trade from the counterparty by the central matching system.

        • MtchgSysMtchdSdRef Matching System Matched Side Reference [0..1]Max35Text

          Unique reference from the central settlement system that allows the removal of alleged trades once the matched status notification for the matching...

        • StsOrgtr Status Originator [0..1]Max35Text

          Party that assigned the status to the trade.

        • CurSts Current Status [1..1]StatusAndSubStatus2

          Specifies the new status of the trade.

        • CurStsSubTp Current Status Sub Type [0..1]StatusSubType2Code

          Additional information about the current status of the trade.

        • CurStsDtTm Current Status Date Time [0..1]ISODateTime

          Specifies the date and time at which the current status was assigned.

        • PrvsSts Previous Status [0..1]Status28Choice (choice)

          Specifies the previous status of the trade.

        • AllgdTrad Alleged Trade [0..1]YesNoIndicator

          Specifies whether a trade is alleged or not.

        • PrvsStsSubTp Previous Status Sub Type [0..1]StatusSubType2Code

          Additional information on the previous status of a trade in a central system.

      • TradInf Trade Information [1..1]TradeAgreement12

        General information related to the foreign exchange trade.

        • TradDt Trade Date [1..1]ISODate

          Date on which the trading parties agreed on the trade.

        • MsgId Message Identification [1..1]Max35Text

          Identification of the present message assigned by the party issuing the message.

        • OrgtrRef Originator Reference [1..1]Max35Text

          Represents the original reference of the instruction for which the status is given, as assigned by the participant that submitted the foreign...

        • CmonRef Common Reference [0..1]Max35Text

          Reference common to both parties of the trade.

        • AmdOrCclRsn Amend Or Cancel Reason [0..1]Max35Text

          Specifies the reason for the cancellation or the amendment.

        • RltdRef Related Reference [0..1]Max35Text

          Reference to the identification of a previous event in the life of a trade which is amended or cancelled.

        • PdctTp Product Type [0..1]Max35Text

          Specifies the product for which the status of the confirmation is reported.

        • OprTp Operation Type [0..1]Max4Text

          Specifies the type of underlying transaction, for example cancellation (CANC).

        • OprScp Operation Scope [0..1]Max4Text

          Specifies the business role between the submitter and the trade party, for example, agent (AGNT).

        • SttlmSsnIdr Settlement Session Identifier [0..1]Exact4AlphaNumericText

          To indicate the requested CLS settlement session that the related trade is part of.

        • SpltTradInd Split Trade Indicator [1..1]YesNoIndicator

          To indicate if the trade is split.

        • PmtVrssPmtInd Payment Versus Payment Indicator [0..1]YesNoIndicator

          Specifies if the FX transaction is PVP settlement.

      • TradgSdId Trading Side Identification [1..1]TradePartyIdentification8

        Party(ies) on the trading side of the foreign exchange trade.

        • SubmitgPty Submitting Party [1..1]PartyIdentification242Choice (choice)

          Party that submits the foreign exchange trade to the matching system or to the settlement system or to the counterparty.

        • TradPty Trade Party [0..1]PartyIdentification242Choice (choice)

          Party that originated the foreign exchange trade.

        • FndId Fund Identification [0..*]FundIdentification5

          Identifies the fund that is one of the parties in the foreign exchange trade.

      • CtrPtySdId Counterparty Side Identification [1..1]TradePartyIdentification8

        Party(ies) on the counterparty side of the foreign exchange trade.

        • SubmitgPty Submitting Party [1..1]PartyIdentification242Choice (choice)

          Party that submits the foreign exchange trade to the matching system or to the settlement system or to the counterparty.

        • TradPty Trade Party [0..1]PartyIdentification242Choice (choice)

          Party that originated the foreign exchange trade.

        • FndId Fund Identification [0..*]FundIdentification5

          Identifies the fund that is one of the parties in the foreign exchange trade.

      • TradAmts Trade Amounts [1..1]AmountsAndValueDate8

        Amounts of the foreign exchange trade.

        • TradgSdBuyAmt Trading Side Buy Amount [1..1]CurrencyOrDigitalTokenAmount2Choice (choice)

          Currency and amount bought in a foreign exchange trade.

        • TradgSdSellAmt Trading Side Sell Amount [1..1]CurrencyOrDigitalTokenAmount2Choice (choice)

          Currency and amount sold in a foreign exchange trade.

        • SttlmDt Settlement Date [1..1]ISODate

          Date on which the trade is settled, for example, the amounts are due.

      • AgrdRate Agreed Rate [1..1]AgreedRate3

        Exchange rate as agreed by the traders.

        • XchgRate Exchange Rate [1..1]BaseOneRate

          The value of one currency expressed in relation to another currency.

        • UnitCcy Unit Currency [0..1]ActiveCurrencyCode

          Currency in which the rate of exchange is expressed in a currency exchange.

        • QtdCcy Quoted Currency [0..1]ActiveCurrencyCode

          Currency into which the base currency is converted, in a currency exchange.

      • NDFConds Non Deliverable Forward Conditions [0..1]NonDeliverableForwardConditions2

        Provides the opening and fixing information for an NDF trade.

        • OpngConds Opening Conditions [1..1]OpeningConditions1

          Provides the opening information associated with an NDF trade.

        • FxgConds Fixing Conditions [0..1]FixingConditions1

          Provides the additional information for an NDF as supplied on a fixing instruction.

      • TradgSdSttlmInstrs Trading Side Settlement Instructions [0..1]SettlementParties120

        Settlement instructions for the amounts received by the trading side.

        • DlvryAgt Delivery Agent [0..1]PartyIdentification242Choice (choice)

          Financial institution from which cash will be transferred.

        • Intrmy Intermediary [0..1]PartyIdentification242Choice (choice)

          Party, within the settlement chain, between the delivery and receiving agents.

        • RcvgAgt Receiving Agent [1..1]PartyIdentification242Choice (choice)

          Financial institution where the payee will receive the funds.

        • BnfcryInstn Beneficiary Institution [0..1]PartyIdentification242Choice (choice)

          Ultimate institution that will receive the funds when different from the trading or counterparty side.

      • CtrPtySdSttlmInstrs Counterparty Side Settlement Instructions [0..1]SettlementParties120

        Settlement instructions for the amounts received by the counterparty.

        • DlvryAgt Delivery Agent [0..1]PartyIdentification242Choice (choice)

          Financial institution from which cash will be transferred.

        • Intrmy Intermediary [0..1]PartyIdentification242Choice (choice)

          Party, within the settlement chain, between the delivery and receiving agents.

        • RcvgAgt Receiving Agent [1..1]PartyIdentification242Choice (choice)

          Financial institution where the payee will receive the funds.

        • BnfcryInstn Beneficiary Institution [0..1]PartyIdentification242Choice (choice)

          Ultimate institution that will receive the funds when different from the trading or counterparty side.

      • GnlInf General Information [0..1]GeneralInformation9

        Additional Information about the foreign exchange trade.

        • BlckInd Block Indicator [0..1]YesNoIndicator

          Indicates whether the trade is a block or single trade.

        • RltdTradRef Related Trade Reference [0..1]Max35Text

          Reference to a preceding transaction, for example, an option or swap.

        • DealgMtd Dealing Method [0..1]Trading1MethodCode

          Method used by the trading parties to negotiate and/or execute a deal.

        • BrkrId Broker Identification [0..1]PartyIdentification242Choice (choice)

          Specifies the broker which arranged the deal between the trading side and the counterparty side or, when two money brokers are involved, between the...

        • CtrPtyRef Counterparty Reference [0..1]Max35Text

          Counterparty's reference for the trade.

        • BrkrsComssn Brokers Commission [0..1]ActiveCurrencyAndAmount

          Brokerage fee for a broker confirmation.

        • SndrToRcvrInf Sender To Receiver Information [0..1]Max210Text

          Specifies additional information for the receiver and applies to the whole message.

        • DealgBrnchTradgSd Dealing Branch Trading Side [0..1]PartyIdentification242Choice (choice)

          Specifies the branch at the trading side with which the deal was done.

        • DealgBrnchCtrPtySd Dealing Branch Counterparty Side [0..1]PartyIdentification242Choice (choice)

          Specifies the branch at the counterparty side with which the deal was done.

        • CtctInf Contact Information [0..1]ContactInformation1

          Specifies the name and/or electronic address of the receiver of the message who may be contacted for any queries concerning this trade.

        • AgrmtDtls Agreement Details [0..1]AgreementConditions1

          Specifies the type, date and version of the agreement used in a trade.

        • DefsYr Definitions Year [0..1]ISOYear

          Specifies the year of definitions of the agreement.

        • BrkrsRef Brokers Reference [0..1]Max35Text

          Specifies a reference applied to the trade instruction by a broker.

        • PmtClrCentr Payment Clearing Centre [0..1]CountryCode

          Specifies the place of clearing for offshore currency trades.

        • ClctnAgt Calculation Agent [0..1]CalculationAgent1Choice (choice)

          Specifies the party that will act as calculation agent for a cash-settled trade.

      • SpltTradInf Split Trade Information [0..*]SplitTradeDetails5

        Details of the split trade.

        • StsDtls Status Details [0..1]TradeData16

          Provides information on the status of a foreign exchange trade in the system.

        • TradAmts Trade Amounts [1..1]AmountsAndValueDate8

          Amounts of the foreign exchange trade.

        • AgrdRate Agreed Rate [0..1]AgreedRate3

          Exchange rate as agreed by the traders.

      • RgltryRptg Regulatory Reporting [0..1]RegulatoryReporting8

        Information that is to be provided to trade repositories in the context of the regulatory standards around over-the-counter (OTC) derivatives, central counterparties and trade repositories.

        • TradgSdTxRptg Trading Side Transaction Reporting [0..*]TradingSideTransactionReporting3

          Regulatory transaction reporting information from the Trading Side party.

        • CtrPtySdTxRptg Counterparty Side Transaction Reporting [0..*]CounterpartySideTransactionReporting3

          Regulatory transaction reporting information from the Counterparty Side party.

        • CntrlCtrPtyClrHs Central Counterparty Clearing House [0..1]PartyIdentification242Choice (choice)

          Identifies an agency or separate corporation of a futures exchange responsible for settling and clearing trades, collecting and maintaining margins,...

        • ClrBrkr Clearing Broker [0..1]PartyIdentification242Choice (choice)

          Identifies the party that is a member of the clearing house and that acts as a liaison between the investor and the Central Counterparty (CCP).

        • ClrXcptnPty Clearing Exception Party [0..1]PartyIdentification242Choice (choice)

          Identifies the party that is exempt from a clearing obligation.

        • ClrBrkrId Clearing Broker Identification [0..1]ClearingBrokerIdentification1

          Specifies the reference number assigned by the clearing broker.

        • ClrThrshldInd Clearing Threshold Indicator [0..1]YesNoIndicator

          Specifies whether the contract is above or below the clearing threshold.

        • ClrdPdctId Cleared Product Identification [0..1]Max35Text

          Specifies the reference number assigned by the Central Counterparty (CCP).

        • PdctIdr Product Identifier [0..1]ProductIdentifier3Choice (choice)

          Specifies the underlying product or unique product identifier.

        • AllcnInd Allocation Indicator [0..1]AllocationIndicator1Code

          Specifies whether the trade is a pre-allocation or a post-allocation trade, or whether the trade is unallocated.

        • CollstnInd Collateralisation Indicator [0..1]CollateralisationIndicator1Code

          Specifies whether the transaction is collateralised.

        • ExctnVn Execution Venue [0..1]Max35Text

          Specifies the trading venue of the transaction.

        • ExctnTmstmp Execution Timestamp [0..1]DateAndDateTime2Choice (choice)

          Specifies the date and time of the execution of the transaction in Coordinated Universal Time (UTC).

        • NonStdFlg Non Standard Flag [0..1]YesNoIndicator

          Specifies whether the reportable transaction has one or more additional terms or provisions, other than those listed in the required real-time data...

        • LkSwpId Link Swap Identification [0..1]Exact42Text

          Specifies the common reference or correlation identification for a swap transaction where the near and far leg are confirmed separately.

        • FinNtrOfTheCtrPtyInd Financial Nature Of The Counterparty Indicator [0..1]YesNoIndicator

          Specifies the financial nature of the reporting counterparty.

        • CollPrtflInd Collateral Portfolio Indicator [0..1]YesNoIndicator

          Specifies if the collateral is posted on a portfolio basis.

        • CollPrtflCd Collateral Portfolio Code [0..1]Max10Text

          Identifies the portfolio code to which the trade belongs if the collateral is posted on a portfolio basis (and not trade by trade).

        • PrtflCmprssnInd Portfolio Compression Indicator [0..1]YesNoIndicator

          Indicates if the trade results from portfolio compression.

        • CorpSctrInd Corporate Sector Indicator [0..1]CorporateSectorIdentifier1Code

          Specifies the corporate sector of the counterparty.

        • TradWthNonEEACtrPtyInd Trade With Non EEA Counterparty Indicator [0..1]YesNoIndicator

          Specifies whether the counterparty has entered into a trade with a non-European Economic Area (EEA) counterparty that is not subject to the reporting...

        • NtrgrpTradInd Intragroup Trade Indicator [0..1]YesNoIndicator

          Indicate if a reported trade falls under the definition of intragroup transaction, as defined by European Securities and Markets Authority (ESMA) in...

        • ComrclOrTrsrFincgInd Commercial Or Treasury Financing Indicator [0..1]YesNoIndicator

          Specifies whether the contract is objectively measurable as directly linked to the non-financial counterparty's commercial or treasury financing...

        • FinInstrmId Financial Instrument Identification [0..1]SecurityIdentification19

          Identification of a security, as assigned under a formal or proprietary identification scheme.

        • ConfDtAndTmstmp Confirmation Date And Timestamp [0..1]ISODateTime

          Specifies the date and time of the confirmation of the trade in Universal Time Coordinated (UTC).

        • ClrTmstmp Clearing Timestamp [0..1]ISOTime

          Specifies the time at which the Central Counterparty (CCP) has legally taken on the clearing of the trade in Universal Time Coordinated (UTC).

        • ComssnsAndFees Commissions And Fees [0..*]FXCommissionOrFee1

          Provides the commission and fee type anf amout or rate.

        • AddtlRptgInf Additional Reporting Information [0..1]Max210Text

          Specifies additional information that might be required by the regulator.

      • PstTradEvt Post Trade Event [0..1]PostTradeEvent1

        Information relating to post-trade lifecycle events.

        • Tp Type [1..1]PostTradeEventType2Choice (choice)

          Specifies the type of post trade event.

        • OrgnlRef Original Reference [1..1]Max35Text

          Provides the original trade reference.

        • UndrlygLbltyRef Underlying Liability Reference [0..1]Max35Text

          Related underlying liability, for example a commercial trade.

        • PrftOrLossSttlmDt Profit Or Loss Settlement Date [0..1]ISODate

          Date on which any profit or loss arising from the post-trade event will be settled.

        • PrftOrLoss Profit Or Loss [0..1]ProfitAndLossAmount2

          Amount of profit or loss that is to be settled, after any adjustments have taken place.

        • OutsdngSttlmAmt Outstanding Settlement Amount [0..1]ActiveOrHistoricCurrencyAndAmount

          Amount that remains to be settled, in the specified currency if a trade is partially delivered early or partially unwound.

      • SplmtryData Supplementary Data [0..*]SupplementaryData1

        Additional information that cannot be captured in the structured elements and/or any other specific block.

        • PlcAndNm Place And Name [0..1]Max350Text

          Unambiguous reference to the location where the supplementary data must be inserted in the message instance.

        • Envlp Envelope [1..1]SupplementaryDataEnvelope1

          Technical element wrapping the supplementary data.

Have a fxtr.017 message? Paste it into the parser to see every element with its name and definition, and format checks on BICs, IBANs, dates and amounts.

External code sets used in fxtr.017

These elements take their values from ISO 20022 external code sets, which are published separately and updated every quarter without a new message version.

fxtr.017 questions

What is the latest version of fxtr.017?
The latest version in the ISO 20022 e-Repository release of 24 April 2025 is fxtr.017.001.06.
What is the root element of fxtr.017?
The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:fxtr.017.001.06, and its message element is FXTradStsAndDtlsNtfctn (ForeignExchangeTradeStatusAndDetailsNotification).
Is there an MT equivalent of fxtr.017?
No Swift MT message is listed as its direct equivalent on this site. Many ISO 20022 messages have no MT counterpart.

All ISO 20022 messages · ISO 20022 code sets · MT messages

The ISO 20022 message definitions, element names and definitions on this page are reproduced from material published at iso20022.org under the ISO 20022 Intellectual Property Rights policy. This is not the official source: the up-to-date ISO 20022 standards and repository material are published only at iso20022.org. Explanations in our own words are by ZagTrader. ZagTrader is not affiliated with or endorsed by ISO or Swift.