Custom Spreads

Release Details

  • Release Date: Dec 5, 2023
  • Release Type: Informational – Optional action from platforms


We have released the Custom Spreads feature to Production. Platforms configured to use this feature of the Convert Withdraw product will be able to, on a per order basis, define the spread amount themselves programmatically. Previously, the spread configuration was only editable manually by a Zero Hash employee upon request.


  • This feature is only offered to Platforms who use Zero Hash Liquidity Services
  • We are adding a new endpoint called POST /convert_withdraw/rfq. It functions the exact same as the GET /convert_withdraw/rfq version. Both of them will continue to be supported indefinitely until stated otherwise. See 1-pager below, section “Flow” to see an example.
  • With this release, we also began exposing 2 new fields on the GET /trades and trades/:trade_id:
    • spread_notional: notional value of the spread applied, expressed in terms of the quoted_currency
    • spread_bps: basis point value of the spread applied
      These fields are not only useful for Platforms who use the Convert Withdraw product, but any Zero Hash Liquidity Services products (excluding the Central Limit Order Book). For revenue reconciliation, Platforms can use these fields to determine the monthly amount of spread collected.

Action Required

If interested in the feature, please reach out to your Zero Hash representative.

Endpoints Impacted

  • POST /convert_withdraw/rfq
  • GET /convert_withdraw/rfq
  • GET /trades
  • GET /trades/:trade_id