# Xverse API

## ✨ Welcome to the Xverse API 

Build powerful Bitcoin applications with production-grade APIs used by [Xverse wallet ](https://www.xverse.app/)— now available to developers. 

Our suite of APIs provides everything you need to interact with the modern Bitcoin ecosystem: from Ordinals and Runes, to Bitcoin-native swaps, inscriptions, and Bitcoin L2 integrations. Whether you're building wallets, DeFi platforms, NFT marketplaces, or cross-chain bridges, our infrastructure gives you access to reliable, real-time blockchain data and ready-to-use transaction workflows.

***

## 🚀 Why use the Xverse API?

We built these APIs to solve the real infrastructure problems we faced while building the Xverse wallet. Now we’re opening them up so Bitcoin developers can skip the heavy lifting and focus on building.

**Your Bitcoin RPC, indexer, and data layer — all in one API.**

**With the Xverse API, you get:**

* ⚡ **Ultra-fast Bitcoin RPC** and real-time mempool data — without running your own node
* 🧩 **Advanced indexing** for transaction history, UTXO data, and Bitcoin asset protocols
* 🔲 **Comprehensive Ordinals, Runes & BRC-20 support** — balances, parsing, and transaction data with zero custom indexing
* 💹 **Live & historical market data** for Bitcoin assets: Ordinals, Runes, BRC-20, and Bitcoin L2 tokens
* 💱 **Swap aggregation** across Bitcoin AMMs & L2s (Spark, Stacks, Starknet, BOB, Runes AMMs, BRC-20, etc.)
* 📊 **Portfolio analytics** with real-time activity and daily balance history
* ✍️ **Automated minting, etching & inscription at scale** — simple endpoints that handle high volumes without custom scripts
* 🌉 **Cross-chain swaps & bridging with aggregated liquidity** — one interface to move assets seamlessly across Bitcoin and L2s
* 🤖 ⚡ **Pay-per-request API access via Lightning** — every endpoint accepts payment over the Machine Payments Protocol (MPP) at 1 sat per call. Built for AI agents that don't want to manage API keys.

***

### 🧰 What’s Inside

Our API suite is organized into powerful modules that serve different needs across the Bitcoin ecosystem:

<table><thead><tr><th width="197.4453125">Module</th><th>Description</th></tr></thead><tbody><tr><td><span data-gb-custom-inline data-tag="emoji" data-code="1f7e0">🟠</span> <a href="bitcoin"><strong>Bitcoin</strong></a></td><td>Bitcoin RPC, real-time and comprehensive <strong>Bitcoin mempool &#x26; transaction data</strong>, advanced indexing of <strong>UTXOs &#x26; balances</strong>, optimised for apps and dashboards.</td></tr><tr><td>💹 <a href="portfolio"><strong>Portfolio API</strong></a> <strong>&#x26;</strong> <br><span data-gb-custom-inline data-tag="emoji" data-code="1f440">👀</span> <a href="watch-addresses"><strong>Watch Addresses</strong></a></td><td>Monitor <strong>Bitcoin asset balances</strong> and <strong>activity</strong> across <strong>multiple addresses</strong>, with automatic daily tracking and historical portfolio <strong>insights</strong>.</td></tr><tr><td><span data-gb-custom-inline data-tag="emoji" data-code="1f5bc">🖼️</span> <a href="ordinals"><strong>Ordinals</strong></a></td><td>Fetch detailed information on all <strong>inscriptions</strong>, <strong>UTXOs</strong>, <strong>rare sats</strong> — everything you need to power an <strong>Ordinals experience</strong>.<br><strong>Automate Ordinal inscriptions</strong> with advanced features. Estimate costs, create orders, and track inscription statuses seamlessly.</td></tr><tr><td><strong>🔲</strong> <a href="runes"><strong>Runes</strong></a></td><td>Query <strong>Rune balances</strong> and <strong>detailed information</strong>. <br>Integrate Runes into your apps without building infra.<br><strong>Mint</strong> and <strong>etch Runes</strong>, with cost estimates, order management and execution.</td></tr><tr><td><span data-gb-custom-inline data-tag="emoji" data-code="1fa99">🪙</span> <a href="brc-20"><strong>BRC-20</strong></a></td><td>Query <strong>BRC-20 balances</strong> and <strong>detailed information</strong>. Integrate BRC-20 into your apps without building infra.<br><br><strong>Mint</strong> and <strong>deploy</strong> BRC-20, with cost estimates, order management and execution.</td></tr><tr><td><i class="fa-sparkle">:sparkle:</i> <a href="spark"><strong>Spark</strong></a></td><td><p>Query <a href="https://www.spark.money/"><strong>Spark</strong></a> <strong>balances, transactions &#x26; activity</strong> for <strong>Bitcoin</strong> &#x26; <strong>BTKN</strong> tokens. Access <a href="https://www.flashnet.xyz/"><strong>Flashnet</strong></a> market &#x26; trading data. </p><p>Integrate <strong>Spark</strong> &#x26; <strong>Flashnet</strong> into your apps without building infra. </p></td></tr><tr><td><strong>🔄</strong> <a href="swaps"><strong>Swap Aggregator</strong> </a></td><td>Seamlessly <strong>integrate Bitcoin-asset swaps into your application.</strong> Aggregate <strong>quotes</strong> from multiple <strong>AMMs</strong> across <strong>Bitcoin and L2s</strong>, generate and execute swap orders, and facilitate cross-chain swaps—all through a unified interface.</td></tr></tbody></table>

***

### ⚙️ How It Works

All endpoints are **RESTful** and return **JSON** responses. You can use them with your preferred stack — whether you're writing in JavaScript, Python, Rust, or anything else.

Authentication, rate limits, and response formats will be covered in the [Getting Started](https://docs.xverse.app/api/get-started) section.

Need autonomous, machine-payable access without an API key? See [MPP Lightning Payments](https://docs.xverse.app/api/mpp-lightning-payments).

***

### 🧑‍💻 Built for Builders

This API suite powers real products — including the Xverse wallet and app — and is optimized for scale, speed, and uptime.

✅ **>99% Uptime**\
⚡ **Low-latency responses**\
🔒 **Secure & production-tested**\
📈 **Scalable for any app size**

***

### 💡 Start Building

If you're ready to dive in, check out our [Getting Started](https://docs.xverse.app/api/get-started) guide or browse the [API reference](https://docs.xverse.app/api/broken-reference) to start exploring endpoints.

Looking to integrate specific functionality like swaps, Ordinals support, or Runes minting? Each section is fully documented with example requests, response formats, and real-world use cases.