API Documentation

REST API for blockchain analytics • Version v1

Base URL: https://api.mugenlink-network.me/api/v1
HTTPS Required

Getting Started

The MugenLink API provides RESTful access to blockchain data for 6 UTXO cryptocurrencies. All endpoints return JSON and support CORS for browser-based applications.

# Get dashboard overview
curl https://api.mugenlink-network.me/api/v1/dashboard/overview

# Search for a wallet
curl "https://api.mugenlink-network.me/api/v1/network/search?query=YOUR_WALLET_ADDRESS"

# Get network stats for Bitcoin (last 7 days)
curl "https://api.mugenlink-network.me/api/v1/dashboard/network-stats?coin_type=BITCOIN&days=7"
No API Key Required

Public endpoints available without authentication

Fast Response

Redis caching for sub-100ms responses

6 Chains

BTC, BCH, LTC, DOGE, DASH, ZEC

Authentication

Most endpoints are publicly available without authentication. For higher rate limits and premium features, include an API key in your requests.

# With API key header
curl -H "X-API-Key: your_api_key" https://api.mugenlink-network.me/api/v1/dashboard/overview

# Or as query parameter
curl "https://api.mugenlink-network.me/api/v1/dashboard/overview?api_key=your_api_key"

Rate Limits

Rate limits are applied per IP address. Exceeding limits returns a 429 status.

60
requests/minute
Public (no API key)
300
requests/minute
With API key
Unlimited
requests/minute
Enterprise tier

Dashboard

3 endpoints

Overview metrics, network stats, and sample data

GET/dashboard/overview

Get complete dashboard metrics including latest blocks, transaction counts, top wallets, and 7-day trends.

Parameters

refreshbooleanForce refresh from database

Response

{ "blocks": [...], "transactions": {...}, "top_wallets": [...] }
GET/dashboard/sample-addresses

Get sample addresses for each supported cryptocurrency.

Response

{ "bitcoin": "1A1zP1...", "litecoin": "LTC..." }
GET/dashboard/network-stats

Get network statistics for a specific coin.

Parameters

coin_typestring required Cryptocurrency type (BITCOIN, LITECOIN, etc.)
daysintegerNumber of days for historical data (default: 7)

Response

{ "tps": 4.2, "total_txs": 450000, "avg_fee": 0.0001 }

Network

4 endpoints

Block explorer, transactions, and search

GET/network/search

Search for blocks, transactions, or addresses across all chains.

Parameters

querystring required Search query (address, txid, or block hash)
coinstringOptional coin filter

Response

{ "type": "address", "data": {...}, "coin": "bitcoin" }
GET/network/blocks

Get recent blocks across all supported chains.

Parameters

coinstringFilter by cryptocurrency
limitintegerNumber of results (default: 10, max: 100)

Response

{ "blocks": [{ "height": 800000, "hash": "...", "txs": 2500 }] }
GET/network/blocks/{height}

Get detailed information about a specific block.

Parameters

heightinteger required Block height (path parameter)
coinstring required Cryptocurrency type

Response

{ "height": 800000, "hash": "...", "transactions": [...] }
GET/network/transactions

Get recent transactions for a specific chain.

Parameters

coinstring required Cryptocurrency type
limitintegerNumber of results (default: 20, max: 100)

Response

{ "transactions": [{ "txid": "...", "value": 1.5 }] }

Wallet

4 endpoints

Wallet details, balances, and transaction tracing

GET/wallet/{address}

Get wallet details including balance, transaction count, and first/last seen.

Parameters

addressstring required Wallet address (path parameter)
coinstring required Cryptocurrency type

Response

{ "address": "...", "balance": 1.5, "tx_count": 42 }
GET/wallet/{address}/transactions

Get paginated transaction history for a wallet with flow direction.

Parameters

addressstring required Wallet address (path parameter)
coinstring required Cryptocurrency type
pageintegerPage number (default: 1)
limitintegerResults per page (default: 20, max: 100)
directionstringFilter by INCOMING or OUTGOING

Response

{ "transactions": [...], "total": 42, "page": 1 }
GET/wallet/{address}/balance-history

Get historical balance changes for a wallet over time.

Parameters

addressstring required Wallet address (path parameter)
coinstring required Cryptocurrency type
daysintegerNumber of days (default: 30)

Response

{ "history": [{ "date": "2025-01-01", "balance": 1.5 }] }
POST/wallet/trace

Trace wallet transactions with flow analysis and counterparty identification.

Parameters

addressstring required Wallet address to trace
coinstring required Cryptocurrency type
depthintegerTrace depth (default: 2, max: 5)
directionstringINCOMING, OUTGOING, or BOTH

Response

{ "flows": [...], "counterparties": [...] }

Analytics

4 endpoints

Cohort analysis, velocity metrics, and network health

GET/analytics/cohort

Get wallet cohort analysis including new wallet onboarding and retention rates.

Parameters

periodintegerAnalysis period in days (default: 30)
coinstringFilter by cryptocurrency

Response

{ "new_wallets": 1500, "retention_rate": 0.72, "cohorts": [...] }
GET/analytics/velocity

Get UTXO velocity metrics including HODL scores and spending patterns.

Parameters

periodintegerAnalysis period in days (default: 30)
coinstringFilter by cryptocurrency

Response

{ "hodl_score": 0.65, "avg_hold_days": 45, "velocity": [...] }
GET/analytics/network-health

Get network health metrics including TPS, fees, and block times.

Parameters

periodintegerAnalysis period in days (default: 7)

Response

{ "chains": [{ "coin": "bitcoin", "health": 95, "tps": 4.2 }] }
GET/analytics/top-wallets

Get top wallets by balance or transaction volume.

Parameters

coinstring required Cryptocurrency type
sort_bystringSort by "balance" or "tx_count"
limitintegerNumber of results (default: 10)

Response

{ "wallets": [{ "address": "...", "balance": 1000 }] }

Portfolio

3 endpoints

Multi-wallet portfolio tracking and alerts

POST/portfolio/track

Add wallets to portfolio tracking for aggregated analytics.

Parameters

walletsarray required Array of { address, coin, label }

Response

{ "portfolio_id": "...", "wallets": [...] }
GET/portfolio/{id}

Get portfolio summary with total value and allocations.

Parameters

idstring required Portfolio ID (path parameter)

Response

{ "total_value_usd": 50000, "allocations": [...] }
GET/prices

Get current prices for all supported cryptocurrencies.

Response

{ "bitcoin": { "usd": 45000, "change_24h": 2.5 } }

Response Format

All API responses follow a consistent JSON structure:

{
  "success": true,
  "data": { ... },
  "meta": {
    "timestamp": "2026-01-13T12:00:00Z",
    "cached": false,
    "response_time_ms": 45
  }
}

Error Handling

Error responses include a status code and descriptive message:

400Bad Request

Invalid parameters or malformed request

404Not Found

Resource not found (address, transaction, etc.)

429Too Many Requests

Rate limit exceeded - retry after cooldown

500Server Error

Internal server error - contact support if persistent