Skip to main content

What is the scale between the asset values displayed on the web and the values returned through the API?

  • Updated

Our API returns asset values in their lowest denomination possible. For example,

  • All Bitcoin (XBT) quantities are returned in Satoshis, the smallest unit of Bitcoin. 1 XBt (Satoshi) = 0.00000001 XBT (Bitcoin).
  • All Tether (USDT) quantities are returned in USDt. 1 USDt = 0.000001 USDT.
  • All Ethereum (ETH) quantities are returned in gwei, the smallest unit of Ethereum. 1 gwei = 0.000000001 ETH.

For other assets, please refer to the /wallet/assets endpoint, where the relationship between the major currency (e.g., XBT, ETH) and its lowest denomination (e.g., Satoshis, gwei) is specified using the Scale parameter.

 

How to convert the values using the Scale parameter

To convert from smaller units to larger ones, divide the smaller unit by 10^scale (i.e., 1 followed by the number of zeros indicated by the scale). And to convert from larger units to smaller ones, multiply the larger unit by 10^scale. 

For example, if the scale is 6 (meaning 1 unit = 1,000,000 smaller units), and the smaller unit is 613,379,693 USDt, divide that by 10^6 (1,000,000) to get the larger one:

613,379,693 USDt/1,000,000 = 613.379693 USDT

 

 

Related articles

This website is operated by HDR Global Trading Limited, a company incorporated under the International Business Companies Act of 1994 of the Republic of Seychelles with a company number of 148707 and registered address at Global Gateway 8, Rue de la Perle, Providence Mahé, Seychelles (“HDR”). HDR wholly owns BitMEX, a Bitcoin-based trading platform.


Access to trading or holding positions on BitMEX is prohibited for any person or entity that is located, incorporated or otherwise established in, or a citizen or a resident of: (i) the United States of America, Québec (Canada), the Hong Kong Special Administrative Region of the People’s Republic of China, the Republic of Seychelles, Bermuda, Cuba, Crimea and Sevastopol, Iran, Syria, North Korea or Sudan; (ii) any state, country or other jurisdiction that is embargoed by the United States of America; or (iii) any other jurisdiction where the services offered by BitMEX are restricted (collectively “Restricted Jurisdictions”). If it is determined that any BitMEX user has given false representations as to their location, incorporation, establishment, citizenship or residence, or HDR detects a user is from a Restricted Jurisdiction as described above, HDR reserves the right to immediately close their accounts and liquidate any open positions. HDR may, in its sole discretion, implement controls to restrict access to the BitMEX trading platform in any of the Restricted Jurisdictions.