⚙️API

🔌 Menelik Blockchain API

Welcome to the Menelik Blockchain API! This API provides real-time blockchain data, including transactions, blocks, addresses, supply metrics, smartnode stats, and more.

🌐 Live API: explorer.menelik.fun:3300/api 🔍 Blockchain Explorer: Menelik Explorer 📖 Whitepaper: Menelik Whitepaper 🛣️ Roadmap: Menelik Roadmap

---

🚀 Available Endpoints

All API responses are returned in JSON format.

📌 1. Transactions for an Address

GET /transactions/:address Retrieves transactions associated with a given address (paginated, 100 records per page).

Example:

GET https://explorer.menelik.fun:3300/api/transactions/MJyFbKtyMeA9wkFf1UT5qDz2M2fsmb2TUa?page=1

{
  "page": 2,
  "results": [
    {
      "tx_hash": "abc123...",
      "amount": "10.00000000",
      "direction": "RECEIVED",
      "balance": "100.00000000",
      "timestamp": "Sep 20, 2025 09:15:22 AM UTC"
    },
    ...
  ]
}

📌 2. Top Addresses

GET /top-addresses Returns the top 200 addresses ordered by balance and total received.

Example:

GET https://explorer.menelik.fun:3300/api/top-addresses

{
  "topBalances": [
    {
      "address": "MKP75PpU1gMc2smtFe4c7b323s14TDBYU9",
      "balance": "736105698.37333593",
      "total_received": "1441886163.54557679",
      "total_sent": "705780465.17224086",
      "last_updated": "2025-01-19T14:44:01.000Z"
    }
  ]
}

📌 3. Address Details

GET /address/:address Returns basic information about an address.

Example:

GET https://explorer.menelik.fun:3300/api/address/MJyFbKtyMeA9wkFf1UT5qDz2M2fsmb2TUa

[
  {
    "address": "MPFBvaxVjC6UK4WA1ijTU1SYQ45R5rhg6B",
    "total_received": "270782003.06629523",
    "total_sent": "266716003.06089433",
    "balance": "4066000.00540090",
    "last_updated": "2025-01-19T13:08:44.000Z"
  }
]

📌 4. Blockchain Statistics

GET /table-records Returns counts of addresses, blocks, transactions, and recent blockchain statistics.

Example:

GET https://explorer.menelik.fun:3300/api/table-records

{
  "addresses": 100000,
  "blocks": 120000,
  "transactions": 215000,
  "difficulty": [
    { "height": 451000, "difficulty": 123456.789, "hashrate": 1.234e+10 }
  ]
}

📌 5. Last Blocks

GET /last-blocks Retrieves latest 440 blocks from the blockchain.

Example:

GET https://explorer.menelik.fun:3300/api/last-blocks

[
  {
    "height": 161822,
    "block_hash": "bea31068f95007db38186266309ea1b8a727287563d61eaa83326c324cabf64e",
    "nTx": 1,
    "confirmations": 2,
    "difficulty": 0.000815245624357108,
    "size": 334,
    "time": "2025-02-08T23:08:47.000Z"
  },
  {
    "height": 161823,
    "block_hash": "6c45e6506b84922dcf29c6b33e40618200a9f6f7bc26898fc0863e55840da3c0",
    "nTx": 2,
    "confirmations": 4,
    "difficulty": 0.000820526599410237,
    "size": 526,
    "time": "2025-02-08T23:09:13.000Z"
   }
  ]

📌 6. Total Emitted Coins

GET /total-emitted Returns the total emitted supply.

Example:

GET https://explorer.menelik.fun:3300/api/total-emitted

{
  "totalEmitted": 1702702880
}

📌 7. Transaction Details

GET /txid/:txid Returns full details of a transaction.

Example:

GET https://explorer.menelik.fun:3300/api/txid/e84130928d08c4d74cf44acabd473b1ac085c8683d0040adbf1591686f18fffd

{
  "txid": "e84130928d08c4d74cf44acabd473b1ac085c8683d0040adbf1591686f18fffd",
  "decrypt": 1,
  "transaction": {
    "txid": "e84130928d08c4d74cf44acabd473b1ac085c8683d0040adbf1591686f18fffd",
    "version": 2,
    "type": 0,
    "size": 59378,
    "locktime": 160397,
    "block_hash": "547325ac13880c5b488cb1b0182e68d640ec57767e6111345f74117c4a6ac1c1",
    "block_height": 160464,
    "block_time": "2025-02-07T00:45:43.000Z",
    "vin": [
      {
        "previous_txid": "00a8d6bd7ad7e86290f3c92fd9f24ee1c040ae4e913f8cf5113d20bdff34694c",
        "vout": 1,
        "sequence": 4294967294
      },
      {
        "previous_txid": "014541729c8339c09a061465aa551901f8ea4134e8a1e1ed0d80fa3ed1b94d20",
        "vout": 1,
        "sequence": 4294967294
      }
          ],
    "vout": [
      {
        "value": "0.12392435",
        "valueSat": 12392435,
        "n": 0,
        "scriptPubKey": {
          "asm": "76a914a1d121d764789bd2ab2a1736feb677d4ce65033988ac",
          "hex": "76a914a1d121d764789bd2ab2a1736feb677d4ce65033988ac",
          "addresses": [
            "MNemZ5GVfULRqyPoL3eJiq5y3gDtRj3JBR"
          ]
        }
      },
      {
        "value": "300000.00000000",
        "valueSat": 30000000000000,
        "n": 1,
        "scriptPubKey": {
          "asm": "76a914a24c59fd709dd182c0aef5a6d785870c0fd092eb88ac",
          "hex": "76a914a24c59fd709dd182c0aef5a6d785870c0fd092eb88ac",
          "addresses": [
            "MNhKAWAFf2b8ACGUCopNsKQ6oeUfUKWokp"
          ]
        }
      }
    ]
  }
}

📌 8. Simplified Transaction Data

GET /ext/tx/:txid Returns only input addresses and recipients of a transaction.

---

📌 9. Latest Blocks Summary

GET /latest-blocks-summary Returns a summary of the latest blocks.

---

📌 10. Block Details

GET /block-height/:height & /block-hash/:hash Returns block data by height or hash.

---

📌 11. RPC Stats

• /getdifficulty

• /getconnectioncount

• /getpeerinfo

• /getnetworkhashps

• /getblockcount

---

📌 12. Network Stats

GET /getNetworkStats Returns combined network stats.

📌 13. Supply Information

GET /supply Returns maximum supply, circulating supply, burnt coins, and developer funds.

Example:

GET https://explorer.menelik.fun:3300/api/supply

{
  "maximumSupply": 21000000000,
  "totalEmitted": 807742880,
  "burntCoins": 1550347.512219,
  "developerCoins": 37886091.2654933,
  "circulatingSupply": "768306441.22228777",
  "percentages": {
    "burnt": "0.01%",
    "emitted": "3.85%",
    "pendingToEmit": "96.34%"
  },
  "burnAddress": "MNhKAWAFf2b8ACGUCopNsKQ6oeUfUKWokp",
  "developerAddress": "MJyFbKtyMeA9wkFf1UT5qDz2M2fsmb2TUa"
}

📌 14. Smartnode Locked Coins

GET /getSmartnodeLockedCoins Returns total locked collateral in Smartnodes.

---

📌 15. Smartnode Data

GET /getSmartnodeData Returns a summary of active Smartnodes.

---

📥 How to Use the API

Base URL

https://explorer.menelik.fun:3300/api/

Simply append the desired endpoint to query the API.

Example Fetch Request

fetch("https://explorer.menelik.fun:3300/api/last-blocks")
  .then(response => response.json())
  .then(data => console.log(data));