Xverse Developer Documentation

Build with the world's leading Bitcoin self-custodial platform

Build on Bitcoin with Xverse

Xverse is the Bitcoin super-app trusted by nearly 2 million users — built for payments, trading, earning, and borrowing across Bitcoin, Lightning, Spark, Starknet, and Stacks.

The infrastructure behind it is now open to developers.

Whether you're building a Bitcoin app, a data service, or an AI agent, Xverse gives you the tools to ship on Bitcoin and Bitcoin layers without running your own nodes, indexers, or infrastructure.

What are you building?

Xverse API - The Data Layer for Bitcoin Apps

REST APIs for real-time and historical Bitcoin data — no node, no indexer, no custom infrastructure required.

Bitcoin RPC, mempool, UTXOs, and balances.
Portfolio indexing, analytics, and market data for Bitcoin, Spark, Starknet, Stacks.
Ordinals, Runes, BRC-20, and inscription services.
Swap aggregation across Bitcoin AMMs and Bitcoin L2s.

Get started MCP server

GET /v2/bitcoin/address/{address}/utxo HTTP/1.1
Host: api.secretkeylabs.io
x-api-key: YOUR_API_KEY
Accept: */*

Sats Connect - The Wallet SDK for Bitcoin Apps

Build apps that connect to users' Bitcoin wallets. Send transactions, request signatures, and interact with the full Bitcoin asset stack — BTC, Ordinals, Runes, BRC-20, Spark, Stacks, and Starknet.

Bitcoin PSBTs, transfers, and message signing.
Ordinals, Runes, and BRC-20 operations.
Spark, Stacks, and Starknet support.
~2 million downloads. Used by leading BitcoinFi apps.

Get started AI Agent integration

index.js

import {
  request,
  BitcoinNetworkType,
  RpcErrorCode,
} from "sats-connect";
    
try {
  const response = await request('signPsbt', {
    psbt: psbtBase64,
    signInputs: {
      "1ef9...Jn1r": [0],
      "bc1p...ra4w": [1,2],
    },
  });

Xverse Agent Wallet - The Agent Economy on Bitcoin Rails

Give your AI agent a Bitcoin-native wallet that can pay, receive, and trade programmatically across Lightning, Spark, and Starknet. No custodian, no permissions to ask for, and no infrastructure to run.

⚡ Pay and get paid on Lightning request invoices, settle instantly, sub-cent fees. The natural primitive for any agent that needs to charge for or consume a service on Bitcoin rails.
🔲 Trade Runes & Ordinals directly from the agent, no intermediary.
🌐 Trade on Starknet — Bitcoin assets, stables, RWAs with high throughput & low fees.
⚡ Trade on Flashnet via Spark — the cheapest way to move Bitcoin assets.

Get started Agent Mode

johndoe@john-mbp ~ %

xverse [my-agent.com] mainnet:0> --agent my-agent.com bitcoin balance

BTC Balance:

+------------------+-----------+-------------+
| Address Type     | Confirmed | Unconfirmed |
+------------------+-----------+-------------+
| Native Segwit    | 0.1823    | 0.0000      |
| Taproot          | 0.0412    | 0.0050      |
+------------------+-----------+-------------+
| Total            | 0.2235    | 0.0050      |
+------------------+-----------+-------------+