Mint a NFT token in Loopring L2

Rate limit: 5 every second

API Overview

HTTP method

POST

Path

/api/v3/nft/mint

Summary

Mint a NFT token in Loopring L2

API description

HTTP Header

Field	Type	Required	Description	Example
X-API-KEY	string	Y	ApiKey	"HlkcGxbqBeaF76j4rvPaOasyfPwnkQ 6B6DQ6THZWbvrAGxzEdulXQvOKLrRW ZLnN"

Request parameters

Field	Type	Required	Description	Example
exchange	string	Y	field.SubmitNftMintRequest.exchange	"1"
minterId	integer	Y	minters accountId	1
minterAddress	string	Y	minters address	"0xbbbbca6a90 1c926f240b89 eacb641d8aec 7aeafd"
toAccountId	integer	Y	=The account receive the minted NFT token, now should be minter himself.	1
toAddress	string	N	field.SubmitNftMintRequest.toAddress	"0xbbbbca6a90 1c926f240b89 eacb641d8aec 7aeafd"
nftType	integer	Y	nftType: 0 for EIP1155, 1 for EIP712. EIP1155 by default.	"0:ERC1155,1: ERC721"
tokenAddress	string	Y	field.SubmitNftMintRequest.tokenAddress	"0xbbbbca6a90 1c926f240b89 eacb641d8aec 7aeafd"
nftId	string	Y	NFT_ID	"0xf7c9323511 86c3a9053f31 3eefa16209c0 18f7f1dba8aa 8ca7100400f7 c31085"
amount	string	Y	how many tokens to be mint.	"1"
creatorFeeBips	integer	Y	fee to the creator of each NFT transaction.	0
validUntil	integer	Y	field.SubmitNftMintRequest.validUntil	1567053142
storageId	integer	Y	field.SubmitNftMintRequest.storageId	1
maxFee	Token Amount Info	Y	field.SubmitNftMintRequest.tokenB	"TokenAmount{ tokenId: 0, amount: 1234}"
eddsaSignature	string	N	field.SubmitNftMintRequest.eddsaSignature	"0xccf0a141fc e2dc5cbbd4f8 02c52220e9e2 ce260e86704d 6258603eb346 eefe2d4a4500 05c362b223b2 8402d087f706 5ea5eee03145 31adf6a580fc e64c25dca81c 02"
ecdsaSignature	string	N	field.SubmitNftMintRequest.ecdsaSignature	"0xeb14773e8a 07d19bc4fe56 e36d041dcb00 2652f7e92160 deaf5e6bf21e 05c7a9eb1477 3e8a07d19bc4 fe56e36d041d cb002652f7e9 2160deaf5e6b f21e05c7a9eb 14773e8a07d1 9bc4fe56e36d 041dcb002652 f7e92160deaf 5e6bf21e05c7 a9"
hashApproved	string	N	field.SubmitNftMintRequest.hashApproved	"0xf7c9323511 86c3a9053f31 3eefa16209c0 18f7f1dba8aa 8ca7100400f7 c31085"
forceToMint	boolean	N	force to mint, regardless the previous mint record	"false"
counterFactualNftInfo	Counter Factual NftInfo	N	field.SubmitNftMintRequest.counterFactualNftInfo	"{nftFactory: 0xABCD, nftOwner: 0xABCD, nftBaseUri: }"
royaltyAddress	string	N	field.CounterFactualNftInfo.royaltyAddress	"0xbbbbca6a90 1c926f240b89 eacb641d8aec 7aeafd"

Request example

HTTP

CURL

POST https://api3.loopring.io/api/v3/nft/mint HTTP/1.1
Host: api3.loopring.io
Connection: keep-alive
Accept: */*
Accept-Encoding: gzip, deflate, br
Accept-Language: zh,en;q=0.9
X-API-KEY: sra1aavfa
Content-Type: application/json

{
  "exchange" : "1",
  "minterId" : 1,
  "minterAddress" : "0xbbbbca6a901c926f240b89eacb641d8aec7aeafd",
  "toAccountId" : 1,
  "toAddress" : "0xbbbbca6a901c926f240b89eacb641d8aec7aeafd",
  "nftType" : 0:ERC1155,1:ERC721,
  "tokenAddress" : "0xbbbbca6a901c926f240b89eacb641d8aec7aeafd",
  "nftId" : "0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085",
  "amount" : "1",
  "creatorFeeBips" : 0,
  "validUntil" : 1567053142,
  "storageId" : 1,
  "maxFee" : {
    "tokenId" : 0,
    "amount" : "1"
  },
  "eddsaSignature" : "0xccf0a141fce2dc5cbbd4f802c52220e9e2ce260e86704d6258603eb346eefe2d4a450005c362b223b28402d087f7065ea5eee0314531adf6a580fce64c25dca81c02",
  "ecdsaSignature" : "0xeb14773e8a07d19bc4fe56e36d041dcb002652f7e92160deaf5e6bf21e05c7a9eb14773e8a07d19bc4fe56e36d041dcb002652f7e92160deaf5e6bf21e05c7a9eb14773e8a07d19bc4fe56e36d041dcb002652f7e92160deaf5e6bf21e05c7a9",
  "hashApproved" : "0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085",
  "forceToMint" : false,
  "counterFactualNftInfo" : {
    "nftFactory" : "0xbbbbca6a901c926f240b89eacb641d8aec7aeafd",
    "nftOwner" : "0xbbbbca6a901c926f240b89eacb641d8aec7aeafd",
    "nftBaseUri" : "0xbbbbca6a901c926f240b89eacb641d8aec7aeafd"
  },
  "royaltyAddress" : "0xbbbbca6a901c926f240b89eacb641d8aec7aeafd"
}

curl -X POST -H "X-API-KEY:sra1aavfa" -H "Content-Type:application/json" https://api3.loopring.io/api/v3/nft/mint -d \
'{
  "exchange" : "1",
  "minterId" : 1,
  "minterAddress" : "0xbbbbca6a901c926f240b89eacb641d8aec7aeafd",
  "toAccountId" : 1,
  "toAddress" : "0xbbbbca6a901c926f240b89eacb641d8aec7aeafd",
  "nftType" : 0:ERC1155,1:ERC721,
  "tokenAddress" : "0xbbbbca6a901c926f240b89eacb641d8aec7aeafd",
  "nftId" : "0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085",
  "amount" : "1",
  "creatorFeeBips" : 0,
  "validUntil" : 1567053142,
  "storageId" : 1,
  "maxFee" : {
    "tokenId" : 0,
    "amount" : "1"
  },
  "eddsaSignature" : "0xccf0a141fce2dc5cbbd4f802c52220e9e2ce260e86704d6258603eb346eefe2d4a450005c362b223b28402d087f7065ea5eee0314531adf6a580fce64c25dca81c02",
  "ecdsaSignature" : "0xeb14773e8a07d19bc4fe56e36d041dcb002652f7e92160deaf5e6bf21e05c7a9eb14773e8a07d19bc4fe56e36d041dcb002652f7e92160deaf5e6bf21e05c7a9eb14773e8a07d19bc4fe56e36d041dcb002652f7e92160deaf5e6bf21e05c7a9",
  "hashApproved" : "0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085",
  "forceToMint" : false,
  "counterFactualNftInfo" : {
    "nftFactory" : "0xbbbbca6a901c926f240b89eacb641d8aec7aeafd",
    "nftOwner" : "0xbbbbca6a901c926f240b89eacb641d8aec7aeafd",
    "nftBaseUri" : "0xbbbbca6a901c926f240b89eacb641d8aec7aeafd"
  },
  "royaltyAddress" : "0xbbbbca6a901c926f240b89eacb641d8aec7aeafd"
}'

Response fields

Field	Type	Required	Description	Example
hash	string	Y	Mint request hash.	"133754509012 921794171549 748495717930 699115173547 203971250276 332426804700 75859"
nftTokenId	integer	Y	field.SubmitMintNftResponseItem.nftTokenId	32768
nftData	string	Y	Mint tokens nftData.	"0xf7c9323511 86c3a9053f31 3eefa16209c0 18f7f1dba8aa 8ca7100400f7 c31085"
status	string	Y	Mint status. Allowable : ['processing', 'processed', 'cancelling', 'cancelled', 'expired', 'failed']	"cancelled"
isIdempotent	boolean	Y	Idempotent of submit order response. True if the same request is sent more than once. Allowable : [True, False]	"false"

Response example

{
  "hash" : "13375450901292179417154974849571793069911517354720397125027633242680470075859",
  "nftTokenId" : 32768,
  "nftData" : "0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085",
  "status" : "cancelled",
  "isIdempotent" : false
}

Status code

Value	Description
100000	Unknown error
100001	Invalid argument
102001	Exchange ID is incorrect
102021	Nonce is invalid
102022	Transfer sender is invalid
102023	Transfer receiver is invalid
102024	Fee token is unsupported
102025	Transfer token isnt consistent with fee token
108003	code.108003

Model

TokenAmountInfo

Wrapper object used to describe a token associated with a certain quantity.

Field	Type	Required	Description	Example
tokenId	integer	Y	The Loopring's NFT token identifier.	0
amount	string	Y	The amount of the NFT token	"1"

CounterFactualNftInfo

Field	Type	Required	Description	Example
nftFactory	string	Y	field.CounterFactualNftInfo.nftFactory	"0xbbbbca6a90 1c926f240b89 eacb641d8aec 7aeafd"
nftOwner	string	Y	field.CounterFactualNftInfo.nftOwner	"0xbbbbca6a90 1c926f240b89 eacb641d8aec 7aeafd"
nftBaseUri	string	N	field.CounterFactualNftInfo.nftBaseUri	"0xbbbbca6a90 1c926f240b89 eacb641d8aec 7aeafd"

results matching ""

No results matching ""