Assets | Bitnob API Reference

Overview

Read-only reference data for every asset and chain Bitnob Enterprise supports. Use these endpoints to populate asset pickers, resolve an asset_id to its chain and decimals, or discover which networks are available before deriving an address. All routes require an API key with read access.

List assetsGET/assets
List chainsGET/assets/chains
Get assetGET/assets/:id

List Assets

Use Case

Returns all supported assets. Filter by chain, network, or type to narrow the list to the assets relevant to your integration.

List Assets

Query Parameters

chainstring

Filter to a single blockchain (e.g. `ethereum`, `bitcoin`, `tron`, `solana`).

networkstring

Filter to a single network within the chain (e.g. `mainnet`, `sepolia`).

typestring

Filter by asset type: `native` for the chain's gas asset, `token` for contract-issued assets.

Asset Fields

objectstring

Always `asset`. Identifies the record type.

idstring (uuid)

Stable identifier for the asset. Pass it as `asset_id` when deriving addresses or creating transactions.

namestring

Human-readable asset name (e.g. `USD Coin`, `Ether`).

symbolstring

Ticker symbol (e.g. `USDC`, `ETH`, `BTC`).

chainstring

Blockchain the asset lives on.

typestring

`native` for the chain's gas asset; `token` for ERC-20s, SPLs, TRC-20s, and similar.

decimalsinteger

Number of decimal places the asset uses. Use it to convert between raw and human-readable amounts.

List Assets Response

List Chains

Use Case

Returns every blockchain network Bitnob Enterprise serves, with the list of networks available on each chain.

List Chains

Chain Fields

objectstring

Always `chain`.

idstring

Chain identifier (e.g. `ethereum`, `bitcoin`, `tron`). Use this value wherever a `chain` is expected.

namestring

Display-friendly chain name (e.g. `Ethereum`, `Tron`).

networksstring[]

Networks available on the chain (e.g. `mainnet`, `sepolia`, `testnet`).

List Chains Response

Get Asset

Use Case

Returns a single asset by ID.

Get Asset

Path Parameters

idstring (uuid)Required

The asset's unique identifier.

Same shape as List Assets

The response is a single asset object — the same field shape as each entry in List Assets. Returns 404 if the asset is not supported.

Get Asset Response