getassetpolicy

getassetpolicy "asset_id_or_ticker" Return the policy entry for Arguments: 1. asset_id_or_ticker (string, 2. include_history (boolean, Result: { "asset_id" : "str", "policy_bits" : n, "allowed_spk_families" : n, "icu_txid" : "hex", "icu_vout" : n, "unlock_fees_sats" : n, "fees_accum_sats" : n, "rotation_min_sats" : n, "is_unlocked" : true|false, "issued_total" : n, "burned_total" : n, "ticker" : "str", "decimals" : n, "has_kyc" : true|false, "zk_vk_commitment" "max_root_age" : n, "tfr_flags" : n, "compliance_root_commit" "icu_flags" : n, "icu_visibility" : n, "issuance_cap_units" : n, "icu_ctxt_commit" : "hex", "icu_plain_commit" "kdf_salt" : "hex", "policy_quorum_bps" : n, "policy_epoch" : n, "core_policy_commit" "rotation_history" : [ { "policy_epoch" : n, "block_height" : n, "rotation_txid" "timestamp" : n, "policy_quorum_bps" : n, "issuance_cap_units" : n, "icu_ctxt_commit" "icu_plain_commit" }, ... ] } Result: null (json null) asset entry Examples: > bitcoin-cli getassetpolicy > bitcoin-cli getassetpolicy > bitcoin-cli getassetpolicy ( include_history ) a given asset_id or ticker from the registry (if present) required) Asset ID (32-byte hex) or ticker symbol (3-11 chars) optional, default=false) Include governance rotation history (json object) (string) asset id (numeric) policy bits (numeric) allowed script family mask (string) ICU txid (numeric) ICU vout (numeric) unlock threshold in sats (numeric) accumulated fees in sats (numeric) minimum rotation value in sats (boolean) whether bond has been unlocked (numeric) cumulative minted units (numeric) cumulative burned units (string, optional) asset ticker if set (numeric, optional) decimals if set (boolean) ZK/KYC enforcement enabled : "hex", (string) ZK verifying key commitment (numeric) Maximum KYC root age in blocks (numeric) Transfer flags (e.g., TFR_ANCHOR_REQUIRED) : "hex", (string, optional) Compliance Merkle root commitment (32-byte hex) (numeric) ICU structural flags (e.g., WRAP_REQUIRED) (numeric) ICU visibility (0=public, 1=holder_only) (numeric) Issuance cap (0=unlimited) (string) SHA256 of ICU ciphertext : "hex", (string) SHA256 of canonical plaintext (string) 16-byte encryption salt (numeric) Governance quorum in basis points (0=immutable) (numeric) Wallet advisory version counter : "hex", (string) SHA256 of immutable core policy (json array, optional) Historical governance snapshots (only if include_history=true) (json object) (numeric) Epoch number for this snapshot (numeric) Block height when rotation occurred : "hex", (string) Transaction that rotated to next state (numeric) Block timestamp (Unix epoch) (numeric) Quorum at this epoch (numeric) Issuance cap at this epoch : "hex", (string) ICU ciphertext commitment (for historical text lookup) : "hex" (string) ICU plaintext commitment not found "<asset_id>" "GOLD" "GOLD" true

Signature

getassetpolicy(asset_id_or_ticker: string, include_history?: boolean) → any

Code samples

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

bitcoin-cli getassetpolicy "<asset_id>"

bitcoin-cli getassetpolicy "GOLD"

bitcoin-cli getassetpolicy "GOLD" true

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "getassetpolicy",
        "params": ["\"<asset_id_or_ticker>\"", 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: "getassetpolicy",
    params: ["\"<asset_id_or_ticker>\"",false],
  }),
});
console.log(await res.json());

Parameters

Name	Type	Req.	Description
asset_id_or_ticker	`string`	yes	Asset ID (32-byte hex) or ticker symbol (3-11 chars)
include_history	`boolean`	—	Include governance rotation history

Result

Type: any

{ (json object) "asset_id" : "str", (string) asset id "policy_bits" : n, (numeric) policy bits "allowed_spk_families" : n, (numeric) allowed script family mask "icu_txid" : "hex", (string) ICU txid "icu_vout" : n, (numeric) ICU vout "unlock_fees_sats" : n, (numeric) unlock threshold in sats "fees_accum_sats" : n, (numeric) accumulated fees in sats "rotation_min_sats" : n, (numeric) minimum rotation value in sats "is_unlocked" : true|false, (boolean) whether bond has been unlocked "issued_total" : n, (numeric) cumulative minted units "burned_total" : n, (numeric) cumulative burned units "ticker" : "str", (string, optional) asset ticker if set "decimals" : n, (numeric, optional) decimals if set "has_kyc" : true|false, (boolean) ZK/KYC enforcement enabled "zk_vk_commitment" : "hex", (string) ZK verifying key commitment "max_root_age" : n, (numeric) Maximum KYC root age in blocks "tfr_flags" : n, (numeric) Transfer flags (e.g., TFR_ANCHOR_REQUIRED) "compliance_root_commit" : "hex", (string, optional) Compliance Merkle root commitment (32-byte hex) "icu_flags" : n, (numeric) ICU structural flags (e.g., WRAP_REQUIRED) "icu_visibility" : n, (numeric) ICU visibility (0=public, 1=holder_only) "issuance_cap_units" : n, (numeric) Issuance cap (0=unlimited) "icu_ctxt_commit" : "hex", (string) SHA256 of ICU ciphertext "icu_plain_commit" : "hex", (string) SHA256 of canonical plaintext "kdf_salt" : "hex", (string) 16-byte encryption salt "policy_quorum_bps" : n, (numeric) Governance quorum in basis points (0=immutable) "policy_epoch" : n, (numeric) Wallet advisory version counter "core_policy_commit" : "hex", (string) SHA256 of immutable core policy "rotation_history" : [ (json array, optional) Historical governance snapshots (only if include_history=true) { (json object) "policy_epoch" : n, (numeric) Epoch number for this snapshot "block_height" : n, (numeric) Block height when rotation occurred "rotation_txid" : "hex", (string) Transaction that rotated to next state "timestamp" : n, (numeric) Block timestamp (Unix epoch) "policy_quorum_bps" : n, (numeric) Quorum at this epoch "issuance_cap_units" : n, (numeric) Issuance cap at this epoch "icu_ctxt_commit" : "hex", (string) ICU ciphertext commitment (for historical text lookup) "icu_plain_commit" : "hex" (string) ICU plaintext commitment }, ... ] } null (json null) asset entry not found

Source: services/core-node/bcore/src/rpc/rawtransaction.cpp:888

C++ symbol: getassetpolicy

Code samples

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

bitcoin-cli getassetpolicy "<asset_id>"

bitcoin-cli getassetpolicy "GOLD"

bitcoin-cli getassetpolicy "GOLD" true

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "getassetpolicy",
        "params": ["\"<asset_id_or_ticker>\"", 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: "getassetpolicy",
    params: ["\"<asset_id_or_ticker>\"",false],
  }),
});
console.log(await res.json());