V2 is deprecated. Use the Inscribe API V5 migration guide. V5 provides
POST /v5/inscribe/order/create/brc20-5byte-mint; its Request-Commit and signature submission steps are not publicly available.
BRC-20 (5-byte) is a special BRC-20 token protocol with a ticker consisting of 5 characters. Unlike 4-byte, minting 5-byte tokens requires the deployer’s signature authorization, providing stronger control.
Features:
POST /v2/inscribe/order/create
Create a new 5-byte BRC-20 token. The deployment process is the same as 4-byte, but subsequent minting requires deployer authorization.
| Parameter | Type | Required | Description |
|---|---|---|---|
| receiveAddress | string | Yes | Bitcoin address to receive the inscription |
| feeRate | number | Yes | Transaction fee rate (sat/vB) |
| outputValue | integer | Yes | UTXO amount for inscription (recommended 546) |
| brc20_deploy | object | Yes | BRC-20 deployment parameter object |
| devAddress | string | No | Developer address |
| devFee | integer | No | Developer fee |
| Parameter | Type | Required | Description |
|---|---|---|---|
| ticker | string | Yes | BRC-20 token ticker (5 characters) |
| max | string | Yes | Maximum supply |
| limit | string | Yes | Mint limit per transaction |
| decimal | string | No | Decimal places (default “18”, range 0-18) |
| selfMint | boolean | No | Whether only deployer can mint (5-byte tokens default true, deployer only) |
curl -X POST "https://open-api.unisat.io/v2/inscribe/order/create" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"receiveAddress": "bc1p...",
"feeRate": 10,
"outputValue": 546,
"brc20_deploy": {
"ticker": "pizza",
"max": "21000000",
"limit": "1000",
"decimal": "18"
}
}'
{
"p": "brc-20",
"op": "deploy",
"tick": "pizza",
"max": "21000000",
"lim": "1000",
"dec": "18"
}
Same as 4-byte, direct payment:
payAddress and amountamount sats to payAddressminted statuspizza, names)5-byte Mint requires a multi-step PSBT signing process:
POST /v2/inscribe/order/createPOST /v2/inscribe/order/request-commitPOST /v2/inscribe/order/sign-commitPOST /v2/inscribe/order/sign-revealMinting 5-byte BRC-20 tokens requires deployer’s signature authorization. This process involves two transactions:
| Parameter | Type | Required | Description |
|---|---|---|---|
| deployerAddress | string | Yes | Deployer address (must be the address from deploy) |
| deployerPubkey | string | Yes | Deployer public key (compressed format) |
| receiveAddress | string | Yes | Bitcoin address to receive the inscription |
| feeRate | number | Yes | Transaction fee rate (sat/vB) |
| outputValue | integer | Yes | UTXO amount for inscription (recommended 546) |
| brc20_mint | object | Yes | BRC-20 mint parameter object |
| devAddress | string | No | Developer address |
| devFee | integer | No | Developer fee |
| Parameter | Type | Required | Description |
|---|---|---|---|
| ticker | string | Yes | BRC-20 token ticker (5 characters) |
| amount | string | Yes | Mint amount (amt) |
curl -X POST "https://open-api.unisat.io/v2/inscribe/order/create" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"deployerAddress": "bc1p...",
"deployerPubkey": "02a1b2c3d4e5f6...",
"receiveAddress": "bc1p...",
"feeRate": 10,
"outputValue": 546,
"brc20_mint": {
"ticker": "pizza",
"amount": "1000"
}
}'
{
"code": 0,
"msg": "OK",
"data": {
"orderId": "202511-BRC20-ABC123",
"status": "pending",
...
}
}
| Parameter | Type | Required | Description |
|---|---|---|---|
| orderId | string | Yes | Order ID |
| payerAddress | string | Yes | Payer address (for paying fees) |
| payerPubkey | string | Yes | Payer public key (compressed format) |
curl -X POST "https://open-api.unisat.io/v2/inscribe/order/request-commit" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"orderId": "202511-BRC20-ABC123",
"payerAddress": "bc1p...",
"payerPubkey": "02a1b2c3d4e5f6..."
}'
{
"code": 0,
"msg": "OK",
"data": {
"psbtHex": "70736274ff01007d02000000...",
"inputsToSign": [
{
"address": "bc1p...",
"signingIndexes": [0]
}
]
}
}
Important: Must use the deployer’s wallet to sign
// Sign using UniSat wallet
const signedCommitPsbt = await window.unisat.signPsbt(psbtHex, {
autoFinalized: false, // Must be set to false
});
curl -X POST "https://open-api.unisat.io/v2/inscribe/order/sign-commit" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"orderId": "202511-BRC20-ABC123",
"psbt": "70736274ff01007d02000000...signed..."
}'
{
"code": 0,
"msg": "OK",
"data": {
"psbtHex": "70736274ff01007d02000000...", // Reveal PSBT
"inputsToSign": [...]
}
}
// Continue using deployer wallet to sign Reveal transaction
const signedRevealPsbt = await window.unisat.signPsbt(revealPsbtHex, {
autoFinalized: false,
});
curl -X POST "https://open-api.unisat.io/v2/inscribe/order/sign-reveal" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"orderId": "202511-BRC20-ABC123",
"psbt": "70736274ff01007d02000000...signed..."
}'
{
"code": 0,
"msg": "OK",
"data": {
"inscriptionId": "a1b2c3d4...i0"
}
}
At this point, the order status changes to inscribing, waiting for block confirmation to become minted.
// Complete 5-byte Mint process
async function mint5ByteBRC20(ticker, amount, deployerAddress, deployerPubkey) {
try {
// 1. Create order
console.log("Step 1: Creating mint order...");
const createResponse = await fetch(
"https://open-api.unisat.io/v2/inscribe/order/create",
{
method: "POST",
headers: {
Authorization: `Bearer ${API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
deployerAddress,
deployerPubkey,
receiveAddress: deployerAddress,
feeRate: 10,
outputValue: 546,
brc20_mint: {
ticker: ticker,
amount: amount,
},
}),
}
);
const { data: orderData } = await createResponse.json();
const orderId = orderData.orderId;
console.log("Order created:", orderId);
// 2. Request Commit transaction
console.log("Step 2: Requesting commit transaction...");
const commitRequestResponse = await fetch(
"https://open-api.unisat.io/v2/inscribe/order/request-commit",
{
method: "POST",
headers: {
Authorization: `Bearer ${API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
orderId,
payerAddress: deployerAddress,
payerPubkey: deployerPubkey,
}),
}
);
const { data: commitData } = await commitRequestResponse.json();
// 3. Sign Commit transaction
console.log("Step 3: Signing commit transaction...");
const signedCommitPsbt = await window.unisat.signPsbt(commitData.psbtHex, {
autoFinalized: false,
});
// 4. Submit Commit signature
console.log("Step 4: Submitting commit signature...");
const commitSignResponse = await fetch(
"https://open-api.unisat.io/v2/inscribe/order/sign-commit",
{
method: "POST",
headers: {
Authorization: `Bearer ${API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
orderId,
psbt: signedCommitPsbt,
}),
}
);
const { data: revealData } = await commitSignResponse.json();
// 5. Sign Reveal transaction
console.log("Step 5: Signing reveal transaction...");
const signedRevealPsbt = await window.unisat.signPsbt(revealData.psbtHex, {
autoFinalized: false,
});
// 6. Submit Reveal signature
console.log("Step 6: Submitting reveal signature...");
const revealSignResponse = await fetch(
"https://open-api.unisat.io/v2/inscribe/order/sign-reveal",
{
method: "POST",
headers: {
Authorization: `Bearer ${API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
orderId,
psbt: signedRevealPsbt,
}),
}
);
const { data: inscriptionId } = await revealSignResponse.json();
console.log("✅ Mint successful!");
console.log("Inscription ID:", inscriptionId);
console.log("Order is now inscribing, waiting for confirmation...");
return { orderId, inscriptionId };
} catch (error) {
console.error("❌ Mint failed:", error);
throw error;
}
}
// Usage example
async function example() {
// Get deployer information
const deployerAddress = await window.unisat.getAccounts()[0];
const deployerPubkey = await window.unisat.getPublicKey();
// Mint 1000 pizza tokens
await mint5ByteBRC20("pizza", "1000", deployerAddress, deployerPubkey);
}
POST /v2/inscribe/order/create
Create a 5-byte BRC-20 transfer inscription. The transfer process is exactly the same as 4-byte, no authorization signature required.
| Parameter | Type | Required | Description |
|---|---|---|---|
| receiveAddress | string | Yes | Bitcoin address to receive the inscription |
| feeRate | number | Yes | Transaction fee rate (sat/vB) |
| outputValue | integer | Yes | UTXO amount for inscription (recommended 546) |
| brc20_transfer | object | Yes | BRC-20 transfer parameter object |
| devAddress | string | No | Developer address |
| devFee | integer | No | Developer fee |
| Parameter | Type | Required | Description |
|---|---|---|---|
| ticker | string | Yes | BRC-20 token ticker (5 characters) |
| amount | string | Yes | Transfer amount (amt) |
curl -X POST "https://open-api.unisat.io/v2/inscribe/order/create" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"receiveAddress": "bc1p...",
"feeRate": 10,
"outputValue": 546,
"brc20_transfer": {
"ticker": "pizza",
"amount": "500"
}
}'
Standard payment process:
amount to payAddressminted| Operation | 4-byte | 5-byte |
|---|---|---|
| Deploy | Standard payment | Standard payment |
| Mint | Standard payment (anyone) | PSBT signing (deployer only) |
| Transfer | Standard payment | Standard payment |
02 or 03await window.unisat.getPublicKey()autoFinalized: false when signingA: Yes! Minting rights follow the holder of the deploy inscription:
deployerAddress and deployerPubkey to mintTransfer process:
A: Currently not supported. Each mint requires the complete 4-step process.
Return to Inscribe Service Guide