Get UTXO Assets

This content applies to WaaS 1.0 only. We highly recommend that you upgrade to WaaS 2.0.

This endpoint returns a JSON response containing the asset information within the given UTXO. These assets include BRC-20, BRC-420, and NFTs, among others.

GET https://api.dev.cobo.com/v1/custody/mpc/get_utxo_assets

Python

request(
    "GET",
    "/v1/custody/mpc/get_utxo_assets/",
    {
        "coin": "BTC",
        "tx_hash": "7e1d2c7f4293f4119180a89dcd3d3789927551d8e1408acf50cf769cc47e4e60",
        "vout_n": 0
    },
    api_key, api_secret, host
)

Response

{
  "success": true,
  "result": {
    "chain_coin": "BTC",
    "txid": "7e1d2c7f4293f4119180a89dcd3d3789927551d8e1408acf50cf769cc47e4e60",
    "vout_n": 0,
    "pending": false,
    "assets": {
      "btc": 12000000000,
      "brc_20": {
        "ordi": {
          "value": 8374897239498,
          "decimal": 18,
          "cobo_coin_code": null
        },
        "sats": {
          "value": 9830000000000000000000000000,
          "decimal": 18,
          "cobo_coin_code": null
        }
      },
      "ordinals_inscription": [{
        "inscription_id": "5e871f9ef8d17a990f20ce9e7928d09f5f1e838cef08a719936c9c5d3ae3af93i0",
        "metadata": {
          "Token ID": "227",
          "Name": "AILU 227"
        },
        "parent": "a3fb1b9aa4fd072cdc3616224c46276b064ac84d554dd750c92e53bd920a6969i0",
        "address": "bc1pgk78wytsshwl8t9w2jws9whm57vjgex3ld7cesfkhgwst3c6zjjsasawkx",
        "content_type": "text/plain;charset=utf-8",
        "genesis_height": 834518,
        "genesis_transaction": "5e871f9ef8d17a990f20ce9e7928d09f5f1e838cef08a719936c9c5d3ae3af93",
        "location": "7e1d2c7f4293f4119180a89dcd3d3789927551d8e1408acf50cf769cc47e4e60:0:0",
        "output": "7e1d2c7f4293f4119180a89dcd3d3789927551d8e1408acf50cf769cc47e4e60:0",
        "offset": 0,
        "ethereum_teleburn_address": "0xdDE9Bb04fA6d062f6f812c06b5f12e8cc8a2b684"
      }]
    }
  }
}

Request

coin · String · required

Coin code

tx_hash · String · required

Transaction hash of the UTXO

vout_n · Int · required

Output index of the UTXO

Response

success · bool

request successful or failed

result · object

Show object

chain_coin · String

Chain coin code

txid · String

Transaction hash of the UTXO

vout_n · Int

Output index of the UTXO

pending · Bool

Whether the transaction is pending

assets · object

Show object

btc · Int

The amount of BTC

brc-20 · object

Show object

ordi · object

Show object

value · Int

The value of ordi

decimal · Int

Decimal precision

sats · object

Show object

value · Int

The value of ordi

decimal · Int

Decimal precision

ordinals-inscription · object[]

Show object

inscription_id · String

Inscription ID

metadata · object

Show object

Token ID · String

Token ID of NFT

Name · String

Name of NFT

parent · String

Parent

address · String

Address

content_type · String

Content type

genesis_height · String

Genesis height

genesis_transaction · String

Genesis transaction

location · String

Location

output · String

Output

offset · String

Offset

ethereum_teleburn_address · String

Tthereum teleburn address

Python

request(
    "GET",
    "/v1/custody/mpc/get_utxo_assets/",
    {
        "coin": "BTC",
        "tx_hash": "7e1d2c7f4293f4119180a89dcd3d3789927551d8e1408acf50cf769cc47e4e60",
        "vout_n": 0
    },
    api_key, api_secret, host
)

Response

{
  "success": true,
  "result": {
    "chain_coin": "BTC",
    "txid": "7e1d2c7f4293f4119180a89dcd3d3789927551d8e1408acf50cf769cc47e4e60",
    "vout_n": 0,
    "pending": false,
    "assets": {
      "btc": 12000000000,
      "brc_20": {
        "ordi": {
          "value": 8374897239498,
          "decimal": 18,
          "cobo_coin_code": null
        },
        "sats": {
          "value": 9830000000000000000000000000,
          "decimal": 18,
          "cobo_coin_code": null
        }
      },
      "ordinals_inscription": [{
        "inscription_id": "5e871f9ef8d17a990f20ce9e7928d09f5f1e838cef08a719936c9c5d3ae3af93i0",
        "metadata": {
          "Token ID": "227",
          "Name": "AILU 227"
        },
        "parent": "a3fb1b9aa4fd072cdc3616224c46276b064ac84d554dd750c92e53bd920a6969i0",
        "address": "bc1pgk78wytsshwl8t9w2jws9whm57vjgex3ld7cesfkhgwst3c6zjjsasawkx",
        "content_type": "text/plain;charset=utf-8",
        "genesis_height": 834518,
        "genesis_transaction": "5e871f9ef8d17a990f20ce9e7928d09f5f1e838cef08a719936c9c5d3ae3af93",
        "location": "7e1d2c7f4293f4119180a89dcd3d3789927551d8e1408acf50cf769cc47e4e60:0:0",
        "output": "7e1d2c7f4293f4119180a89dcd3d3789927551d8e1408acf50cf769cc47e4e60:0",
        "offset": 0,
        "ethereum_teleburn_address": "0xdDE9Bb04fA6d062f6f812c06b5f12e8cc8a2b684"
      }]
    }
  }
}