Ask us anything. We're here to help.

New Notation Format for Ethereum Assets

Update: The new symbol notation was launched into the Production environment on Aug 15, 2022.

 

Zero Hash will be updating the symbol format for ETH and ERC-20 assets to follow the ASSET.NETWORK convention. This change is being implemented to provide more transparency as we continue to add support for sidechains and Layer 2 chains.
This has been released to our certification environment.

 

For example, "USDC" will become "USDC.ETH", and "AAVE" will become "AAVE.ETH" etc. Filtering and posting requests using the old asset format will still be supported, but responses will be in the new format. Please note that "ETH" will retain its original notation, as it is the native token of the network.

Below is the full list of ERC20 asset we support and their new asset symbols:

Original Notation New Notation
AAVE AAVE.ETH
AXS

AXS.ETH

BAT BAT.ETH
BUSD BUSD.ETH
LINK LINK.ETH
CVC CVC.ETH
COMP COMP.ETH
DAI DAI.ETH
MANA MANA.ETH
ENJ ENJ.ETH
ZUSD ZUSD.ETH
GYEN GYEN.ETH
GRT GRT.ETH
KNC KNC.ETH
MKR MKR.ETH
OMG OMG.ETH
OXT OXT.ETH
PAXG PAXG.ETH
MATIC MATIC.ETH
SAND SAND.ETH
SHIB SHIB.ETH
STORJ STORJ.ETH
TUSD TUSD.ETH
UNI UNI.ETH
USDC USDC.ETH
USDP USDP.ETH
USDT USDT.ETH
WBTC WBTC.ETH
ZRX ZRX.ETH

 

The responses in the following REST API endpoints will be impacted:

Endpoint

Field name

GET /deposits

asset

GET /deposits/digital_asset_addresses

asset

POST /deposits/digital_asset_addresses

asset

GET /positions

asset

GET /accounts

asset

GET /accounts/net_delivery_obligations

asset

GET /accounts/:account_id

asset

GET /trades

symbol, asset

GET /trades/:trade_id

symbol, asset

GET /liquidity/rfq

underlying

POST /liquidity/execute

underlying

GET /withdrawals/requests

asset

GET /withdrawals/requests/:id

asset

POST /withdrawals/requests

asset

POST /transfers

asset

GET /liquidity/rfq

underlying

POST /liquidity/execute

underlying

POST /rewards

underlying

POST /awards/fund

underlying

GET /index

index, underlying

 

The responses in the following WebSocket subscriptions below will also be impacted:

Feed types

Field name

balance

asset

prices

symbol

NOTE : "useMultiChainAssetFormat": True needs to be added to your balance subscription message to return the new asset formats. The default value is False.

{        
'messageType': 'subscribe', 'topic': 'balances', 'body': {'filter': {}}, 'useMultiChainAssetFormat': True, 'key': API_PUBLIC_KEY, 'passphrase': PASSPHRASE, 'timestamp': t, 'signature': sig.decode('utf-8')
}