Metacoin API
MetacoinMetaWallet Deeplink APIMetascanRedscan
Metacoin API(version 2.1)
Metacoin API(version 2.1)
  • Metacoin API
  • Quick Start
  • Reference
    • REST API Reference
      • Address
      • Block and transaction
      • Token
      • MRC400(NFT)
      • MRC402(NFT)
Powered by GitBook
On this page
  1. Reference
  2. REST API Reference

MRC402(NFT)

MRC-402 is Token like NFT

Support mixed assets for NFT.

MRC402 supports the mixed assets and shares some portion of commission to a copyright holder or a profit share holder on Sales/Auction.

It supports to create Token/MRC402 and Mint and Burn by QR Code or Deeplink on MetaWallet webpage.

Here is the MRC402’s main features.

Mixed Assets

You can create the NFT with combining several tokens not only one token.

  • James set as 5 Metacoin and 10 JamesToken(MRC010) per one NFT as initial assets then create 100 JamesNFT.

  • It’s withdrawn the 500 Metacoin(5MTC*100), 1000 JamesToken(10 JamesToken * 100) from creator’s wallet.

  • It’s valued of 5 Metacoin, 10 JamesToken on 1 JamesNFT.

  • If a user who has got JameNFT melt it or James who create the JamesNFT burn it, you can get the amount of melted or burned * 5 Metacoin, 10 JemaesToken(MRC010).

Copyright Information

NFT is usually used in work of art.

However, there are so confused to users who want to own the NFT. because it is unclear which art is based on.

In MRC402, copyright information can be set only once when NFT is created.

It will ensure that those who wish to own the NFT recognize which work they have by reference this information.

Burn

Burn will reduce the total issuance and it can do by an issuer only.

If there is an initial asset, it will be returned equal to the burned amount * the initial asset.

Mint

Mint will increase the total issuance and can only be issued by issuer.

If there is an initial asset, it will be reduced from the creator’s wallet by the amount of mint * initial asset.

Transfer

MRC402 can send multiple NFTs on transaction not like MRC401.

Melt

Users who has got NFT can do the Melting.

But, If you specify a date that Melting function can be executed on creating the NFT, you can not do Melting before that date.

  • James sends 100 MTC to Mary with a lockup until January.01.2025.

  • Mary can not give 100 MTC to someone until that date.

  • But, If James send to Mary it after setting the initial asset as 100 MTC and melting point as January.01.2025 and issuing 1 MRC402 Mary can transfer to someone at any time and the user who has got it get 100 MTC with melting after January.01.2015.

It has the same effect as a lockup and can also be used as a transferable token.

Support various media

It can publish the NFT by MP4 files as well as images.

It saves in zzal.io because the storing in blockchain consumes excessive traffic and capacity.

zzal.io is a service that stores with distributing images and videos.

Support Platform

  • We open a website “HotDeal.io” that supports NFT trading and provides a variety of information related trading NFT.

  • It can be expected to get advertising and transaction fees.

  • ADV can be carried out in various support methods.

  • If you want to get the commission at a certain percentage on the transaction, sellers send the NFT to “HotDeal.io”,

  • “HotDeal.io” send to the seller with deducted the commission after getting the transaction amount from buyers.

  • After all, it becomes subordinate to a web service called “HotDeal.io” not a decentralized transaction.

If it sell/auction in Metacoin Network after fill out the platform name, commission rate and receiver’s address for commission on registering MRC402,

Trading is made on the Metacoin Network. The fee is distributed according to the information.

Support ShareHolder

You can enter the copyright holder on creating NFT or a user who receive the commission on trading.

We called it “ShareHolder”.

ShareHolder can put the address and commission rate up to 5 addresses.

It’s set up at the time of initial creation and can not be changed.

It supports multiple copyright holders and give stable profits on the Metacoin Network.

It helps you to be more creative.

PreviousMRC400(NFT)

Last updated 2 years ago

Create MRC402 Token

post
Path parameters
mrc400idstring · min: 40 · max: 40Required

MRC400 Token ID

Query parameters
Responses
200
successful operation
*/*
404
MRC400 not found
post
POST /mrc402 HTTP/1.1
Host: rest.metacoin.network:20923
Accept: */*
{
  "transaction_id": "text"
}

GET MRC402 Token

get
Path parameters
mrc400idstringRequired

MRC402 Token ID

Example: MRC400_db7da6bc848ba62e621aede40f75dc760_0000000000000000000000000000000000000001
Responses
200
successful operation
*/*
404
MRC400 not found
get
GET /mrc402/{mrc402id} HTTP/1.1
Host: rest.metacoin.network:20923
Accept: */*
{
  "allow_token": "text",
  "category": "text",
  "createdate": 1,
  "data": "text",
  "description": "text",
  "image_url": "text",
  "name": "text",
  "owner": "text",
  "url": "text",
  "item_image_url": "text",
  "item_url": "text"
}

Transfer ownership of the MRC402 token to another user.

post
Path parameters
mrc402idstring · min: 81 · max: 81Required

MRC402 Token ID

Query parameters
fromAddrstring · Metacoin Address · min: 40 · max: 40Required

Current owner of item MRC402

toAddrstring · Metacoin Address · min: 40 · max: 40Required

Address to receive ownership of MRC402 token

tkeystringRequired

Temporary key for Sign(return value of GET /getkey/transfer)

signaturestring · base64Required
  • ECDSA sign for concat fromAddr, toAddr, url, tkey
  • ex) ecdsa_sign(privatekey of owner address, fromAddr +'|'+ toAddr +'|'+ mrc402id +'|'+tkey)
Responses
200
successful operation
*/*
404
MRC400 not found
post
POST /mrc402/transfer/{mrc402id} HTTP/1.1
Host: rest.metacoin.network:20923
Accept: */*
{
  "transaction_id": "text"
}

Sell MRC402 Token

post
  • Sell ​​MRC402 tokens.
  • If other users purchase tokens, they will receive the specified amount of sales.
  • If sell_fee is 10, 10% of the transaction amount will be transferred to the MRC400 token holder designated in the MRC402 token, and only 90% of the fee excluding the 10% fee will be received by the MRC402 token holder.
  • If the value of sell_fee is 0, no commission is paid.
Path parameters
mrc400idstring · min: 40 · max: 40Required
  • MRC400 Token ID
  • The mrc400 token ID of the mrc402 item specified in itemdata.
Query parameters
sellerstring · Metacoin AdderessOptional
tkeystringRequired

Temporary key for Sign(return value of GET /getkey/transfer)

signaturestring · base64Required
  • ECDSA sign for concat seller, itemdata, tkey
  • ex) ecdsa_sign(privatekey of owner address, seller +'|'+ itemdata +'|'+ tkey)
Responses
200
successful operation
*/*
404
MRC400 not found
post
POST /mrc402/sell HTTP/1.1
Host: rest.metacoin.network:20923
Accept: */*
{
  "transaction_id": "text"
}

MRC402 token sale canceled

post
Path parameters
mrc400idstring · min: 40 · max: 40Required
  • MRC400 Token ID
  • The mrc400 token ID of the mrc402 item specified in itemdata.
Query parameters
sellerstring · Metacoin AdderessOptional

MRC402 Token owner address

itemdatastring[] · min: 1 · max: 100Optional
  • MRC402 Token id list to be sale cancel
  • It is the MRC402 Token belonging to the token specified in mrc400id
Example: {"MRC400_db7da6bc848ba62e621aede40f75dc760_0000000000000000000000000000000000000001","MRC400_db7da6bc848ba62e621aede40f75dc760_0000000000000000000000000000000000000002"}
tkeystringRequired

Temporary key for Sign(return value of GET /getkey/transfer)

signaturestring · base64Required
  • ECDSA sign for concat seller, itemdata, tkey
  • ex) ecdsa_sign(privatekey of owner address, seller +'|'+ itemdata +'|'+ tkey)
Responses
200
successful operation
*/*
404
MRC400 not found
post
POST /mrc402/unsell HTTP/1.1
Host: rest.metacoin.network:20923
Accept: */*
{
  "transaction_id": "text"
}

Buy MRC402 Token

post
Path parameters
mrc402idstring · min: 81 · max: 81Required

MRC402 Token ID

Example: MRC400_dd1605be6960d9d6ba7bbeed9da033980_0000000000000000000000000000000000000001
Query parameters
buyerstring · Metacoin AdderessOptional

MRC402 Token buyer address

tkeystringRequired

Temporary key for Sign(return value of GET /getkey/transfer)

signaturestring · base64Required
  • ECDSA sign for concat mrc402id, tkey
  • ex) ecdsa_sign(privatekey of owner address, mrc402id +'|'+ tkey)
Responses
200
successful operation
*/*
404
MRC400 not found
post
POST /mrc402/buy/{mrc402id} HTTP/1.1
Host: rest.metacoin.network:20923
Accept: */*
{
  "transaction_id": "text"
}

Melt MRC402

post
  • Melt the MRC402 token.
  • Once melted, the item cannot be transferred or sold to others.
  • When the MRC402 Token is created, it will be received in the owner's wallet as much as the initial_price.
  • If the meltint_fee is 10, 10% of the initial_price will be transferred to the MRC400 token holder specified in the MRC402 token, and only 90% of the fee excluding the 10% fee will be received by the MRC402 token holder.
  • If the value of meltint_fee is 0, no fee is paid.
Path parameters
mrc402idstring · min: 81 · max: 81Required

MRC402 Token ID

Query parameters
tkeystringRequired

Temporary key for Sign(return value of GET /getkey/transfer)

signaturestring · base64Required
  • ECDSA sign for concat mrc402id, tkey
  • ex) ecdsa_sign(privatekey of owner address, mrc402id +'|'+ tkey)
Responses
200
successful operation
*/*
404
MRC400 not found
post
POST /mrc402/melt/{mrc402id} HTTP/1.1
Host: rest.metacoin.network:20923
Accept: */*
{
  "transaction_id": "text"
}

Auction MRC402 Token

post
  • Auction ​​MRC402 tokens.
  • You can cancel an auction using the /mrc402/unauction protocol.
  • If there is a bidder, the auction cannot be canceled.
  • If sell_fee is 10, 10% of the transaction amount will be transferred to the MRC400 token holder designated in the MRC402 token, and only 90% of the fee excluding the 10% fee will be received by the MRC402 token holder.
  • If the value of sell_fee is 0, no commission is paid.
Path parameters
mrc400idstring · min: 40 · max: 40Required
  • MRC400 Token ID
  • The mrc400 token ID of the mrc402 item specified in itemdata.
Query parameters
sellerstring · Metacoin AdderessOptional
tkeystringRequired

Temporary key for Sign(return value of GET /getkey/transfer)

signaturestring · base64Required
  • ECDSA sign for concat seller, itemdata, tkey
  • ex) ecdsa_sign(privatekey of owner address, seller +'|'+ itemdata +'|'+ tkey)
Responses
200
successful operation
*/*
404
MRC400 not found
post
POST /mrc402/auction HTTP/1.1
Host: rest.metacoin.network:20923
Accept: */*
{
  "transaction_id": "text"
}

MRC402 token auction canceled

post
  • If there is a bidder, the auction cannot be canceled.
Path parameters
mrc400idstring · min: 40 · max: 40Required
  • MRC400 Token ID
  • The mrc400 token ID of the mrc402 item specified in itemdata.
Query parameters
sellerstring · Metacoin AdderessOptional

MRC402 Token owner address

itemdatastring[] · min: 1 · max: 100Optional
  • MRC402 Token id list to be sale cancel
  • It is the MRC402 Token belonging to the token specified in mrc400id
Example: {"MRC400_db7da6bc848ba62e621aede40f75dc760_0000000000000000000000000000000000000001","MRC400_db7da6bc848ba62e621aede40f75dc760_0000000000000000000000000000000000000002"}
tkeystringRequired

Temporary key for Sign(return value of GET /getkey/transfer)

signaturestring · base64Required
  • ECDSA sign for concat seller, itemdata, tkey
  • ex) ecdsa_sign(privatekey of owner address, seller +'|'+ itemdata +'|'+ tkey)
Responses
200
successful operation
*/*
404
MRC400 not found
post
POST /mrc402/unauction HTTP/1.1
Host: rest.metacoin.network:20923
Accept: */*
{
  "transaction_id": "text"
}

Bid MRC402 Token

post
Path parameters
mrc402idstring · min: 81 · max: 81Required

MRC402 Token ID

Example: MRC400_dd1605be6960d9d6ba7bbeed9da033980_0000000000000000000000000000000000000001
Query parameters
buyerstring · Metacoin AdderessOptional

MRC402 Token auction bidder address

tkeystringRequired

Temporary key for Sign(return value of GET /getkey/transfer)

amountstring · integer · min: 1 · max: 1e+40Optional
  • auction bid amount
  • If there are no bidders, it must be equal to or greater than the starting price of the auction.
  • If there is a bidder, it must be greater than the current bid amount.
  • The bid amount must be equal to the auction opening price or the auction opening price plus a multiple of the auction bid units.
  • If there are no bidders and the auction start price is 100 and the bid unit is 5, it must be 100, 105, 110, ...
  • If there is a bidder, the current bid is 120, the auction starting price is 100, and the bid unit is 5, it should be 125, 130, 135, ...
Example: 100
tokenstring · integer · min: 1 · max: 1e+40Optional
  • This value should be the ID of the token specified to be used in the auction.
Example: 0
signaturestring · base64Required
  • ECDSA sign for concat mrc402id, amount, token, tkey
  • ex) ecdsa_sign(privatekey of owner address, mrc402id +'|'+ amount + '|' + token + '|' + tkey)
Responses
200
successful operation
*/*
404
MRC400 not found
post
POST /mrc402/bid/{mrc402id} HTTP/1.1
Host: rest.metacoin.network:20923
Accept: */*
{
  "transaction_id": "text"
}

Finish MRC402 token auction

get
  • Process the auction closing.
  • This replaces the JobScheduler inside the BlockChain.
  • It can be called without permission or signature, and the auction is closed according to the already established procedure.
  • If you call it before the auction end time, you will get an error.
  • If you call for an auction that has already ended, you will get an error.
Path parameters
mrc402idstring · min: 81 · max: 81Required

MRC402 Token ID

Example: MRC400_dd1605be6960d9d6ba7bbeed9da033980_0000000000000000000000000000000000000001
Responses
200
successful operation
*/*
404
MRC400 not found
get
GET /mrc402/auctionfinish/{mrc402id} HTTP/1.1
Host: rest.metacoin.network:20923
Accept: */*
{
  "transaction_id": "text"
}
  • Support mixed assets for NFT.
  • Mixed Assets
  • Copyright Information
  • Burn
  • Mint
  • Transfer
  • Melt
  • Support various media
  • Support Platform
  • Support ShareHolder
  • POSTCreate MRC402 Token
  • GETGET MRC402 Token
  • POSTTransfer ownership of the MRC402 token to another user.
  • POSTSell MRC402 Token
  • POSTMRC402 token sale canceled
  • POSTBuy MRC402 Token
  • POSTMelt MRC402
  • POSTAuction MRC402 Token
  • POSTMRC402 token auction canceled
  • POSTBid MRC402 Token
  • GETFinish MRC402 token auction