The Upvest Blockchain API

A multi-protocol blockchain API for building blockchain-interacting applications.

Get Started     Tutorial     API Reference

Blockchain Assets

Learn about the digital tokens that Upvest supports.

Assets are the underlying tracked digital tokens of blockchain protocols. We support native assets, such as Bitcoin (Bitcoin protocol) and Ether (Ethereum Protocol), as well as the token of sub-standards of these protocols, such as ERC20 tokens. Within the Upvest platform, each asset has a unique identifier (Asset ID), a name (e.g. Ether (mainnet)), a symbol (e.g. ETH), and an exponent (e.g. 18). Implementation-wise the Asset ID set by Upvest is the most crucial part. You’re using it when creating wallets and sending transactions, to point at a specific underlying asset.

It is important to know that assets have different ids across environments, meaning that the Asset ID of Ether, will vary between playground and production.
Please see the table below for sample assets across both environments:

Protocol
Playground (testnet) Asset ID
Production (mainnet) Asset ID

Ethereum (Ether)

deaaa6bf-d944-57fa-8ec4-2dd45d1f5d3f

58a7ed20-fa5c-5774-876d-0f241de39fda

Ethereum (ERC-20) e.g. USDC

7373d2c6-979f-5350-aba5-581efc1bbbb3

348ab66d-c6df-5d0f-b3f2-af04b8d8a425

Bitcoin (BTC)

a3c18f74-935e-5d75-bd3c-ce0fb5464414

34465b1e-b526-5611-9039-e01175d36117

To retrieve a complete list of assets, simply request our /assets/ endpoint. The assets returned in the response varies depending on the environment you’re in.

To search for information about a specific asset, add the search parameter (e.g. /assets/?search=ETH). This takes a search term (such as the asset name or symbol) as a query parameter and responds with the required data.

Asset details returned by the API are structured as follows:

{
      “id”: “deaaa6bf-d944-57fa-8ec4-2dd45d1f5d3f”,
      “name”: “Ether (Ropsten),
      “symbol”: “ETH”,
      “exponent”: 18,
      “protocol”: “ethereum_ropsten”,
      “metadata”: {
        “chain_id”: 3
      }
}

If you can’t find an Asset ID for the ERC-20 token you wish to use, or would like to add your own, please see this knowledge base article.

Updated about a month ago


What's Next

Making a transaction

Transactions and Fees

Blockchain Assets


Learn about the digital tokens that Upvest supports.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.