Release Details

Release Date: May 12th, 2025

Release Type

Informational – optional action from platforms

Summary

Trade status and balance updates are now available via webhooks. This enhancement provides more granular and timely information on trade settlement, the flow of crypto assets, and authoritative changes to account balances held at Zero Hash. To enable this feature, please reach out to your Zero Hash rep and they will configure your Platform accordingly.

New webhook notifications:

1. trade.status_changed
2. account_balance.changed

For more information about configuration and handling webhook payloads, visit the Webhooks Overview page.

Trade Status Changed

Trade status notifications provide information about the current trade status. Net Settlement Trades (a.k.a allocation trades) are filtered out and thus don’t generate a notification for the platforms. There are 3 types of status change notifications:

• accepted - the trade was successfully submitted, accepted, and pending settlement
• active - within the settlement window, settlement was attempted but is not yet complete
• terminated - trade was successfully settled; no further status updates will be issued

Note: The x-zh-hook-payload-type must be set to trade_status_changed

While the schema closely follows the existing GET /trades/{trade_id} endpoint, it does NOT contain EVERY field exposed by the endpoint, such as:

• "accepted_timestamp"
• "defaulted_timestamp"
• "settled_timestamp"
• "last_update"
• "settlement_timestamp"
• "expiry_timestamp"
• "spread_notional"
• "spread_bps"
• "session_id"
• “payment_processor”
• “fees”
• “batch_trade_id“

Any additional or supplementary information should still be fetched from GET /trades/{trade_id} endpoint.

Balance Changed

Account balance change notification provides information about the current available account balance. A notification is emitted when the account balance changes for the following account types:

• available
• collateral

Note: The x-zh-hook-payload-type must be set to account_balance.changed.

The schema of the event payload will follow the existing private websocket balance updates feed

Relevant Documentation

• Webhooks Overview Page
• Trade Status Webhook Reference
• Account Balance Webhook Reference

Release Details

• Release Date: April 30th, 2025

Release Type

Informational – Optional action from platforms

Summary

Zero Hash is pleased to announce support for the Worldchain network. Worldcoin on Worldchain (WLD.WORLDCHAIN) and Ethereum on Worldchain (ETH.WORLDCHAIN) has been added to buy, sell, deposit, withdraw and account funding in both our Cert and Prod environments.

These assets are not currently transact-able by New York residents. A future release note will be created once New York support is enabled.

Action Required

These assets are immediately available using the symbols (WLD.WORLDCHAIN) and (ETH.WORLDCHAIN)

Endpoints Impacted

There are no changes to existing endpoints as a result of this launch.

Relevant Documentation

For a full list of supported assets and instruments, please use the links below.

• Supported Assets
  • Production
  • Certification
• Supported Instruments
  • Production
  • Certification

Release Details

Release Date: April 16th, 2025

Release Type

Informational – optional action from platforms

Summary

The Account Funding product now supports sub-accounting. It's common for platforms to offer their customers the ability to create multiple accounts. For instance, a brokerage may allow customers to open separate trading accounts for tax optimization, risk management, differentiated trading strategies, or to simply organize investments by distinct goals.

As a result, it's essential that Zero Hash provides the flexibility to segregate transactions based on the specific account in use - enter Customer sub-accounts.

There is a new optional query param called the account_label which has been added to the following Account Funding SDK's

• Fund SDK
• Withdraw SDK

Read the end-to-end integration guide to see this new feature in action. At a high-level, here are the impacts:

Funding

• The Platform will acquire an access token the same way they do today, just additionally specifying an account_label on the call
• Zero Hash will save this and attach it to an address once the user selects the Asset and Network
• Once the Customer deposits, Zero Hash will:
  • Recognize the deposit, where the account will have the specified account_label
  • Auto-convert the asset to USD
  • Auto-transfer the USD to the Platform (if configured for this)
  • Send a Fund webhook with the specified account_label in the payload
• The Platform will also be able to retroactively query GET /fund/transactions and see the proper account_label associated with the transaction

Withdrawal

• The Platform will acquire an access token for the Account Link SDK identically to how they do today. No change here
• The Platform will acquire an access token for the Withdraw SDK the same way they do today, just additionally specifying an account_label on the call
• The Customer will initiate a withdrawal on the SDK, triggering the following
  • Auto-convert from the Float account to the asset (no change)
  • Auto-disburse the asset to the destination address, debiting the Customer's account with the specified account_label
  • Send a Payments webhook with the specified account_label in the payload

Products Impacted

Account Funding - this impacts both the SDK and API

Relevant Documentation

• Onboarding API + Fund API Integration Guide
• Onboarding API + Fund SDK Integration Guide
• Onboarding SDK + Fund SDK Integration Guide
• Account Link + Withdrawal SDK Integration Guide

Release Details

Release Date: April 3rd, 2025

Release Type

Informational – optional action from platforms

Summary

The Account Funding product has added additional asset support for both the API and the SDK:

Prior to this release, Account Funding supported the following:

This brings the total asset support to 37 across 19 different networks

Configuration

Platforms can choose which assets they'd like configured. The process for making this configuration is to reach out to your Zero Hash contact, who can then make a quick adjustment on our end.

How it works - Deposit

Select Asset

Select Network

Transaction Pending

The user is presented with the address, a calculator and a rate:

• Address: The address that the user should send the asset to
• Calculator: A helpful tool for users to get an approximate fiat conversion amount for their desired deposit quantity
• Rate: A non-executable current price of the asset. Deposits will be converted at the price at the time of deposit

Calculator

Asset Deposited and Converted

Once the user's deposit has confirmed on-chain, Zero Hash will automatically and immediately liquidate the deposited asset into fiat currency (ie, USD) at the current prevailing rate.

How it works - Withdrawal

The above described assets are also now available to be withdrawn using the Account Link + Withdraw SDK

Account Link SDK

Withdraw SDK

Action Required

If you're interested in configuring your SDK for these additional assets, please reach out to your Zero Hash contact. It is a quick process for us to make this configuration.

Products Impacted

Account Funding - this impacts both the SDK and API

Relevant Documentation

• Onboarding API + Fund API Integration Guide
• Onboarding API + Fund SDK Integration Guide
• Onboarding SDK + Fund SDK Integration Guide
• Account Link + Withdrawal SDK Integration Guide

Release Details

Release Date: March 27th, 2025

Release Type

Informational – optional action from platforms

Summary

Background

Platforms can accompany their Zero Hash integration with a PSP integration. This is to allow customers to purchase crypto or stablecoins using a card or a popular digital wallet (ie, Apple Pay) - the company responsible for this part of the flow is the PSP.

The PSP is responsible for the processing of the fiat leg of the transaction, Zero Hash is responsible for the crypto or stablecoin side (unless of course you are using any of Zero Hash's fiat product offerings directly).

New Requirements

To fulfill regulator audits, Zero Hash must be able to associate a Zero Hash transaction to an associated PSP transaction. We will do this by leveraging the new Zero Hash object payment_processor. This has been added to the following endpoints:

• POST /liquidity/rfq
• POST /convert_withdraw/rfq

and it contains two sub-fields:

Example requests:

-- POST /liquidity/rfq
  
  {
  "participant_code":"CUST01",
  "side": "buy",
  "underlying": "USDC", 
  "quoted_currency": "USD",
  "total": "500", 
  "payment_processor": {         
      "name": "checkout.com", -- the name of the PSP clearing the fiat leg of the trade
      "id": "5cd07738b861c31e3bd61467BTC1Buy1568311644602" --this will be used by Zero Hash to reconcile with the PSP
    }
}

-- POST /convert_withdraw/rfq
  
  {
  "participant_code":"CUST01",
  "side": "buy",
  "underlying": "USDC",
  "quoted_currency": "USD", 
  "total": "500", 
  "withdrawal_address": "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
  "payment_processor": {         
      "name": "checkout.com", -- the name of the PSP clearing the fiat leg of the trade
      "id": "5cd07738b861c31e3bd61467BTC1Buy1568311644602" -- the  unique ID that must be tied back to the PSPs transaction - this will be used by Zero Hash to reconcile with the PSP
    }
}

Settlement Flow

There are 2 different types of settlement sessions:

• Net buy session: There is more buy volume than sell (therefore Zero Hash receive a settlement)
• Net sell session: There is more sell volume than buy (therefore Zero Hash will disperse a settlement)

Net Buy

• Zero Hash will receive a settlement directly from the PSP
• The funds will be credited to the Platform's float account

Net Sell

• Platform can request a USD withdrawal on the client portal or via API to their respective bank

Action Required

n.a

Products Impacted

• Remittance
• On and Off Ramp

Relevant Documentation

• Remittance integration guide

Release Details

• Release Date: March 27, 2025

Release Type

Informational – Optional action from platforms

Summary

Zero Hash is pleased to announce enabling support for Sky Dollar on Ethereum (USDS.ETH) and Solana (USDS.SOL). USDS is the upgraded version of DAI and is the stablecoin of the decentralised Sky Protocol.

These assets are available only in the PROD environment for deposit and withdraw functionality.

That these assets are not available in New York.

Action Required

These assets are immediately available using the above symbols.

Endpoints Impacted

There are no changes to existing endpoints as a result of this launch.

Relevant Documentation

For a full list of supported assets and instruments, please use the links below.

• Supported Assets
  • Production
  • Certification
• Supported Instruments
  • Production
  • Certification

We are pleased to announce that three additional assets are now available for activity in New York. Previously these assets were restricted even for platforms that had been approved for NY activity.

Environment Updates

The following assets/symbols are enabled for all permitted NY activity:

• MultiversX (EGLD): CERT and PROD
• The Graph (GRT.ETH): PROD-only
• Kyber Network (KNC.ETH): PROD-only

Note: These changes only apply to the assets listed and do not apply to any tokens or stablecoins on these networks. Please direct any questions to your Zero Hash support team.

Platform Communications to New York Persons:

Any platform that wishes to communicate this launch as a Platform to New York persons, you must follow the below template:

We are pleased to announce the addition of MultiversX, The Graph, and Kyber Network to our platform.

Customers in the State of New York can now perform deposits, withdrawals, buys, and sells.

[Platform Name] and customers are still restricted from certain activities outlined on this page.

Cryptocurrency transaction and custody services are powered by Zero Hash LLC and Zero Hash Liquidity Services LLC. Zero Hash LLC and Zero Hash Liquidity Services LLC are licensed to engage in Virtual Currency Business Activity by the New York State Department of Financial Services.

Further Reading

To see the full list of supported Assets, please refer to our new documentation pages:

• Supported Assets and Instruments
• Restricted Endpoints for New York Participants

Release Details

• Release Date: March 14, 2025

Release Type

Informational – Optional action from platforms

Summary

Zero Hash is pleased to announce enabling support for USDC on Aptos. This asset uses the symbol USDC.APT and is available to buy, sell, deposit, and withdraw on CERT and PROD.

Note that this asset is not available in New York.

Action Required

This asset is immediately available using the above symbol.

Endpoints Impacted

There are no changes to existing endpoints as a result of this launch.

Relevant Documentation

For a full list of supported assets and instruments, please use the links below.

• Supported Assets
  • Production
  • Certification
• Supported Instruments
  • Production
  • Certification

Release Details

Release Date: February 28th, 2025

Release Type

Informational – optional action from platforms

Summary

As part of the Account Funding product, Zero Hash has added a new field (reference_id) to the access token retrieval step of the the Account Link/Withdraw SDK. This new field is also represented in step 6 on the integration guide.

This field can be used to give Platforms extreme confidence that a withdraw was indeed initiated by their Customer, allowing them to "lock" the funds in their systems. Rather than solely relying on the payments webhooks to make this determination, Platforms can now query a REST endpoint (GET /payments) or GET /payments/{payment_id} in-tandem.

Example:

• Platform requests access token:

 {
    "participant_code": "CUST01",
    "permissions": ["crypto-withdrawals"],
    "withdrawal_details": {
        "external_account_id": "c476a81f-a29f-4e22-88db-1f521d7cf004",
        "quoted_asset": "USD",   
        "withdrawal_request_amount": "200"
    },
   "reference_id": "0bd7f7f0-cf26-495f-b2df-e8afe8481ba3"
}

• Customer (CUST01) goes through the SDK flow, successfully initiating a withdrawal of 500 USDC
• Payments webhook retrieval fails due to a network blip
• Platform queries GET /payments and see a payment has been initiated with reference_id = 0bd7f7f0-cf26-495f-b2df-e8afe8481ba3
• Platform will debit the Customer's USD balance within their system, accurately reflecting the current balance

Action Required

n.a

Products Impacted

• Account Funding

Relevant Documentation

• Account Link + Withdrawal SDK Integration Guide

We are pleased to announce that five additional assets are now available for activity in New York. Previously these assets were restricted even for platforms that had been approved for NY activity.

Environment Updates

The following assets/symbols are enabled for all permitted NY activity:

• Ethereum on ZkSync (ETH.ZKSYNC): CERT and PROD
• ZK Token (ZK.ZSYNC): PROD-only
• Ethereum on Base (ETH.BASE): CERT and PROD
• SEI (SEI): CERT and PROD
• Algorand (ALGO): CERT and PROD

Note: These changes only apply to the assets listed and do not apply to any tokens or stablecoins on these networks. Please direct any questions to your Zero Hash support team.

Platform Communications to New York Persons:

Any platform that wishes to communicate this launch as a Platform to New York persons, you must follow the below template:

We are pleased to announce the addition of Algorand, SEI, Ethereum on ZkSync, Ethereum on Base, and ZK Token to our platform.

Customers in the State of New York can now perform deposits, withdrawals, buys, and sells.

[Platform Name] and customers are still restricted from certain activities outlined on this page.

Cryptocurrency transaction and custody services are powered by Zero Hash LLC and Zero Hash Liquidity Services LLC. Zero Hash LLC and Zero Hash Liquidity Services LLC are licensed to engage in Virtual Currency Business Activity by the New York State Department of Financial Services.

Further Reading

To see the full list of supported Assets, please refer to our new documentation pages:

• Supported Assets and Instruments
• Restricted Endpoints for New York Participants