API Version Upgrade Notice: Untrack Deprecated 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 deprecated 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 Deprecated BRC20 Inscriptions (Q1 2025)

---

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 deprecated 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 deprecated BRC20 inscription

• utxo object now returns empty strings

• addressnow returns empty string

---

Test Resources:

Testnet4 has been upgraded and can be tested.

Swagger UI

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