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
/inscription/info/{inscriptionId}
/utxo/{txid}/{vout}
/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:
The
inscriptionsCount
(no changes required)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 stringsaddress
now returns empty string
Test Resources:
Testnet4 has been upgraded and can be tested.
Feel free to let us know if you have any questions or concerns.
Last updated