Unisat-api NPM

UniSat API Client 🚀

🌟 UniSat API Client is an open-source TypeScript/JavaScript client library based on the UniSat API. It provides a simple and easy-to-use interface to interact with various services of UniSat, including blockchain queries, transactions, inscriptions, BRC-20 tokens, and more.

✨ Features

💼 Complete encapsulation of all UniSat API functions
📦 Supports TypeScript with type definitions
🌐 Easy-to-use Promise-based interface
⚙️ Built-in request rate limiting and error handling
🔧 Supports custom configurations (network, base URL, etc.)

📦 Installation

Using npm:

npm install unisat-api

Or using yarn:

yarn add unisat-api

🚀 Quick Start

import UnisatApiClient from 'unisat-api';
const client = new UnisatApiClient({
  apikey: 'YOUR_API_KEY',
  network: 'mainnet'
});

// 🔍 Get blockchain information
client.blocks.getBlockchainInfo().then(info => {
  console.log(info);
});

// 💰 Get address balance
client.address.getAddressBalance('bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh').then(balance => {
  console.log(balance);
});

🛠️ API Overview

The UniSat API client provides the following main modules:

🪙 runes: Runes-related operations
📈 market: Market data queries
🧱 blocks: Blockchain information queries
🔄 brc20swap: BRC-20 token swaps
🏦 address: Address-related operations
🖋️ inscription: Inscription operations
📜 inscriptions: Inscription queries
💸 transaction: Transaction-related operations

Each module contains multiple methods for interacting with the corresponding UniSat API endpoints.

📖 Documentation

For detailed explanations of each module and method, please refer to our API Documentation.

⚙️ Configuration Options

When creating an instance of UnisatApiClient, you can pass the following configuration options:

apikey: Your UniSat API key (required)
network: The network to connect to ('mainnet' or 'testnet', default is 'mainnet')
baseURL: Custom API base URL (optional)

⚠️ Error Handling

All API methods return a Promise. It is recommended to use a try/catch block or the .catch() method to handle any potential errors.

try {
  const balance = await client.address.getAddressBalance('bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh');
  console.log(balance);
} catch (error) {
  console.error('Error fetching balance:', error);
}