Zero Hash New Network Fee Field in Withdrawal Requests Endpoint

Zero Hash has added a new field to the /withdraws/requests endpoint designed to provide users the network fee paid for an on-chain withdrawal.

Withdrawals are considered any movement where the cryptocurrency asset leaves the Zero Hash ecosystem and transferred on network sending assets to a non-custodian wallet.

Example Response

{
  "message":[
              {
                "id":1234567,
                "withdrawal_account_id":1111711,
                "participant_code":"DEF456",
                "account_group":"ABC123",
                "account_label":"general",
                "requestor_participant_code":"DEF456",
                "asset":"USDC",
                "requested_amount":"10",
                "settled_amount":"10.000000",
                "gas_price":null,
                "status":"SETTLED",
                "on_chain_status":"CONFIRMED",
                "client_withdrawal_request_id":null,
                "requested_timestamp":1655909427111,
                "transaction_id":"0xec54fb77b0b6b45f62...",
                "input_data":null,
                "fee_amount":"0.003163149641603118",          <- New Field 
                "quoted_fee_amount":null
              }
            ]
}

Optional Query Parameters

• participant_code (optional): Will default to the participant the API key was created for.
• page (optional): For paginating through your list of addresses.
• status (optional): For selecting requests with specific status (APPROVED, REJECTED, etc.).
• gas_price (optional): For selecting requests with specific gas price.
• client_withdrawal_request_id (optional): For selecting requests with specific client withdrawal request id.
• on_chain_status (optional): For selecting on chain with specific status. You can use CONFIRMED or PENDING.
• requested_timestamp: Filters withdrawal requests based on a given timestamp in milliseconds 1593798130060 or nanoseconds 1593798130060000000 using the following params for the following filter types:
  • [gt] greater than a given timestamp, e.g. requested_timestamp[gt]=1593798130060
  • [gte] greater than or equal to a given timestamp, e.g. requested_timestamp[gte]=1593798130060
  • [e] equal to a given timestamp, e.g. requested_timestamp[e]=1593798130060
  • [lt] less than a given timestamp, e.g. requested_timestamp[lt]=1593798130060
  • [lte] lower than or equal to a given timestamp, e.g. requested_timestamp[lte]=1593798130060
  • Combinations are also possible, e.g. to find a withdrawal requests between 1593798130555 and 1593798130777 you can use the next combination requested_timestamp[gt]=1593798130555&requested_timestamp[lt]=1593798130777

Please visit our API documentation to begin using this feature today!

Zero Hash New On-Chain Transaction Estimate Endpoint

Zero Hash has launched a new endpoint designed to provide an estimate for on-chain transactions. These transactions are deemed a 'withdrawal' by Zero Hash as the asset is leaving our ecosystem and transferred on the network. By integrating with this endpoint, you will be able to offer expanded functionality to your end customers such as displaying an estimated fee for sending assets to a non-custodian wallet.

Example Response

{
  "message": {
        "underlying": "BTC",
        "quoted_currency": "USD",
        "network_fee_asset": "BTC",
        "network_fee_quantity": "0.000172825",
        "total_notional": "3.3733791241663290125"
    }
}

Query Parameters

Required

• underlying
• quoted_currency

Optional

• amount (The amount of the underlying currency),
• destination_address (The receiving address for the withdrawal request),
• contract_call (In a future release, this field will denote if the destination address is a smart contract address. False is the only acceptable value for now.)

Please visit our API documentation to begin using this feature today!

• Platforms can now query our API and be aware that a crypto withdrawal has been confirmed on-chain.
• The field is called on_chain_status and its possible values are
  • PENDING: The withdrawal has been broadcasted on-chain but is not yet confirmed
  • CONFIRMED: The withdrawal has been sufficiently confirmed on-chain according to our confirmation thresholds, which can be viewed here in Confirms column here.
• Full 1-pager on how to interpret the GET /withdrawals/requests and GET /withdrawals/requests/:id response found here.

Zero Hash Ethereum and ERC20 Retail Deposit Address Efficiency Improvements

Zero Hash has launched additional efficiency improvements to the way Ethereum and ERC20 Retail Deposit addresses are created. Ethereum and ERC-20 Retail Deposit Addresses are now created faster and more efficiently from a network fee perspective. The time to create an address has been reduced from as high as 30 seconds during heavy network activity to typically under 1 second. The network fees spent to create addresses have also been lowered by pre-deploying addresses in batches.

Action Required

• If you are currently enrolled in Retail Deposits for Ethereum, then no further action is required.
• If you do not yet have Retail Deposits enabled, please see the below page for more information and contact a member of Zero Hash to enable.

To learn more about how we deploy smart contracts for Retail Deposits, please see this article.

The full list of supported assets, including Ethereum and ERC-20s, can be found here.

Zero Hash recently expanded the number of assets available in Certification/Sandbox (“CERT”) and Production (“PROD”) environments available to clients. This launch brings the number of supported production assets to over 60. An asset is defined as a symbol that can be submitted for activities such as trading, rewards, settlement, round ups, staking.

As part of this launch, we are introducing a “dot notation” system for representing tokens that are supported on different multiple blockchains. Newer assets will follow the format [Token].[L1/L2 Chain]. For tokens currently supported that now have multi-chain support, the existing symbol will continue to work without the blockchain symbol (e.g. “.ETH”) appended. For example, USDC was previously only supported on the Ethereum blockchain. The existing symbol (USDC) will continue to work as-is without the “.ETH” appended. Responses will be in the new format (USDC.ETH). In order to call a non-ETH token such as USDC on Algorand, the symbol USDC.ALGO is now required.

List of Additional Assets

• The Polygon ERC20 token was already separately supported as symbol “MATIC”

• Platforms can now create digital asset addresses for retail end users for all UTXO, Tag, and Ethereum based tokens.
  • Addresses will support receipt of digital asset deposits.

For supported assets see the Deposit column here.

API Updates

Websocket- Prices Feed

• Clients can now subscribe to a Websocket feed in order to receive dynamic price updates for a specified symbol.
• For supported symbols and complete technical guide, see 1-pager here

Today we have released 3 new assets:

See full list of supported assets here.

• Zero Hash will be removing the array of relationship_types from the GET /participants endpoint.
• This change is being implemented because the relationship_types data is behind-the-scene information that Zero Hash has decided does not need to be broadcasted.
• The change shall go into effect on 4/22/2022.

For additional question or concerns please reach out to [email protected]

• Platforms can now create custom accounts by tagging a trade properly. See Creating Custom Accounts for technical details and use cases.