API Documentation

v1.0

Programmatic access to MetaCoin blockchain data. Query MRC-010 tokens, MRC-400 collections, MRC-401 items, and MRC-402 NFTs through our RESTful JSON API.

BASE URL http://api.bluescan.io

FORMAT JSON

AUTH None required (free)

MRC-010 — Fungible Token

MRC-400 — NFT Collection

MRC-401 — NFT Item (1/1)

MRC-402 — NFT (multi-supply)

Overview

The Bluescan API provides free, public access to MetaCoin blockchain data. All endpoints return JSON and require no authentication.

Endpoints

REST

Architecture

JSON

Response Format

Free

No Auth Required

Quick Start

# Get MTC balance

curl http://api.bluescan.io/address/MTEVhtRD16iORTADok0E2NCFp5QhLZkccf485c38

# Get MRC-400 collection

curl http://api.bluescan.io/nft/MRC400_e2418f34bdfaa127829c33ab5acf0a890

# Get MRC-401 item

curl "http://api.bluescan.io/nft/MRC400_e2418f34bdfaa127829c33ab5acf0a890_5d209a81df97b5915d446e9bc7fe6c657c4a1fbd"

# List MRC-402 NFTs

curl "http://api.bluescan.io/nfts?protocol=MRC402&page=1&limit=10"

NFT Protocol Overview

MRC-400 NFT Collection

A collection created by an artist or brand. Acts as the parent container for MRC-401 items. ID: MRC400_xxx

MRC-401 NFT Item (1/1)

A unique NFT item belonging to an MRC-400 collection. ID format: MRC400_parent_itemhash

MRC-402 NFT (multi-supply)

Fungible-style NFT with configurable supply. Supports auction, sale, and melt. ID: MRC402_xxx

HTTP Status Codes

200

Successful response

404

Not Found

Resource not found

500

Server Error

Internal server error

Chain Stats

GET /chain

Returns MetaCoin blockchain dashboard data including the latest block info and recent transactions.

/chain

Example Response

{
  "localBlock": 8468376,
  "mainnetBlock": 8468376,
  "blocks": [
    {
      "height": 8468376,
      "hash": "e2f6020601895ab7...",
      "txCount": 1,
      "timestamp": 1780411798
    }
  ],
  "transactions": [
    {
      "id": "9a829a296c14fb52...",
      "type": "transfer",
      "from": "MTVZhwo8enKraI34...",
      "to": "MTpxNCnVt6dY70lE...",
      "amount": "3310000000000",
      "token": "2413",
      "blockNum": 8468375,
      "blockTs": 1780411788
    }
  ]
}

GET /tx-stats

Returns daily transaction counts for the activity chart, plus today-so-far and same-time-yesterday counters used for the live delta.

Query Parameters

days integer default: 30 Number of days of history (1–90)

/tx-stats?days=14

Example Response

{
  "history": [
    { "date": "2026-05-31T00:00:00.000Z", "count": 900 },
    { "date": "2026-06-01T00:00:00.000Z", "count": 1008 },
    { "date": "2026-06-02T00:00:00.000Z", "count": 918 }
  ],
  "todaySoFar": 918,
  "yesterdaySameTime": 766
}

Blocks

GET /blocks

Returns a paginated list of the latest blocks.

Query Parameters

page integer default: 1 Page number

limit integer default: 20 Results per page (max 50)

/blocks?page=1&limit=5

Example Response

{
  "blocks": [
    {
      "height": 8455024,
      "hash": "3de30a6fabc803a2...",
      "txCount": 1,
      "timestamp": 1779530789
    }
  ],
  "currentBlock": 8455024,
  "page": 1,
  "totalPages": 422751
}

GET /block/{id}

Returns block details by block height or block hash.

Path Parameters

id string required Block height (number) or block hash

/block/8455024

Example Response

{
  "id": "5fb5a338bb58b3eb...",
  "sn": "8455024",
  "timestamp": 1779530789,
  "transaction": [
    {
      "id": "388893a9b622e8ce...",
      "timestamp": 1779530789
    }
  ]
}

GET /rawblock/{id}

Raw block data fetched directly from the blockchain node, including full transaction payloads.

Path Parameters

id string required Block height (number) or block hash

/rawblock/8455024

Example Response

{
  "block": {
    "id": "5fb5a338bb58b3eb...",
    "sn": "8455024",
    "timestamp": 1779530789,
    "transaction": [
      {
        "id": "388893a9b622e8ce...",
        "type": "mrc401_transfer",
        "timestamp": 1779530789
      }
    ]
  }
}

Transactions

GET /transactions

Returns a paginated list of recent transactions. Includes MTC transfers, MRC-010 token transfers, and all NFT transactions.

Query Parameters

page integer default: 1 Page number

limit integer default: 20 Results per page (max 50)

/transactions?page=1&limit=5

Example Response

{
  "transactions": [
    {
      "id": "9a829a296c14fb52...",
      "type": "transfer",
      "from": "MTVZhwo8enKraI34...",
      "to": "MTpxNCnVt6dY70lE...",
      "amount": "33100.",
      "token": "2413",
      "blockNum": 8468375,
      "blockTs": 1780411788,
      "tokenSymbol": "RST",
      "tokenName": "REDSKULL",
      "tokenDecimal": 8
    }
  ],
  "currentBlock": 8468376,
  "page": 1,
  "totalPages": 4982162
}

GET /tx/{id}

Returns full transaction details by hash. Supports all types: MTC transfer, MRC-010 mint/transfer, MRC-400/401/402 create/transfer.

Path Parameters

id string required Transaction hash (64-char hex)

/tx/3de30a6fabc803a27ac5e17d8c1b6644d1c4d0495ecd74ef9efd8e4a86b8fa85

Example Response

[
  {
    "id": "3de30a6fabc803a2...",
    "type": "mrc401_transfer",
    "db_id": "6f76430927f88c72...",
    "db_sn": "8455024",
    "token": "",
    "values": {
      "tx_id": "3de30a6fabc803a2...",
      "job_type": "mrc401_transfer",
      "jobdate": 1779530789,
      "mrc402": null
    },
    "address": "MTEVhtRD16iORTAD...",
    "datakey": "MTEVhtRD16iORTAD...",
    "timestamp": 1779530789,
    "parameters": ["MRC400_e2418f34..._5d209a81...", "..."],
    "validationCode": 0
  }
]

GET /rawtx/{id}

Raw transaction data fetched directly from the blockchain node.

Path Parameters

id string required Transaction hash

/rawtx/3de30a6fabc803a27ac5e17d8c1b6644d1c4d0495ecd74ef9efd8e4a86b8fa85

Example Response

{
  "transaction": [
    {
      "id": "3de30a6fabc803a2...",
      "type": "mrc401_transfer",
      "db_id": "6f76430927f88c72...",
      "db_sn": "8455024",
      "timestamp": 1779530789
    }
  ]
}

Address

GET /address/{id}

Returns MTC balance, MRC-010 token balances, MRC-402 NFT holdings, and MRC-400/401 item holdings for a wallet address.

Path Parameters

id string required MetaCoin wallet address (starts with MT)

/address/MTEVhtRD16iORTADok0E2NCFp5QhLZkccf485c38

Example Response

{
  "address": "MTEVhtRD16iORTADok0E2NCFp5QhLZkccf485c38",
  "regdate": 1774300265,
  "addinfo": "",
  "balances": [
    {
      "tokenId": 0,
      "tokenName": "Metacoin",
      "tokenSymbol": "MTC",
      "decimal": 8,
      "image": "https://resource.metascan.io/mainnet/symbol/0.png",
      "balance": "4900000000",
      "saleamount": "0",
      "auctionamount": "0",
      "lockBalance": "0",
      "locks": []
    }
  ],
  "nfts": [
    {
      "id": "MRC400_803207be..._6c4a7906...",
      "name": "#6c4a7906",
      "image": "https://zzal.io/data/1d/f8/bc/...",
      "balance": "1",
      "saleamount": "0",
      "auctionamount": "0",
      "parent": "MRC400_803207be...",
      "parentName": "Ella Lee"
    }
  ]
}

GET /address/{id}/txs

Returns a paginated activity history for a wallet address across MTC, MRC-010 tokens, and NFTs.

Path Parameters

id string required MetaCoin wallet address (starts with MT)

Query Parameters

page integer default: 1 Page number

limit integer default: 20 Results per page

/address/MTEVhtRD16iORTADok0E2NCFp5QhLZkccf485c38/txs?page=1&limit=5

Example Response

{
  "total": 382,
  "page": 1,
  "limit": 5,
  "data": [
    {
      "job_type": "mrc401_transfer",
      "jobdate": 1779530789,
      "tx_id": "3de30a6fabc803a2...",
      "db_sn": "8455024",
      "summary": "MRC-401 Transfer",
      "from": "MTEVhtRD16iORTAD...",
      "to": "MT2KOC2K192jnrHw...",
      "amount": "1",
      "nftId": "MRC400_e2418f34..._5d209a81...",
      "tokenName": "#5d209a81",
      "tokenSymbol": "MRC-401",
      "parentName": "Antoine Laurent"
    }
  ]
}

MRC-010 Tokens

GET MRC-010 /tokens

Returns a paginated list of all MRC-010 tokens including MTC (token ID 0).

Query Parameters

page integer default: 1 Page number

limit integer default: 20 Results per page

/tokens?page=1&limit=5

Example Response

{
  "total": 2777,
  "page": 1,
  "limit": 5,
  "items": [
    {
      "id": "2777",
      "token": 2777,
      "name": "RichardPresleyR5",
      "symbol": "Face",
      "owner": "MTIU9wpd1ZQdeSQfpuLnX4Im0APf6gcA727d75f7",
      "totalsupply": "1000000000000000",
      "type": "010",
      "decimal": 8,
      "createdate": 1780261016,
      "has_image": true,
      "image_url": "/api/v1/token/2777/image",
      "burnningamount": "0"
    }
  ]
}

GET MRC-010 /token/{id}

Returns MRC-010 token details by token ID. ID 0 is the native MTC token.

Path Parameters

id integer required Token ID (0 = MTC, 1+ = MRC-010 token)

/token/0

Example Response

{
  "id": "0",
  "token": 0,
  "name": "Metacoin",
  "symbol": "MTC",
  "type": "010",
  "owner": "MTiiiiiiiiiiiiMETACOINiiiiiiiiii79c3496e",
  "decimal": 8,
  "totalsupply": "200000000000000000",
  "circulation_supply": "198882165099497600",
  "remainamount": "0",
  "burnningamount": "0",
  "hardcap": "70000000000000000",
  "softcap": "5000000000000000",
  "url": "https://www.metacoin.network",
  "information": "Metacoin - The First Cryptocurrency...",
  "image": "data:image/png;base64,...",
  "status": "normal",
  "job_type": "tokenRegister",
  "createdate": 1536382141
}

GET MRC-010 /token/{id}/holders

Returns the top holders of an MRC-010 token with balances and lock state.

Path Parameters

id integer required Token ID (0 = MTC, 1+ = MRC-010 token)

Query Parameters

page integer default: 1 Page number

limit integer default: 20 Results per page

/token/0/holders?page=1&limit=5

Example Response

{
  "token_id": 0,
  "total": 12848,
  "total_balance": "202536349270950111",
  "page": 1,
  "limit": 5,
  "holders": [
    {
      "address": "MTxHI8sJIfUZ84Jx...",
      "balance": "10069209800000000",
      "token": 0,
      "lock_balance": "0",
      "unlockdate": 0,
      "locks": []
    }
  ]
}

GET MRC-010 /token/{id}/txs

Returns a paginated transfer history for an MRC-010 token.

Path Parameters

id integer required Token ID (0 = MTC, 1+ = MRC-010 token)

Query Parameters

page integer default: 1 Page number

limit integer default: 20 Results per page

/token/0/txs?page=1&limit=5

Example Response

{
  "owner": "",
  "total": 381361,
  "page": 1,
  "limit": 5,
  "data": [
    {
      "type": "Receive",
      "from": "MTirNmJvguEejXMr...",
      "to": "MTsAEpqokmNuMLYe...",
      "amount": "8000000000000",
      "token": "0",
      "timestamp": 1780406466,
      "tx_id": "e7f0643895baceef...",
      "block_sn": 8468305,
      "recipients": [ { "to": "MTsAEpqokmNuMLYe...", "amount": "8000000000000" } ],
      "memo": ""
    }
  ]
}

GET MRC-010 /token/{id}/history

Returns the lifecycle events of an MRC-010 token (create, reserve, mint, burn).

Path Parameters

id integer required Token ID (0 = MTC, 1+ = MRC-010 token)

/token/0/history

Example Response

{
  "token_id": 0,
  "total": 2,
  "events": [
    {
      "tx_id": "356fc3a82bfe084e...",
      "tx_type": "Token Create",
      "from_addr": "MTiiiiiiiiiiiiMETACOINiiiiiiiiii79c3496e",
      "to_addr": "-",
      "amount": "200000000000000000",
      "block_sn": 4,
      "timestamp": 1604636104,
      "memo": ""
    }
  ]
}

GET MRC-010 /token/{id}/locks

Returns time-locked balances for an MRC-010 token, grouped by address.

Path Parameters

id integer required Token ID (0 = MTC, 1+ = MRC-010 token)

/token/0/locks

Example Response

{
  "token_id": 0,
  "scanned": 2000,
  "max": 2000,
  "locked_addresses": 7,
  "locks": [
    {
      "address": "MThT0m128hFwCYpM...",
      "lock_balance": "10000000000000000",
      "unlockdate": 1820329200,
      "locks": [ { "amount": "10000000000000000", "unlockdate": 1820329200 } ]
    }
  ]
}

GET MRC-010 /v1/token/{id}/image

Returns the token logo as a PNG image (binary, not JSON).

Path Parameters

id integer required Token ID (0 = MTC, 1+ = MRC-010 token)

/v1/token/0/image

Example Response

// Binary PNG (Content-Type: image/png), not JSON.
// Use directly as an image source:
<img src="https://bluescan.io/api/v1/token/0/image" />

GET MRC-010 /mtc-stats

Returns MTC supply statistics including total supply and circulating supply. Mainnet only.

/mtc-stats

Example Response

{
  "token": 0,
  "name": "Metacoin",
  "symbol": "MTC",
  "decimal": 8,
  "totalsupply": "200000000000000000",
  "circulation_supply": "198882165099497600",
  "remainamount": "0",
  "burnningamount": "0",
  "softcap": "5000000000000000",
  "hardcap": "70000000000000000",
  "status": "normal",
  "createdate": 1536382141
}

MRC-400 Collection

GET MRC-400 /nft/{id}

Returns details of an MRC-400 NFT collection including owner, image, description, category, and item URL template.

Path Parameters

id string required MRC-400 collection ID (format: MRC400_xxx)

/nft/MRC400_e2418f34bdfaa127829c33ab5acf0a890

Example Response

{
  "id": "MRC400_e2418f34bdfaa127829c33ab5acf0a890",
  "protocol": "MRC400",
  "owner": "MTEVhtRD16iORTADok0E2NCFp5QhLZkccf485c38",
  "creator": "MTEVhtRD16iORTADok0E2NCFp5QhLZkccf485c38",
  "name": "Antoine Laurent",
  "category": "Art",
  "description": "Artist: Antoine Laurent...",
  "url": "https://Antoinelaurent.com/",
  "image_url": "https://zzal.io/data/71/22/60/712260de8dc8f1a3ee2691515c815ade.png",
  "image": "https://zzal.io/data/71/22/60/712260de8dc8f1a3ee2691515c815ade.png",
  "item_url": "https://Antoinelaurent.com/",
  "item_image_url": "https://zzal.io/data/71/22/60/712260de8dc8f1a3ee2691515c815ade.png",
  "allow_token": "0",
  "job_type": "mrc400_create",
  "createdate": 1779524405
}

GET MRC-400 /nft-items

Returns a list of MRC-401 items belonging to an MRC-400 collection, including owner, image, and sale/auction status.

Query Parameters

id string required MRC-400 collection ID

page integer default: 1 Page number

limit integer default: 20 Results per page

/nft-items?id=MRC400_e2418f34bdfaa127829c33ab5acf0a890&page=1&limit=10

Example Response

{
  "items": [
    {
      "id": "MRC400_e2418f34..._5d209a81...",
      "name": "#5d209a81",
      "image": "https://zzal.io/data/4d/33/27/4d3327035ef2fbc9c484c19027017b7d.jpg",
      "owner": "MT2KOC2K192jnrHwyoTOCLh6XGAb5NQ7a7d239d5",
      "createdate": 1779530750,
      "job_type": "mrc401_transfer",
      "transferable": "Permanent",
      "sellPrice": 0,
      "sellToken": "0",
      "auctionStartPrice": 0,
      "auctionCurrentPrice": 0
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 10
}

GET MRC-400 /nft-holders

Returns the holder list for an MRC-400 collection with the number of items held by each address.

Query Parameters

id string required MRC-400 collection ID

page integer default: 1 Page number

limit integer default: 20 Results per page

/nft-holders?id=MRC400_e2418f34bdfaa127829c33ab5acf0a890

Example Response

{
  "nftId": "MRC400_e2418f34bdfaa127829c33ab5acf0a890",
  "total": 1,
  "total_balance": "1",
  "page": 1,
  "limit": 20,
  "holders": [
    {
      "address": "MT2KOC2K192jnrHwyoTOCLh6XGAb5NQ7a7d239d5",
      "amount": "1",
      "sellAmount": "0",
      "auctionAmount": "0",
      "total": "1",
      "ratio": "100.0000"
    }
  ]
}

GET MRC-400 /nft-history

Returns the lifecycle event history of an MRC-400 collection: creation, item minting, transfers, sales.

Query Parameters

id string required MRC-400 collection ID

/nft-history?id=MRC400_e2418f34bdfaa127829c33ab5acf0a890

Example Response

{
  "history": [
    {
      "txid": "3de30a6fabc803a2...",
      "type": "Transfer",
      "from": "MTEVhtRD16iORTAD...",
      "to": "MT2KOC2K192jnrHw...",
      "price": "",
      "timestamp": 1779530789,
      "amount": "1",
      "itemId": "MRC400_e2418f34..._5d209a81...",
      "itemName": "#5d209a81..."
    },
    {
      "txid": "910ee961470da83d...",
      "type": "Mint",
      "from": "MTEVhtRD16iORTAD...",
      "to": "MRC400_e2418f34..._5d209a81...",
      "timestamp": 1779530750,
      "amount": "1"
    }
  ],
  "total": 2
}

GET MRC-400 /nft-tx

Returns the transaction list for an MRC-400 collection including collection creation, item minting, and transfers.

Query Parameters

id string required MRC-400 collection ID

page integer default: 1 Page number

limit integer default: 20 Results per page

/nft-tx?id=MRC400_e2418f34bdfaa127829c33ab5acf0a890&page=1

Example Response

{
  "items": [
    {
      "txid": "3de30a6fabc803a2...",
      "type": "MRC-401 Transfer",
      "from": "MTEVhtRD16iORTAD...",
      "to": "MT2KOC2K192jnrHw...",
      "amount": "1",
      "timestamp": 1779530789,
      "block": 8455024,
      "raw": {
        "type": "mrc401_transfer",
        "ukey": "MRC400_e2418f34..._5d209a81...",
        "mrc402": {
          "id": "MRC400_e2418f34..._5d209a81...",
          "name": "#5d209a81",
          "imageurl": "https://zzal.io/data/4d/33/27/..."
        },
        "parentImage": "https://zzal.io/data/71/22/60/..."
      }
    }
  ],
  "total": 2
}

MRC-401 Item

GET MRC-401 /nft/{id}

Returns MRC-401 NFT item details. The item ID format is "parentCollectionID_itemHash". Includes owner, image, sale/auction status, and parent collection info.

Path Parameters

id string required MRC-401 item ID (format: MRC400_xxx_yyy — parent_itemhash)

/nft/MRC400_e2418f34bdfaa127829c33ab5acf0a890_5d209a81df97b5915d446e9bc7fe6c657c4a1fbd

Example Response

{
  "id": "MRC400_e2418f34..._5d209a81...",
  "protocol": "MRC401",
  "mrc400": "MRC400_e2418f34bdfaa127829c33ab5acf0a890",
  "owner": "MT2KOC2K192jnrHwyoTOCLh6XGAb5NQ7a7d239d5",
  "creator": "MT2KOC2K192jnrHwyoTOCLh6XGAb5NQ7a7d239d5",
  "name": "#5d209a81",
  "image": "https://zzal.io/data/4d/33/27/4d3327035ef2fbc9c484c19027017b7d.jpg",
  "item_image_url": "https://zzal.io/data/4d/33/27/4d3327035ef2fbc9c484c19027017b7d.jpg",
  "parent": "MRC400_e2418f34bdfaa127829c33ab5acf0a890",
  "parentName": "Antoine Laurent",
  "parentImage": "https://zzal.io/data/71/22/60/712260de8dc8f1a3ee2691515c815ade.png",
  "groupid": "MRC400_e2418f34bdfaa127829c33ab5acf0a890",
  "createdate": 1779530750,
  "transferable": "Permanent",
  "status": "held",
  "sell_price": "0",
  "sell_token": "0",
  "auction_start_price": "0",
  "job_type": "mrc401_transfer"
}

GET MRC-401 /nft-tx

Returns the transaction history for an MRC-401 item from minting to all subsequent transfers.

Query Parameters

id string required MRC-401 item ID

page integer default: 1 Page number

limit integer default: 20 Results per page

/nft-tx?id=MRC400_e2418f34bdfaa127829c33ab5acf0a890_5d209a81df97b5915d446e9bc7fe6c657c4a1fbd&page=1

Example Response

{
  "items": [
    {
      "txid": "3de30a6fabc803a2...",
      "type": "MRC-401 Transfer",
      "from": "MTEVhtRD16iORTAD...",
      "to": "MT2KOC2K192jnrHw...",
      "amount": "1",
      "timestamp": 1779530789,
      "block": 8455024,
      "raw": {
        "type": "mrc401_transfer",
        "ukey": "MRC400_e2418f34..._5d209a81...",
        "mrc402": {
          "id": "MRC400_e2418f34..._5d209a81...",
          "name": "#5d209a81",
          "imageurl": "https://zzal.io/data/4d/33/27/..."
        },
        "image": "https://zzal.io/data/4d/33/27/...",
        "parentImage": "https://zzal.io/data/71/22/60/..."
      }
    },
    {
      "txid": "910ee961470da83d...",
      "type": "MRC-401 Create",
      "from": "MTEVhtRD16iORTAD...",
      "to": "MRC400_e2418f34..._5d209a81...",
      "amount": "1",
      "timestamp": 1779530750
    }
  ],
  "total": 2
}

MRC-402 NFT

GET MRC-402 /nfts

Returns a paginated list of MRC-402 NFTs. Filter by protocol (MRC401 or MRC402) using the protocol query param.

Query Parameters

page integer default: 1 Page number

limit integer default: 20 Results per page

protocol string Protocol filter: MRC402 | MRC401 | (empty = all)

/nfts?protocol=MRC402&page=1&limit=5

Example Response

{
  "total": 390,
  "page": 1,
  "limit": 5,
  "items": [
    {
      "protocol": "MRC402",
      "id": "MRC402_52fc35bea2856d98d7fb96da9d5ecc350",
      "name": "RichardPresleyR5",
      "image": "https://zzal.io/data/fd/e2/fd/...",
      "item_image_url": "https://zzal.io/data/fd/e2/fd/...",
      "creator": "MTIU9wpd1ZQdeSQfpuLnX4Im0APf6gcA727d75f7",
      "owner": "MTIU9wpd1ZQdeSQfpuLnX4Im0APf6gcA727d75f7",
      "totalsupply": "1.0000000000",
      "createdate": 1780260773,
      "category": "MRC-402",
      "url": "https://nft.com/aefea"
    }
  ]
}

GET MRC-402 /nft/{id}

Returns MRC-402 NFT details including total supply, circulating supply, melt amount, fee structure, and shareholder info.

Path Parameters

id string required MRC-402 NFT ID (format: MRC402_xxx)

/nft/MRC402_52fc35bea2856d98d7fb96da9d5ecc350

Example Response

{
  "id": "MRC402_52fc35bea2856d98d7fb96da9d5ecc350",
  "protocol": "MRC402",
  "creator": "MTIU9wpd1ZQdeSQfpuLnX4Im0APf6gcA727d75f7",
  "owner": "MTIU9wpd1ZQdeSQfpuLnX4Im0APf6gcA727d75f7",
  "name": "RichardPresleyR5",
  "totalsupply": "1",
  "meltedamount": "0",
  "circulation_supply": "1",
  "decimal": 0,
  "creatorcommission": "10",
  "image": "https://zzal.io/data/fd/e2/fd/...",
  "url": "https://nft.com/aefea",
  "info": "",
  "expiredate": 0,
  "initialreserve": {},
  "shareholder": null,
  "job_type": "mrc402_create"
}

GET MRC-402 /nft-holders

Returns the holder list for an MRC-402 NFT with each holder's quantity, amount on sale/auction, and ownership share.

Query Parameters

id string required MRC-402 NFT ID

page integer default: 1 Page number

/nft-holders?id=MRC402_52fc35bea2856d98d7fb96da9d5ecc350

Example Response

{
  "holders": [
    {
      "address": "MTIU9wpd1ZQdeSQf...",
      "amount": "1.0000000000",
      "sellAmount": "0.0000000000",
      "auctionAmount": "0.0000000000",
      "total": "1.0000000000",
      "ratio": "100.0000"
    }
  ],
  "total": 1,
  "total_balance": "1"
}

GET MRC-402 /nft-tx

Returns the transaction list for an MRC-402 NFT. Includes all events: Mint, Transfer, Sell, Auction, Melt.

Query Parameters

id string required MRC-402 NFT ID

page integer default: 1 Page number

limit integer default: 20 Results per page

/nft-tx?id=MRC402_52fc35bea2856d98d7fb96da9d5ecc350&page=1

Example Response

{
  "items": [
    {
      "txid": "ea978e85a1d3296d...",
      "type": "MRC-402 Create",
      "from": "MTIU9wpd1ZQdeSQf...",
      "to": "",
      "amount": "1",
      "timestamp": 1780260773,
      "block": 8466424,
      "raw": { "type": "mrc402create", "ukey": "MRC402_52fc35be..." }
    }
  ],
  "total": 1
}

GET MRC-402 /nft-history

Returns the full lifecycle history of an MRC-402 NFT in chronological order from creation to present.

Query Parameters

id string required MRC-402 NFT ID

/nft-history?id=MRC402_52fc35bea2856d98d7fb96da9d5ecc350

Example Response

{
  "history": [
    {
      "txid": "ea978e85a1d3296d...",
      "type": "MRC-402 Create",
      "from": "MTIU9wpd1ZQdeSQf...",
      "to": "RichardPresleyR5",
      "amount": "",
      "timestamp": 1780260773,
      "block": 8466424
    }
  ],
  "total": 1
}

Search

GET /search

Unified search across blocks, transactions, wallet addresses, tokens, and NFTs. Returns a redirect URL on exact match, or a result list for multiple matches.

Query Parameters

q string required Query (block height, TX hash, wallet address, token name/symbol, token ID, or NFT ID)

/search?q=Metacoin

Example Response

// Exact match — returns redirect:
{
  "redirect": "/token/0/tx/1"
}

// Redirect targets:
// Block height   →  /block/{height}
// TX hash        →  /tx/{hash}
// Wallet address →  /address/{addr}/tx/1
// Token ID       →  /token/{id}/tx/1
// Token name     →  /token/list?search={query}
// NFT ID         →  /nft/{id}/tx/1

// No results:
{
  "blocks": [],
  "transactions": [],
  "tokens": [],
  "nfts": []
}

Viewer

GET /tx/{id}/templates

List the available display templates for a transaction with their shareable viewer URLs (free templates open directly; pro templates need an apikey).

Path Parameters

id string required Transaction hash

/tx/3de30a6fabc803a27ac5e17d8c1b6644d1c4d0495ecd74ef9efd8e4a86b8fa85/templates

Example Response

{
  "tx": "3de30a6fabc803a2...",
  "templates": [
    { "id": "default",     "tier": "free", "url": "https://bluescan.io/viewer/tx/3de30a6f.../?template=default" },
    { "id": "simple",      "tier": "free", "url": "https://bluescan.io/viewer/tx/3de30a6f.../?template=simple" },
    { "id": "receipt",     "tier": "free", "url": "https://bluescan.io/viewer/tx/3de30a6f.../?template=receipt" },
    { "id": "certificate", "tier": "pro",  "url": "https://bluescan.io/viewer/tx/3de30a6f.../?template=certificate&apikey=YOUR_API_KEY" }
  ]
}

// Open any URL to render the transaction in that template.
// free  → opens directly, fully shareable
// pro   → append &apikey=YOUR_KEY (see /api-plans)

Need a specific endpoint?

All endpoints are publicly available and require no authentication. Data is sourced in real-time from the MetaCoin blockchain network. For feature requests or issues, feel free to reach out.