---
title: "FIX 5.0 SP2 EP299: TradeCaptureReportRequest <AD> message – FIX Dictionary – Onix Solutions"
description: "<meta name=\"description\" content=\"TradeCaptureReportRequest&lt;AD&gt; message &ndash; FIX 5.0 SP2 EP299, FIX protocol version FIX 5.0 SP2 EP299\" /> <meta name=\"keywords\" content=\"message, TradeCaptureReportRequest, MsgType=AD, FIX 5.0 SP2 EP299, FIX Protocol, FIX dictionary\" />"
---

<https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/msgtype_ad_6568.html#>

![Dictionary icon](https://www.onixs.biz/hubfs/SIC_website_2020/images/interface/img-icon-book.svg)

# TradeCaptureReportRequest <AD> message

## FIX 5.0 SP2 EP299

### Description

 The Trade Capture Report Request can be used to:

- Request one or more trade capture reports based upon selection criteria provided on the trade capture report request
- Subscribe for trade capture reports based upon selection criteria provided on the trade capture report request.

 The following criteria can be specified on the Trade Capture Report Request:

- All trades matching specified trade identification: [TradeReportID <571>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_571.html), [SecondaryTradeReportID <818>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_818.html)
- All trades matching specified trade types: [TrdType <828>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_828.html), [TrdSubType <829>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_829.html), [TransferReason <830>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_830.html), [SecondaryTrdType <855>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_855.html), [TradeLinkID <820>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_820.html)
- All trades matching the order identification information: OrderId, [ClOrdID <11>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_11.html), [ExecID <17>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_17.html)
- Trades that have specified [MatchStatus <573>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_573.html)
- All trades for the party defined in the component block [<Parties>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/compBlock_Parties.html) 
    - This can be a trader id, firm, broker id, clearing firm
- All trades for a specific instrument, specified using the component block [<Instrument>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/compBlock_Instrument.html), the component block [<UnderlyingInstrument>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/compBlock_UnderlyingInstrument.html), and/or the component block [<InstrumentLeg>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/compBlock_InstrumentLeg.html).
- All unreported trades - Executions that have not been sent
- All unmatched trades - Trades that have not been matched
- All trades matching specific date and trading session criteria
- Trades entered via a specific [TradeInputSource <578>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_578.html)
- Trades entered via a specific [TradeInputDevice <579>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_579.html)
- All Advisories

 Each field in the Trade Capture Report Request (other than [TradeRequestID <568>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_568.html) and [SubscriptionRequestType <263>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_263.html)) identify filters - trade reports that satisfy all Specified filters will be returned. Note that the filters are combined using an implied "and" - a trade report must satisfy every specified filter to be returned.

 The optional date or time range-specific filter criteria (within [NoDates <580>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_580.html) repeating group) can be used in one of two modes:

- "Since" a time period. [NoDates <580>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_580.html)=1 with first [TradeDate <75>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_75.html) (and optional [TransactTime <60>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_60.html)) indicating the "since" (greater than or equal to operation) point in time.
- "Between" time periods. [NoDates <580>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_580.html)=2 with first [TradeDate <75>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_75.html) (and optional [TransactTime <60>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_60.html)) indicating the "beginning" (greater than or equal to operation) point in time and the second [TradeDate <75>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_75.html) (and optional [TransactTime <60>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_60.html)) indicating the "ending" (less than or equal to operation) point in time.

 Trade Capture Report messages are the normal return type to a Trade Capture Report Request.

 The response to a Trade Capture Report Request can be:

- One or more Trade Capture Reports
- A Trade Capture Report Request Ack followed by one or more Trade Capture Reports in two specific cases: 
    - When the Trade Capture Reports are being delivered out of band (such as a file transfer),
    - When there is a processing delay between the time of the request and when the reports will be sent (for instance in a distributed trading environment where trades are distributed across multiple trading systems).
- A Trade Capture Report Ack only 
    - When no trades are found that match the selection criteria specified on the Trade Capture Report Request
    - When the Trade Capture Report Request was deemed invalid for business reasons by the counterparty

 Trade Capture Report Request

### Structure

| Tag | Field Name | Req'd | Comments |
| --- | --- | --- | --- |
| [Component Block - <StandardHeader>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/compBlock_StandardHeader.html) | Y | [MsgType <35>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_35.html) = AD |  |
| 568 | [TradeRequestID](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_568.html) | Y | Identifier for the trade request |
| 1003 | [TradeID](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_1003.html) | N |  |
| 1040 | [SecondaryTradeID](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_1040.html) | N |  |
| 1041 | [FirmTradeID](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_1041.html) | N |  |
| 1042 | [SecondaryFirmTradeID](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_1042.html) | N |  |
| 569 | [TradeRequestType](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_569.html) | Y |  |
| 263 | [SubscriptionRequestType](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_263.html) | N | Used to subscribe / unsubscribe for trade capture reports If the field is absent, the value 0 will be the default (snapshot only - no subscription) |
| 571 | [TradeReportID](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_571.html) | N | To request a specific trade report |
| 818 | [SecondaryTradeReportID](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_818.html) | N | To request a specific trade report |
| 527 | [SecondaryExecID](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_527.html) | N | To request all trades based on secondary execution identifier |
| 17 | [ExecID](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_17.html) | N |  |
| 150 | [ExecType](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_150.html) | N | To request all trades of a specific execution type |
| 37 | [OrderID](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_37.html) | N |  |
| 11 | [ClOrdID](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_11.html) | N |  |
| 573 | [MatchStatus](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_573.html) | N |  |
| 828 | [TrdType](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_828.html) | N | To request all trades of a specific trade type |
| 829 | [TrdSubType](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_829.html) | N | To request all trades of a specific trade sub type |
| 1849 | [OffsetInstruction](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_1849.html) | N |  |
| 1123 | [TradeHandlingInstr](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_1123.html) | N |  |
| 830 | [TransferReason](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_830.html) | N | To request all trades for a specific transfer reason |
| 855 | [SecondaryTrdType](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_855.html) | N | To request all trades of a specific trade sub type |
| 820 | [TradeLinkID](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_820.html) | N | To request all trades of a specific trade link id |
| 880 | [TrdMatchID](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_880.html) | N | To request a trade matching a specific TrdMatchID |
| [Component Block - <Parties>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/compBlock_Parties.html) | N | Used to specify the parties for the trades to be returned (clearing firm, execution broker, trader id, etc.) ExecutingBroker ClearingFirm ContraBroker ContraClearingFirm SettlementLocation - depository, CSD, or other settlement party ExecutingTrader InitiatingTrader OrderOriginator |  |
| [Component Block - <Instrument>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/compBlock_Instrument.html) | N | Insert here the set of "Instrument" (symbology) fields defined in "Common Components of Application Messages" |  |
| [Component Block - <InstrumentExtension>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/compBlock_InstrumentExtension.html) | N | Insert here the set of "InstrumentExtension" fields defined in "Common Components of Application Messages" |  |
| [Component Block - <FinancingDetails>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/compBlock_FinancingDetails.html) | N | Insert here the set of "FinancingDetails" fields defined in "Common Components of Application Messages" |  |
| [Component Block - <UndInstrmtGrp>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/compBlock_UndInstrmtGrp.html) | N |  |  |
| [Component Block - <InstrmtLegGrp>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/compBlock_InstrmtLegGrp.html) | N |  |  |
| [Component Block - <TrdCapDtGrp>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/compBlock_TrdCapDtGrp.html) | N | Number of date ranges provided (must be 1 or 2 if specified) |  |
| 715 | [ClearingBusinessDate](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_715.html) | N | To request trades for a specific clearing business date. |
| 336 | [TradingSessionID](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_336.html) | N | To request trades for a specific trading session. |
| 625 | [TradingSessionSubID](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_625.html) | N | To request trades for a specific trading session. |
| 943 | [TimeBracket](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_943.html) | N | To request trades within a specific time bracket. |
| 54 | [Side](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_54.html) | N | To request trades for a specific side of a trade. |
| 442 | [MultiLegReportingType](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_442.html) | N | Used to indicate if trades are to be returned for the individual legs of a multileg instrument or for the overall instrument. |
| 578 | [TradeInputSource](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_578.html) | N | To requests trades that were submitted from a specific trade input source. |
| 579 | [TradeInputDevice](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_579.html) | N | To request trades that were submitted from a specific trade input device. |
| 725 | [ResponseTransportType](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_725.html) | N | Ability to specify whether the response to the request should be delivered inband or via pre-arranged out-of-band transport. |
| 726 | [ResponseDestination](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_726.html) | N | URI destination name. Used if ResponseTransportType is out-of-band. |
| 58 | [Text](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_58.html) | N | Used to match specific values within Text fields |
| 354 | [EncodedTextLen](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_354.html) | N |  |
| 355 | [EncodedText](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_355.html) | N |  |
| 1011 | [MessageEventSource](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/tagNum_1011.html) | N | Used to identify the event or source which gave rise to a message |
| [Component Block - <StandardTrailer>](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/compBlock_StandardTrailer.html) | Y |  |  |

- Follow   
  OnixS
- [Follow us on Twitter ](https://twitter.com/onixsbiz)
- [Connect with us on LinkedIn ](https://www.linkedin.com/company/onix-solutions/)

 We track how people interact with our online web content and resources, and some of that tracking involves storing cookies on your device. By continuing to use our site you accept that you agree to this. For more details see our [Cookie usage, and Data Privacy and Protection Policies](https://www.onixs.biz/cookies-and-privacy.html).

[Ok](https://www.onixs.biz/fix-dictionary/5.0.sp2.ep299/msgtype_ad_6568.html#)

[OnixS ](https://www.onixs.biz/)

Menu

---

---

[OnixS ](https://www.onixs.biz/)

### Search the site

Search