API Documentation

Complete API reference for MugenLink Network.

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

Version: 1.0.0

Quick Start

Get started with the MugenLink API in minutes

The MugenLink API is a RESTful API that returns JSON responses. All endpoints are accessible over HTTPS.

bash

# Example: Get dashboard overview
curl -X GET "https://api.mugenlink-network.me/api/v1/dashboard/overview" \
  -H "Content-Type: application/json"

# Example: Get wallet summary
curl -X POST "https://api.mugenlink-network.me/api/v1/wallet/summary" \
  -H "Content-Type: application/json" \
  -d '{"address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa", "coin_type": "BITCOIN"}'

Authentication

Public endpoints do not require authentication. Rate limits apply to all requests:

Public: 100 requests per minute
Authenticated: 1000 requests per minute

For higher rate limits or API key access, please contact us.

Response Format

All API responses follow a consistent JSON structure:

json

{
  "success": true,
  "data": { /* response data */ },
  "cached": false,
  "cache_age": 0,
  "last_updated": "2026-01-30T12:00:00Z"
}

// Error response
{
  "success": false,
  "error": "Error message",
  "error_code": "VALIDATION_ERROR"
}

API Endpoints

Dashboard

Get overview statistics and aggregated data

Get aggregated overview data including latest blocks, transaction counts, and top wallets across all supported coins.

Example Request

bash

curl -X GET "https://api.mugenlink-network.me/api/v1/dashboard/overview"

Example Response

json

{
  "success": true,
  "data": {
    "latest_blocks": [
      {"coin_type": "BITCOIN", "latest_block": 830000, "latest_block_time": "2026-01-30T12:00:00Z"}
    ],
    "transaction_counts": [
      {"coin_type": "BITCOIN", "tx_count": 450000}
    ],
    "top_wallets": [
      {"coin_type": "BITCOIN", "wallet_address": "1A1z...", "total_volume_coin": 1000.5}
    ],
    "last_updated": "2026-01-30T12:00:00Z"
  }
}

Get current prices for all supported cryptocurrencies in USD with 24h change percentage.

Example Request

bash

curl -X GET "https://api.mugenlink-network.me/api/v1/dashboard/prices"

Example Response

json

{
  "success": true,
  "data": {
    "prices": [
      {"coin": "Bitcoin", "symbol": "BTC", "usd": 43250.00, "usd_24h_change": 2.5}
    ],
    "last_updated": "2026-01-30T12:00:00Z"
  }
}

Wallet

Query wallet balances, transactions, and history

Get detailed summary for a specific wallet address including balance, transaction count, and activity dates.

Parameters

address(string)* - The wallet address to query

coin_type(string)* - Cryptocurrency type (BITCOIN, LITECOIN, etc.)

Example Request

bash

curl -X POST "https://api.mugenlink-network.me/api/v1/wallet/summary" \
  -H "Content-Type: application/json" \
  -d '{"address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa", "coin_type": "BITCOIN"}'

Example Response

json

{
  "success": true,
  "data": {
    "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
    "coin_type": "BITCOIN",
    "first_seen": "2009-01-03T18:15:05Z",
    "last_seen": "2026-01-30T10:00:00Z",
    "total_received": 99.99,
    "total_sent": 0,
    "balance": 99.99,
    "transaction_count": 3500,
    "is_active": true
  }
}

Get paginated transaction history for a wallet address.

Parameters

address(string)* - The wallet address to query

coin_type(string)* - Cryptocurrency type

page(number) - Page number (default: 1)

limit(number) - Results per page (default: 20, max: 100)

Example Request

bash

curl -X GET "https://api.mugenlink-network.me/api/v1/wallet/transactions?address=1A1z...&coin_type=BITCOIN&page=1&limit=20"

Analytics

Advanced analytics including velocity, cohorts, and network health

Get velocity metrics showing spending behavior and HODL scores for each cryptocurrency.

Example Request

bash

curl -X GET "https://api.mugenlink-network.me/api/v1/analytics/velocity"

Example Response

json

{
  "success": true,
  "data": {
    "metrics": [
      {
        "coin_type": "BITCOIN",
        "hodl_score": 85,
        "quick_spend_rate": 0.15,
        "classification": "HODLER"
      }
    ]
  }
}

Get network graph data for wallet relationship visualization.

Parameters

address(string) - Center the graph on a specific address

Example Request

bash

curl -X GET "https://api.mugenlink-network.me/api/v1/analytics/network-graph?address=1A1z..."

Alerts

Manage price and activity alert rules

Create a new alert rule.

Parameters

type(string)* - Alert type (price, price_change, balance, whale, activity)

coin_type(string)* - Cryptocurrency type

condition(string)* - Condition (above, below, equals, changes)

threshold(number)* - Threshold value

notification_methods(array)* - Notification channels (email, webhook, browser)

Example Request

bash

curl -X POST "https://api.mugenlink-network.me/api/v1/alerts/rules" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "price",
    "coin_type": "BITCOIN",
    "condition": "above",
    "threshold": 50000,
    "notification_methods": ["email", "browser"]
  }'

Network

Blockchain network statistics and status

Get API health status and service availability.

Example Request

bash

curl -X GET "https://api.mugenlink-network.me/api/v1/health"

Example Response

json

{
  "success": true,
  "data": {
    "status": "healthy",
    "timestamp": "2026-01-30T12:00:00Z",
    "version": "1.0.0"
  }
}

Get detailed system status including all service components.

Example Request

bash

curl -X GET "https://api.mugenlink-network.me/api/v1/status"

Example Response

json

{
  "success": true,
  "data": {
    "api": {"name": "API", "status": "operational", "latency_ms": 15},
    "database": {"name": "Snowflake", "status": "operational", "latency_ms": 45},
    "cache": {"name": "Redis", "status": "operational", "latency_ms": 2},
    "overall_health": "healthy",
    "uptime_percentage": 99.99
  }
}

Error Codes

Code	HTTP Status	Description
`VALIDATION_ERROR`	400	Invalid request parameters
`INVALID_ADDRESS`	400	Invalid wallet address format
`INVALID_COIN_TYPE`	400	Unsupported cryptocurrency type
`NOT_FOUND`	404	Requested resource not found
`RATE_LIMIT_EXCEEDED`	429	Too many requests
`INTERNAL_ERROR`	500	Internal server error
`SERVICE_UNAVAILABLE`	503	Service temporarily unavailable

SDKs & Libraries

JavaScript / TypeScript

Official SDK for Node.js and browsers

npm install @mugenlink/sdk

Python

Python client library with async support

pip install mugenlink-sdk

cURL / REST

Direct REST API access via HTTP

No installation required

Need Help?

Have questions about the API? Our team is here to help.

Contact Support

# Example: Get dashboard overview curl -X GET "https://api.mugenlink-network.me/api/v1/dashboard/overview" \ -H "Content-Type: application/json" # Example: Get wallet summary curl -X POST "https://api.mugenlink-network.me/api/v1/wallet/summary" \ -H "Content-Type: application/json" \ -d '{"address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa", "coin_type": "BITCOIN"}'

{ "success": true, "data": { /* response data */ }, "cached": false, "cache_age": 0, "last_updated": "2026-01-30T12:00:00Z" } // Error response { "success": false, "error": "Error message", "error_code": "VALIDATION_ERROR" }

API Endpoints

Dashboard

Get overview statistics and aggregated data

Get aggregated overview data including latest blocks, transaction counts, and top wallets across all supported coins.

Example Request

bash

curl -X GET "https://api.mugenlink-network.me/api/v1/dashboard/overview"

Example Response

json

{
  "success": true,
  "data": {
    "latest_blocks": [
      {"coin_type": "BITCOIN", "latest_block": 830000, "latest_block_time": "2026-01-30T12:00:00Z"}
    ],
    "transaction_counts": [
      {"coin_type": "BITCOIN", "tx_count": 450000}
    ],
    "top_wallets": [
      {"coin_type": "BITCOIN", "wallet_address": "1A1z...", "total_volume_coin": 1000.5}
    ],
    "last_updated": "2026-01-30T12:00:00Z"
  }
}

Get current prices for all supported cryptocurrencies in USD with 24h change percentage.

Example Request

bash

curl -X GET "https://api.mugenlink-network.me/api/v1/dashboard/prices"

Example Response

json

{
  "success": true,
  "data": {
    "prices": [
      {"coin": "Bitcoin", "symbol": "BTC", "usd": 43250.00, "usd_24h_change": 2.5}
    ],
    "last_updated": "2026-01-30T12:00:00Z"
  }
}

Wallet

Query wallet balances, transactions, and history

Get detailed summary for a specific wallet address including balance, transaction count, and activity dates.

Parameters

address(string)* - The wallet address to query

coin_type(string)* - Cryptocurrency type (BITCOIN, LITECOIN, etc.)

Example Request

bash

curl -X POST "https://api.mugenlink-network.me/api/v1/wallet/summary" \
  -H "Content-Type: application/json" \
  -d '{"address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa", "coin_type": "BITCOIN"}'

Example Response

json

{
  "success": true,
  "data": {
    "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
    "coin_type": "BITCOIN",
    "first_seen": "2009-01-03T18:15:05Z",
    "last_seen": "2026-01-30T10:00:00Z",
    "total_received": 99.99,
    "total_sent": 0,
    "balance": 99.99,
    "transaction_count": 3500,
    "is_active": true
  }
}

Get paginated transaction history for a wallet address.

Parameters

address(string)* - The wallet address to query

coin_type(string)* - Cryptocurrency type

page(number) - Page number (default: 1)

limit(number) - Results per page (default: 20, max: 100)

Example Request

bash

curl -X GET "https://api.mugenlink-network.me/api/v1/wallet/transactions?address=1A1z...&coin_type=BITCOIN&page=1&limit=20"

Analytics

Advanced analytics including velocity, cohorts, and network health

Get velocity metrics showing spending behavior and HODL scores for each cryptocurrency.

Example Request

bash

curl -X GET "https://api.mugenlink-network.me/api/v1/analytics/velocity"

Example Response

json

{
  "success": true,
  "data": {
    "metrics": [
      {
        "coin_type": "BITCOIN",
        "hodl_score": 85,
        "quick_spend_rate": 0.15,
        "classification": "HODLER"
      }
    ]
  }
}

Get network graph data for wallet relationship visualization.

Parameters

address(string) - Center the graph on a specific address

Example Request

bash

curl -X GET "https://api.mugenlink-network.me/api/v1/analytics/network-graph?address=1A1z..."

Alerts

Manage price and activity alert rules

Create a new alert rule.

Parameters

type(string)* - Alert type (price, price_change, balance, whale, activity)

coin_type(string)* - Cryptocurrency type

condition(string)* - Condition (above, below, equals, changes)

threshold(number)* - Threshold value

notification_methods(array)* - Notification channels (email, webhook, browser)

Example Request

bash

curl -X POST "https://api.mugenlink-network.me/api/v1/alerts/rules" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "price",
    "coin_type": "BITCOIN",
    "condition": "above",
    "threshold": 50000,
    "notification_methods": ["email", "browser"]
  }'

Network

Blockchain network statistics and status

Get API health status and service availability.

Example Request

bash

curl -X GET "https://api.mugenlink-network.me/api/v1/health"

Example Response

json

{
  "success": true,
  "data": {
    "status": "healthy",
    "timestamp": "2026-01-30T12:00:00Z",
    "version": "1.0.0"
  }
}

Get detailed system status including all service components.

Example Request

bash

curl -X GET "https://api.mugenlink-network.me/api/v1/status"

Example Response

json

{
  "success": true,
  "data": {
    "api": {"name": "API", "status": "operational", "latency_ms": 15},
    "database": {"name": "Snowflake", "status": "operational", "latency_ms": 45},
    "cache": {"name": "Redis", "status": "operational", "latency_ms": 2},
    "overall_health": "healthy",
    "uptime_percentage": 99.99
  }
}

Error Codes

Code	HTTP Status	Description
`VALIDATION_ERROR`	400	Invalid request parameters
`INVALID_ADDRESS`	400	Invalid wallet address format
`INVALID_COIN_TYPE`	400	Unsupported cryptocurrency type
`NOT_FOUND`	404	Requested resource not found
`RATE_LIMIT_EXCEEDED`	429	Too many requests
`INTERNAL_ERROR`	500	Internal server error
`SERVICE_UNAVAILABLE`	503	Service temporarily unavailable

Quick Start

Authentication

Response Format

API Endpoints

Dashboard

GET/dashboard/overview

GET/dashboard/prices

GET/dashboard/network-stats

Wallet

POST/wallet/summary

GET/wallet/transactions

Analytics

GET/analytics/velocity

GET/analytics/cohorts

GET/analytics/network-health

GET/analytics/data-flow

GET/analytics/network-graph

Alerts

GET/alerts/rules

POST/alerts/rules

PUT/alerts/rules/:id

DELETE/alerts/rules/:id

Network

GET/health

GET/status

Error Codes

SDKs & Libraries

JavaScript / TypeScript

Python

cURL / REST

Need Help?

Loading

Quick Start

Authentication

Response Format

API Endpoints

Dashboard

GET/dashboard/overview

GET/dashboard/prices

GET/dashboard/network-stats

Wallet

POST/wallet/summary

GET/wallet/transactions

Analytics

GET/analytics/velocity

GET/analytics/cohorts

GET/analytics/network-health

GET/analytics/data-flow

GET/analytics/network-graph

Alerts

GET/alerts/rules

POST/alerts/rules

PUT/alerts/rules/:id

DELETE/alerts/rules/:id

Network

GET/health

GET/status

Error Codes

SDKs & Libraries

JavaScript / TypeScript

Python

cURL / REST

Need Help?