Fetch Assets

POST /safe/assets/fetch

Fetch assets in bulk by asset_id array.

info

This API only returns existing assets, and ignores non-existent asset_ids.

Endpoint URL

POST https://api.mixin.one/safe/assets/fetch

Authentication and options

Authorization	ASSETS:READ
Limitation	No limitation

Payload

[
// array of asset_id
"UUID",
"UUID"
]

Example request

curl -i -X POST -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" https://api.mixin.one/safe/assets/fetch --data '["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

Field	Type	Description
type	string	Object type.
asset_id	string	Unique identifier of the asset in Mixin Network.
chain_id	string	Identifier of the chain/network the asset belongs to.
display_symbol	string	Symbol for display.
display_name	string	Name for display.
icon_url	string	Asset icon URL.
price_btc	string	Price quoted in BTC.
price_usd	string	Price quoted in USD.
change_btc	string	Change compared to 24 hours ago (BTC quote).
change_usd	string	Change compared to 24 hours ago (USD quote).
asset_key	string	Asset identifier on its original chain (e.g. contract address / token identifier).
precision	number	Decimal precision.
dust	string	Dust threshold.
confirmations	number	Required on-chain confirmations.
kernel_asset_id	string	Kernel asset id.
collection_hash	string	Collection hash (may be absent).
withdrawal_memo_possibility	string	Memo/tag possibility description for withdrawals.
level	number	Asset level.
price_updated_at	string	Price updated at (RFC3339).