listassets

listassets ( include_unregistered verbose {"has_ticker":bool,"policy_bits":n,"min_balance":n} ) List all known assets in the system. Returns information about all registered assets including their tickers and policies. Arguments: 1. include_unregistered (boolean, optional, default=false) Include assets seen but not yet registered 2. verbose (boolean, optional, default=false) Include detailed asset information 3. filter (json object, optional, default={}) Filter criteria { "has_ticker": bool, (boolean, optional) Only assets with tickers "policy_bits": n, (numeric, optional) Match specific policy bits "min_balance": n, (numeric, optional) Only assets where wallet has at least this balance } Result: [ (json array) Array of asset information { (json object) "asset_id" : "hex", (string) The asset ID "ticker" : "str", (string, optional) Ticker symbol if registered "decimals" : n, (numeric, optional) Number of decimal places "policy_bits" : n, (numeric, optional) Policy bits (verbose mode) "allowed_families" : n, (numeric, optional) Allowed SPK families (verbose mode) "icu_txid" : "hex", (string, optional) Current ICU location txid (verbose mode) "icu_vout" : n, (numeric, optional) Current ICU location vout (verbose mode) "total_supply" : n, (numeric, optional) Total minted supply (if tracked) "is_registered" : true|false (boolean) Whether the asset has been registered }, ... ] Examples: > bitcoin-cli listassets > bitcoin-cli listassets true > bitcoin-cli listassets true '{"has_ticker": true}' > bitcoin-cli listassets false '{"policy_bits": 3, "min_balance": 100000}'

Signature

listassets(include_unregistered?: boolean, verbose?: boolean, filter?: object) → any

Code samples

curl --user "$RPC_USER:$RPC_PASS" \
  --data-binary '{"jsonrpc":"1.0","id":"docs","method":"listassets","params":[false,false,"{}"]}' \
  -H 'content-type: text/plain;' \
  http://127.0.0.1:8332/

bitcoin-cli listassets

bitcoin-cli listassets true

bitcoin-cli listassets true '{"has_ticker": true}'

bitcoin-cli listassets false '{"policy_bits": 3, "min_balance": 100000}'

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "listassets",
        "params": [false, false, "{}"],
    },
    timeout=30,
)
print(r.json())

const res = await fetch("http://127.0.0.1:8332/", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "authorization": "Basic " + btoa(`${process.env.RPC_USER}:${process.env.RPC_PASS}`),
  },
  body: JSON.stringify({
    jsonrpc: "1.0",
    id: "docs",
    method: "listassets",
    params: [false,false,"{}"],
  }),
});
console.log(await res.json());

Parameters

Name	Type	Req.	Description
include_unregistered	`boolean`	—	Include assets seen but not yet registered
verbose	`boolean`	—	Include detailed asset information
filter	`object`	—	Filter criteria { "has_ticker": bool, (boolean, optional) Only assets with tickers "policy_bits": n, (numeric, optional) Match specific policy bits "min_balance": n, (numeric, optional) Only assets where wallet has at least this balance }

Result

Type: any

[ (json array) Array of asset information { (json object) "asset_id" : "hex", (string) The asset ID "ticker" : "str", (string, optional) Ticker symbol if registered "decimals" : n, (numeric, optional) Number of decimal places "policy_bits" : n, (numeric, optional) Policy bits (verbose mode) "allowed_families" : n, (numeric, optional) Allowed SPK families (verbose mode) "icu_txid" : "hex", (string, optional) Current ICU location txid (verbose mode) "icu_vout" : n, (numeric, optional) Current ICU location vout (verbose mode) "total_supply" : n, (numeric, optional) Total minted supply (if tracked) "is_registered" : true|false (boolean) Whether the asset has been registered }, ... ]

Source: services/core-node/bcore/src/wallet/rpc/assets.cpp:4444

C++ symbol: listassets

Code samples

curl --user "$RPC_USER:$RPC_PASS" \
  --data-binary '{"jsonrpc":"1.0","id":"docs","method":"listassets","params":[false,false,"{}"]}' \
  -H 'content-type: text/plain;' \
  http://127.0.0.1:8332/

bitcoin-cli listassets

bitcoin-cli listassets true

bitcoin-cli listassets true '{"has_ticker": true}'

bitcoin-cli listassets false '{"policy_bits": 3, "min_balance": 100000}'

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "listassets",
        "params": [false, false, "{}"],
    },
    timeout=30,
)
print(r.json())

const res = await fetch("http://127.0.0.1:8332/", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "authorization": "Basic " + btoa(`${process.env.RPC_USER}:${process.env.RPC_PASS}`),
  },
  body: JSON.stringify({
    jsonrpc: "1.0",
    id: "docs",
    method: "listassets",
    params: [false,false,"{}"],
  }),
});
console.log(await res.json());