# 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:**

```json

{
  "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:**

```json
{
  "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:**

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

\
**After Upgrade:**

```json
{
  "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**

```json

{
  "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**

```json

{
  "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
* `address`now returns empty string

***

#### **Test Resources:**

Testnet4 has been upgraded and can be tested.

{% embed url="<https://open-api-testnet4.unisat.io/swagger.html>" %}

Feel free to let us know if you have any questions or concerns.&#x20;