Sign In
View Entire Document

getPendingTrades

Given a Reference ID from an entered Block/ECRP report, returns pending trades. This includes both sent and received pending trades. This response includes a token on each trade which must be used when sending the submitContra command to identify which trade you are accepting/rejecting.

Table 1. getPendingTrades
ParameterRequired Description
CommandYgetPendingTrades
referenceIdYThe referenceId obtained from the original reporter. This is returned to the submitter either on the website GUI (if they submitted via the GUI) or from the submitTrade command.

Example Response

{
    "code": "200",
    "msg": "",
    "data": {
        "sent": [
            {
                "tradeDescription": "VX/J5 - Apr 21, 2055 - Block",
                "side": "BUY",
                "size": 100,
                "price": 10,
                "tradeTime": "Oct 11, 11:20:00",
                "blockTradeComplexType": "SIMPLE",
                "reportingFirm": null,
                "contraTrades": [
                    {
                        "reportingFirm": "BATS Trading, Inc.",
                        "tradeDescription": "VX/J5 - Apr 21, 2055 - Block",
                        "blockTradeComplexType": "SIMPLE",
                        "side": "BUY",
                        "size": 100,
                        "price": 10,
                        "token": "f2d45cc385b321233319de43af26517edbb977f5",
                        "tradeTime": "Oct 11, 11:20:00",
                        "status": "pending",
                        "account": "1111",
                        "ctiCode": 1,
                        "capacity": "F",
                        "operatorId": "1111",
                        "rejectReason": null,
                        "minutesRemaining": 8.0,
                        "responseTime": "",
                        "efid": "BATS",
                        "frequentTraderId": null
                    }
                ],
                "totalAccepted": 0,
                "totalRejected": 0,
                "totalPending": 1,
                "minutesRemaining": 8.0
            }
        ],
        "received": [
            {
                "reportingFirm": "BATS Trading, Inc.",
                "tradeDescription": "VX/J5 - Apr 21, 2055 - Block",
                "blockTradeComplexType": "SIMPLE",
                "side": "SELL",
                "size": 100,
                "price": 10,
                "token": "f2d45cc385b321233319de43af26517edbb977f5",
                "tradeTime": "Oct 11, 11:20:00",
                "status": "pending",
                "account": null,
                "ctiCode": null,
                "capacity": null,
                "operatorId": null,
                "rejectReason": null,
                "minutesRemaining": 8.0,
                "responseTime": "",
                "efid": "BATS",
                "frequentTraderId": null
            }
        ]
    }
}
PreviousNext