Skip to main content

Read Asset

GET /safe/assets/:id

Read a single asset by asset_id.

Endpoint URL

 https://api.mixin.one/safe/assets/:id

Authentication and options

Authorization
ASSETS:READ
LimitationNo limitation

Parameters

id
*required
The asset_id of the asset

Example request

curl -i -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" https://api.mixin.one/safe/assets/3596ab64-a575-39ad-964e-43b37f44e8cb
Response
{
"data": {
"type": "asset",
"asset_id": "3596ab64-a575-39ad-964e-43b37f44e8cb",
"chain_id": "43d61dcd-e413-450d-80b8-101d5e903357",
"display_symbol": "BTC",
"display_name": "Bitcoin",
"icon_url": "https://images.mixin.one/...",
"price_btc": "1",
"price_usd": "43210.12",
"change_btc": "0.01",
"change_usd": "-0.02",
"asset_key": "",
"precision": 8,
"dust": "0.00000001",
"confirmations": 3,
"kernel_asset_id": "3596ab64-a575-39ad-964e-43b37f44e8cb",
"withdrawal_memo_possibility": "none",
"level": 1,
"price_updated_at": "2025-01-01T00:00:00Z"
}
}

Response fields

FieldTypeDescription
typestringObject type.
asset_idstringUnique identifier of the asset in Mixin Network.
chain_idstringIdentifier of the chain/network the asset belongs to.
symbolstringAsset symbol.
namestringAsset name.
display_symbolstringSymbol for display.
display_namestringName for display.
icon_urlstringAsset icon URL.
price_btcstringPrice quoted in BTC.
price_usdstringPrice quoted in USD.
change_btcstringChange compared to 24 hours ago (BTC quote).
change_usdstringChange compared to 24 hours ago (USD quote).
asset_keystringAsset identifier on its original chain (e.g. contract address / token identifier).
precisionnumberDecimal precision.
duststringDust threshold.
confirmationsnumberRequired on-chain confirmations.
kernel_asset_idstringKernel asset id.
primitive_asset_idstringPrimitive asset id (may be absent).
collection_hashstringCollection hash (may be absent).
withdrawal_memo_possibilitystringMemo/tag possibility description for withdrawals.
levelnumberAsset level.
price_updated_atstringPrice updated at (RFC3339).