How to connect and interact with the new Bitcoin wallet in metamask

MetaMask SDK
1

There is not documentation for how to integrate with the new Bitcoin accounts in the Metamask wallet.

I’ve tried to use the wallet api, but the documentation for bitcoin is limited, and the multichain APi doesn’t document how to use it with btc.

Screenshot 2026-01-16 at 12.14.46 PM
Screenshot 2026-01-16 at 12.14.46 PM626×1184 49.4 KB

Resources already consulted.

2

Thanks — I hear you. You’re trying to connect and interact with the new Bitcoin accounts in MetaMask, and the public docs you’ve checked (Multichain API) don’t show how to do BTC programmatically.

Quick classification

  • Type: Integration / feature question (not a runtime error)
  • Action: Documentation gap / possible feature request — I’ll keep follow-up questions minimal unless you want escalation.

Summary for the support team (as requested)

  • SDK Details: Generic Question (user reports trying the Wallet API / Multichain API)
  • SDK Version Number: not provided / unknown
  • Platform: not provided / unknown (screenshot shows MetaMask UI — likely desktop extension or mobile; user to confirm)
  • User-reported issue: No public documentation or examples for programmatic integration with Bitcoin accounts in MetaMask; Wallet API and Multichain API docs are insufficient for BTC flows.
  • Resources user consulted: Multichain API | MetaMask developer documentation (screenshot attached by user showing MetaMask with a BTC account)

Recommended next steps (for the user)

  1. Short-term: Try the MetaMask SDK (recommended path for multi-chain support) — SDK docs: SDK introduction | MetaMask developer documentation
    • Initialize the SDK, get the provider, and inspect the provider object in the browser console to discover available RPC/multichain methods exposed for BTC.
    • Example high-level flow: initialize SDK → get provider → inspect provider methods → request account/permission using the appropriate multichain request (exact BTC method may not yet be documented).
  2. If you need BTC-specific flows (UTXO handling, transaction building, signing, fee estimation): these are often chain-specific and may not use legacy Ethereum JSON-RPC patterns. Check whether the provider exposes Bitcoin-specific methods or a multichain request pattern. If not present, assume this area is still being finalized.
  3. Channels for quicker product/engineering visibility:

Would you like me to escalate this to the product/engineering team?

  • If yes, I can forward the summary above and the screenshot. To help triage quickly (optional): please confirm which SDK (name & version) and which platform (extension on desktop, iOS, Android, or web embed) you’re testing on. If you prefer not to provide that now, I’ll still escalate with what you’ve already shared.

If you want, I can also draft a short GitHub/feature-request text for you to post (including environment, steps tried, and the screenshot). What would you like me to do next?

Note: This response was generated by an AI bot and may require further verification. The MetaMask Community Team has tracked this issue and will be responding as soon as possible.

Additionally, we would recommend you to join our biweekly Office Hours to get this resolved even faster. MetaMask Developer Office Hours

3

Yes, please escalate this to the product team.

4

HI @tomide.LI.FI You may need to use Embedded Wallets Web SDK instead. Please refer to this page: Integrate Embedded Wallets with the Bitcoin Blockchain | MetaMask developer documentation

5

Correct me if I’m wrong but an embedded wallet solution is not quite what I’m looking for, this requires use to create an account with web3Auth. Every new user creates a new wallet that we manage via web3Auth.

I want to be able to connect with the actual bitcoin wallet inside an existing Metamask wallet.
From the source code, I see it uses the bitcoin-snap internally to provide this functionality, but when I try to connect via the snaps, I get an error saying that the bitcoin wallet doesn’t have endowment:rpc permission

I have tried to use the Multichain API, I was able to connect, but I can’t request call signPSBT method.

@holyyy Can you point me to a guide or example that does this?

6

MetaMask SDK is not Embedded Wallets (Web3Auth) SDK. They are different things. There should be no need to have a Web3Auth account for using MetaMask SDK.

As mentioned on this page about the Wallet API, for non-EVM networks, MetaMask just supports Solana and Starknet. So Bitcoin is not supported. You may explore Snaps like this one and see if they can help you.