Mint a NFT token in Loopring L2

Rate limit: every seconds

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 ""