UniSat
  • home
    • UniSat Documentation Home
    • Work Priorities
      • UniSat 2025 Q2 Work priorities
      • Overview of UniSat 2025 Work Priorities
      • Production Roadmap in Q4 2024
  • 🛠️dev
    • UniSat Developer Center- Open API
      • UniSat Developer Center Plans
      • How to Acquire a UniSat API Key
      • Enable the two-factor authentication
      • FAQ
    • Open API documentation
      • UniSat Wallet
        • Connect with UniSat Mobile Wallet
        • Supported Chains
      • API for Bitcoin
        • General
          • Blocks
            • Get Blockchain Info
            • Get Block Transactions
          • Transactions
            • Get Recommended Fees
            • Get Tx Info
            • Get Tx Inputs
            • Get Tx Outputs
            • Get UTXO Info
          • Addresses
            • Get Address Balance
            • Get Address History
            • Get BTC UTXO
            • Get Inscription UTXO
          • Inscriptions
            • Get Inscription Info
            • Get Inscription Content
            • Get Inscription Events
            • Get Address Inscriptions
        • BRC-20
          • Get Best Block Height
          • Get BRC-20 List
          • Get BRC-20 Status
          • Get BRC-20 Ticker Info
          • Get BRC-20 Holders
          • Get BRC-20 Ticker History
          • Get BRC-20 Total History By Height
          • Get BRC-20 Tx History
          • Get Address BRC-20 Summary
          • Get Address BRC-20 Ticker Info
          • Get Address BRC-20 History
          • Get Transferable Inscriptions
        • Runes
          • Get Runes Status
          • Get Runes Info List
          • Get Runes Info
          • Get Runes Holders
          • Get Address Runes Balance List
          • Get Address Runes Balance
          • Get UTXO Runes Balance
          • Get Address Runes UTXO
          • Get Runes Events
        • BRC20-Swap
          • Get Global Config
          • Get Address Balance
          • Get Deposit Info
          • Get Address All Ticker
          • Deploy Pool
          • Add Liq
          • Remove Liq
          • Swap
          • Get All Pool List
          • Get My Pool List
          • Get My Pool
          • Get Overview
          • Get Gas History
          • Get Liq History
          • Get Swap History
          • Get Rollup History
          • Get Deposit List
          • Deposit
          • Withdraw
          • Cancel Withdraw
          • Get Withdraw Process
          • Get Withdraw History
          • Get System Status
        • UniSat Inscribe
          • Get Order Summary
          • Get Order List
          • Create Order
          • Search Order
          • Refund estimate
          • Refund
          • Create BRC-20 DEPLOY
          • Create BRC-20 MINT
          • Create BRC-20 TRANSFER
        • UniSat Marketplace
          • BRC20 Marketplace
          • Runes Marketplace
          • Collection Marketplace
          • Domain Marketplace
        • UniSat Collection
          • Get Collection Status
          • Get Collection List
          • Get Collection Info
          • Get Collection Holders
          • Get Collection List By Address
          • Get Collection Items
          • Get Collection Summary By Address
          • Get Collection Items By Address
          • Get Collection List By Inscription
          • Add Items
          • Remove Items
      • API for Fractal Bitcoin
        • General
          • Blocks
            • Get Blockchain Info
            • Get Block Transactions
          • Transactions
            • Get Tx Info
            • Get Tx Inputs
            • Get Tx Outputs
            • Get UTXO Info
          • Addresses
            • Get Address Balance
            • Get Address History
            • Get BTC UTXO
            • Get Inscription UTXO
          • Inscriptions
            • Get Inscription Info
            • Get Inscription Content
            • Get Inscription Events
            • Get Address Inscriptions
        • BRC-20
          • Get Best Block Height
          • Get BRC-20 List
          • Get BRC-20 Status
          • Get BRC-20 Ticker Info
          • Get BRC-20 Holders
          • Get BRC-20 Ticker History
          • Get BRC-20 Total History By Height
          • Get BRC-20 Tx History
          • Get Address BRC-20 Summary
          • Get Address BRC-20 Ticker Info
          • Get Address BRC-20 History
          • Get Transferable Inscriptions
        • Runes on Fractal
          • Get Runes Status
          • Get Runes Info List
          • Get Runes Info
          • Get Runes Holders
          • Get Address Runes Balance List
          • Get Address Runes Balance
          • Get UTXO Runes Balance
          • Get Address Runes UTXO
          • Get Runes Events
        • UniSat Inscribe on Fractal
          • Get Order Summary
          • Get Order List
          • Create Order
          • Search Order
          • Refund estimate
          • Refund
          • Create BRC-20 DEPLOY
          • Create BRC-20 MINT
          • Create BRC-20 TRANSFER
        • UniSat Marketplace on Fractal
          • BRC20 Marketplace
          • Runes Marketplace
          • Collection Marketplace
          • Domain Marketplace
        • UniSat Collection on Fractal
          • Get Collection Status
          • Get Collection List
          • Get Collection Info
          • Get Collection Holders
          • Get Collection List By Address
          • Get Collection Items
          • Get Collection Summary By Address
          • Get Collection Items By Address
          • Get Collection List By Inscription
          • Add Items
          • Remove Items
        • Get Fractal Circulating Supply
        • Get Fractal Total Supply
        • Get Fractal Total Address Count
        • Get Fractal Rich Address List
        • PizzaSwap
        • CAT Market
        • CAT20-DEX
          • Get Token Price
          • Get Market Stats
        • Fractal Development Support (testnet)
      • API Version Upgrade Notes
        • API Version Upgrade completed: Untrack Useless brc20 Inscriptions
      • API Demos
      • UniSat Game Framework
    • Development for brc-20 protocol
      • brc20-swap Introduction
        • What Is an Automated Market Maker?
        • Liquidity providers (LPs)
        • Testnet guide
        • Technical Q&A
        • Modules, withdrawals, and decentralization of brc-20
      • Single-Step Transfer
    • Developer Service Legal Disclaimer
  • 💡Services (Bitcoin)
    • UniSat Wallet
      • What is Signet?
      • UniSat Wallet FAQ
      • UniSat Wallet Address Type
      • Transfer brc-20 in UniSat Wallet
    • UTXO Management
      • Understanding UTXO
      • How to unlock inscription/runes utxo and send as normal btc in utxo management.
      • FAQ
    • PizzaSwap
      • How to interact with PizzaSwap?
      • Green Channel User Guide
      • Guides for withdrawing your assets from PizzaSwap or brc20-swap
      • LPfest: Step-by-Step Guide
    • Product Chronicles
      • UniSat Wallet - Release Notes
        • v1.6.2
        • v1.6.1
        • v1.6.0
        • v1.5.8
        • v1.5.4
        • v1.5.2
        • v1.5.1
        • v1.4.10
        • v1.4.9
        • v1.4.6
        • v1.4.5
        • v1.4.2
        • v1.4.1
        • v1.4.0
        • v1.3.3
        • v1.3.2
        • v1.3.1
        • v1.3.0
        • v1.2.9
      • Timeline of brc-20 Swap and PizzaSwap Development
  • 💡Services (Fractal Bitcoin)
    • Fractal Service Links
    • FairPool
      • Getting Started with FairPool
    • Runes on Fractal
      • How to Etch Runes?
      • How to Mint Runes?
      • How to Trade Runes?
    • CAT Support
      • How to send / receive CAT20?
      • How to Buy and Sell CAT on UniSat CAT Market?
    • Simple Bridge
      • How to use the Simple Bridge
    • Guides & Tutorials
      • How to Submit Collection in GitHub?
      • Full Node Configuration
  • 📖Knowledge Base
    • Extension Wallet Safety Guide: Protecting Your Assets
      • Best Practices for Safety
    • Bitcoin Basics
      • What is Bitcoin?
      • How does Bitcoin work?
      • Understanding Bitcoin Address Types
      • Glossary
    • .unisat Names
      • Name recognized and resolved
    • Runes
      • How to Etch Runes?
      • How to Mint Runes?
      • How to Trade Runes?
  • Alkanes
    • How to Trade Alkanes on UniSat Marketplace
    • FAQ
  • 🎏Community
    • Reputation System
      • Guides & Explanations
        • UniSat Marketplace Fee Rates
        • FAQ
          • Drops FAQ
      • Points
      • Titles
      • Credits
    • Events
      • brc20-swap Early Access
      • UniSat OG Pass Collection
      • LPfest
      • Babylon Staking Activity
        • How to Transfer $BABY to a Cosmos Wallet
        • How to Participate in BTC Staking on Babylon Using UniSat Wallet
    • Assets potentially associated with UniSat's products
Powered by GitBook
On this page
  • Request Methods
  • Connect wallet:
  • Switch Chain:
  • Signing Message:
  • Signing PSBT:
  • Return datas
  1. dev
  2. Open API documentation
  3. UniSat Wallet

Connect with UniSat Mobile Wallet

If you want to authorize login through our wallet application, you need to use deeplink for interaction. Here are the description of the deeplink’s format and parameters respectively:

Request Methods

Connect wallet:

App developers can use the following URL format to request connection authorization from the wallet:

unisat://request?method=connect&from=yourAppName&nonce=xxxxx

In this case, yourAppScheme needs to be replaced with your deeplink scheme, yourAppName replaced with your application name, and xxxxx replaced with your nonce.

Switch Chain:

App developers can use the following URL format to request a network switch from the wallet:

unisat://request?method=switchChain&data=[chain]&from=yourAppName&nonce=xxxxx

Parameter Description

Chain: BITCOIN_MAINNET, BITCOIN_TESTNET, BITCOIN_TESTNET4, BITCOIN_SIGNET, FRACTAL_BITCOIN_MAINNET, FRACTAL_BITCOIN_TESTNET

And the chain is a based64 emcpded JSON array. For example, data=toBase64(JSON.stringify([FRACTAL_BITCOIN_MAINNET]))

Signing Message:

When requesting the wallet to sign a message, use the following URL format:

unisat://request?method=signMessage&data=[text,type]from=yourAppName&nonce=xxxxx

Here, data is a based64 emcpded JSON array. For example, data=toBase64(JSON.stringify([text,type]))

Signing PSBT:

To request the wallet to sign a PSBT, use the following URL format:

unisat://request?method=signPsbt&data=[psbtHex,options]&from=yourAppName&nonce=xxxxx

Here, data is a based64 emcpded JSON array. For example, data=toBase64(JSON.stringify([psbtHex, options]))

Return datas

After interacting in the wallet application, if the user confirms the relevant operations, a deeplink will be returned in the following format:

unisat://response?data=xxxxx&nonce=xxxxx

Here, xxxxx is the base64 encoded data.

If the user declines the related operations, a deeplink is returned in the following format:

unisat://response?error=xxxxx&nonce=xxxxx

Here, xxxxx is the base64 encoded error information.

Note: the nonce parameter is provided by the application side, facilitating the application in matching each request with its corresponding response result. nonce will be returned in result responses.

PreviousUniSat WalletNextSupported Chains

Last updated 7 months ago

🛠️