Ask us anything. We're here to help.

2021-08-26 New field added to the Trades endpoint

API Updates

The Trades endpoint has been updated with a new bank_fee field. The additional field is strictly informational and is not required; however, platforms have been requesting this field to properly link fees charged outside the Zero Hash environment for audit purposes.

Full API specs can be found here.

Sample response:

{
  "message": {
  "trade_id": "9411a2d9-8964-47d0-8971-a52db2f65748",
  "client_trade_id": "fjfd9wekdwoc0sdkcs09w",
  "trade_state": "terminated",
  "market_identifier_code": "SCXM",
  "trade_reporter_code": "00SCXM",
  "symbol": "BTC/USD",
  "trade_quantity": "4",
  "trade_price": "10000",
  "trade_type": "block",
  "physical_delivery": true,
  "comment": null,
  "last_update": 1565832456717,
  "transaction_timestamp": 1565731066447,
  "settlement_timestamp": 1565731965906,
  "accepted_timestamp": 1565731066768,
  "defaulted_timestamp": null,
  "settled_timestamp": 1565794980952,
  "contract_size": 1,
  "bank_fee": 1,                                       <- Fees associated with the transaction outside of Zero Hash. 
  "underlying": "BTC",
  "quoted_currency": "USD",
  "trade_reporter": "user@00SCXM.com",
  "platform_code": "00SCXM",
  "product_type": "spot",
  "parties_anonymous": false,
  "parties": [
  {
    "participant_code": "0M2CKW",
    "side": "buy",
    "asset": "BTC",
    "amount": "4",
    "liquidity_indicator": null,
    "execution_id": "ex_id1",
    "order_id": "foo",
    "desk_code": null,
    "trading_account_code": null,
    "obligations_outstanding_timestamp": null,
    "current_obligations_met_timestamp": null,
    "settlement_state": "settled",
    "client_order_id": null,
    "settling": true
  },
  {
    "participant_code": "1J32WQ",
    "side": "sell",
    "asset": "USD",
    "amount": "40000",
    "liquidity_indicator": null,
    "execution_id": "ex_id2",
    "order_id": "foo",
    "desk_code": null,
    "trading_account_code": null,
    "obligations_outstanding_timestamp": null,
    "current_obligations_met_timestamp": null,
    "settlement_state": "settled",
    "client_order_id": null,
    "settling": true
  }
  ]
  }
}