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')
}