API Version Upgrade completed: Untrack Useless brc20 Inscriptions

Scheduled Deployment: 2025-05-20

Dear API Users,

We hereby notify you about some changes to our Bitcoin chain API services affecting three endpoints related to BRC20 inscription management. Please review the following updates carefully to ensure service continuity.

Affected Endpoints

1. /inscription/info/{inscriptionId}

2. /utxo/{txid}/{vout}

3. /address/{address}/inscription-data

Changes

• Untrack the useless BRC20 inscriptions：BRC20 inscriptions of type TRANSFER (those that have undergone transfers) and MINT inscriptions, which no longer hold value, will no longer be available for query after this update.

---

Detailed Interface Changes

1. /utxo/{txid}/{vout}

Before Upgrade:

{
  "code": 0,
  "msg": "ok",
  "data": {
    "txid": "...",
    "vout": 0,
    "satoshi": 546,
    "scriptType": "5120",
    "scriptPk": "...",
    "codeType": 9,
    "address": "...",
    "height": 815539,
    "idx": 2516,
    "isOpInRBF": false,
    "isSpent": false,
    "inscriptionsCount": 2,
    "inscriptions": [
      {
        "inscriptionNumber": 38012882,
        "inscriptionId": "...",
        "offset": 0,
        "moved": false,
        "sequence": 0,
        "isCursed": false,
        "isVindicate": false,
        "isBRC20Ext": false,
        "isBRC20": true
      },
      {
        "inscriptionNumber": 38012883,
        "inscriptionId": "....",
        "offset": 0,
        "moved": false,
        "sequence": 0,
        "isCursed": false,
        "isVindicate": false,
        "isBRC20Ext": false,
        "isBRC20": false
      }
    ]
  }
}

After Upgrade:

{
  "code": 0,
  "msg": "ok",
  "data": {
    "txid": "...",
    "vout": 0,
    "satoshi": 546,
    "scriptType": "5120",
    "scriptPk": "...",
    "codeType": 9,
    "address": "...",
    "height": 815539,
    "idx": 2516,
    "isOpInRBF": false,
    "isSpent": false,
    "inscriptionsCount": 2,
    "inscriptions": [
    {
        "inscriptionNumber": 38012883,
        "inscriptionId": "....",
        "offset": 0,
        "moved": false,
        "sequence": 0,
        "isCursed": false,
        "isVindicate": false,
        "isBRC20Ext": false,
        "isBRC20": false
      }
     ]
  }
}

Migration Guidance:

1. The inscriptionsCount (no changes required)

2. The inscriptions array will eventually be removed for useless brc20 Inscriptions

---

2. /address/{address}/inscription-data

Before Upgrade:

{
  "code": 0,
  "msg": "ok",
  "data": {
    "cursor": 0,
    "total": 800,
    "totalConfirmed": 800,
    "totalUnconfirmed": 0,
    "totalUnconfirmedSpend": 0,
    "inscription": [
      ...
     ]
   }
 }

After Upgrade:

{
  "code": 0,
  "msg": "ok",
  "data": {
    "cursor": 0,
    "total": 100,
    "totalConfirmed": 100,
    "totalUnconfirmed": 0,
    "totalUnconfirmedSpend": 0,
    "inscription": [
      ...
     ]
   }
 }

Key Changes:

• All useless BRC20 inscriptions will be removed

---

3. /inscription/info/{inscriptionId}

Before

{
  "code": 0,
  "msg": "ok",
  "data": {
    "utxo": {
      "txid": "...",
      "vout": 0,
      "satoshi": 546,
      "scriptType": "5120",
      "scriptPk": "...",
      "codeType": 9,
      "address": "bc1p56s6szy4...v0wqyuzqg5",
      "height": 815539,
      "idx": 2516,
      "isOpInRBF": false,
      "isSpent": false,
      "inscriptionsCount": 1,
      "inscriptions": [
        {
          "inscriptionNumber": 38012882,
          "inscriptionId": "1c5c820f42883b59b....cca0fd6c736i0",
          "offset": 0,
          "moved": false,
          "sequence": 0,
          "isCursed": false,
          "isVindicate": false,
          "isBRC20Ext": false,
          "isBRC20": true
        }
      ]
    },
    "address": "bc1p56s6szy4...v0wqyuzqg5",
    ...
   }
 }

After

{
  "code": 0,
  "msg": "ok",
  "data": {
    "utxo": {
      "txid": "",
      "vout": 0,
      "satoshi": 0,
      "scriptType": "",
      "scriptPk": "",
      "codeType": 0,
      "address": "",
      "height": 0,
      "idx": 0,
      "isOpInRBF": false,
      "isSpent": false,
      "inscriptionsCount": 0,
      "inscriptions": []
    },
    "address": "",
     ...
  }
}

Critical Update:When you query a useless brc20 inscription

• utxo object now returns empty strings

• addressnow returns empty string

---

Test Resources:

Testnet4 has been upgraded and can be tested.

Swagger UIopen-api-testnet4.unisat.io

Feel free to let us know if you have any questions or concerns.