Token Editions
A token Edition is a single token. If you want you can set a edition from one of your collections to be minted. Here you are also able to transfer a token if you are its owner to another wallet. Note that this operation also uses gas and can be estimated beforehand.
Retry a bulk mint by collection
PATCH /{companyId}/token-editions/retry-bulk-by-collection HTTP/1.1
Host:
x-w3block-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 16
{
"jobId": "text"
}
No content
List token editions
List all tokens
2022-01-30T10:30:40-03:00
1
Example: 1
10
Example: 10
GET /{companyId}/token-editions HTTP/1.1
Host:
x-w3block-api-key: YOUR_API_KEY
Accept: */*
{
"meta": {
"itemCount": 1,
"totalItems": 1,
"itemsPerPage": 1,
"totalPages": 1,
"currentPage": 1
},
"links": {
"first": "http://example.com?page=1",
"prev": "http://example.com?page=1",
"next": "http://example.com?page=2",
"last": "http://example.com?page=3"
},
"items": [
{
"id": "text",
"companyId": "text",
"editionNumber": 1,
"tokenCollection": {
"id": "text",
"companyId": "text",
"deletedAt": "2025-07-03T03:52:58.242Z",
"createdAt": "2025-07-03T03:52:58.242Z",
"updatedAt": "2025-07-03T03:52:58.242Z",
"status": "draft",
"contractId": "text",
"subcategoryId": "text",
"name": "text",
"description": "text",
"mainImage": "text",
"tokenData": {},
"publishedTokenTemplate": {
"prop1": {
"type": "SELECT",
"config": {
"required": {},
"label": "text",
"tooltip": "text",
"placeholder": "text",
"order": 1,
"childrenType": "SELECT",
"range": {
"min": 1,
"max": 1
},
"options": [
"text"
],
"float": true
},
"children": {}
},
"prop2": {
"type": "SELECT",
"config": {
"required": {},
"label": "text",
"tooltip": "text",
"placeholder": "text",
"order": 1,
"childrenType": "SELECT",
"range": {
"min": 1,
"max": 1
},
"options": [
"text"
],
"float": true
},
"children": {}
}
},
"quantity": 1,
"initialQuantityToMint": 1,
"initialQuantity": 1,
"rangeInitialToMint": "text",
"quantityMinted": 1,
"rfids": [
"text"
],
"ownerAddress": "text",
"pass": true,
"similarTokens": true,
"settings": {
"sendWebhookWhenTokenEditionIsUpdated": true
}
},
"contractId": "text",
"contract": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"companyId": "123e4567-e89b-12d3-a456-426614174000",
"royaltyId": "123e4567-e89b-12d3-a456-426614174000",
"address": "text",
"chainId": 1,
"name": "text",
"symbol": "text",
"description": "text",
"image": "text",
"externalLink": "text",
"operators": [
"text"
],
"roles": [
[]
],
"status": "draft",
"contractActionId": "text",
"features": [
"admin:minter"
],
"deletedAt": "2025-07-03T03:52:58.242Z",
"createdAt": "2025-07-03T03:52:58.242Z",
"updatedAt": "2025-07-03T03:52:58.242Z",
"transferWhitelistId": "123e4567-e89b-12d3-a456-426614174000",
"minterWhitelistId": "123e4567-e89b-12d3-a456-426614174000",
"maxSupply": 1
},
"tokenCollectionId": "text",
"rfid": "text",
"status": "draft",
"contractAddress": "text",
"ownerAddress": "text",
"chainId": 1,
"tokenId": 1,
"mintedHash": "text",
"mintedAt": "2025-07-03T03:52:58.242Z",
"nftMinting": {
"id": "text",
"companyId": "text",
"contractId": "text",
"contractAddress": "text",
"ownerAddress": "text",
"sender": "text",
"chainId": 1,
"startEdition": 1,
"endEdition": 1,
"batchNumber": 1,
"status": "created",
"txHash": "text",
"txId": "text",
"mintedAt": "2025-07-03T03:52:58.242Z",
"metadata": {},
"nfts": [
[]
],
"createdAt": "2025-07-03T03:52:58.242Z",
"updatedAt": "2025-07-03T03:52:58.242Z"
},
"nftMintingId": "text",
"name": "text",
"description": "text",
"mainImage": "text",
"tokenData": {},
"rawData": {},
"deletedAt": "2025-07-03T03:52:58.242Z",
"createdAt": "2025-07-03T03:52:58.242Z",
"updatedAt": "2025-07-03T03:52:58.242Z",
"mintedAddress": "text"
}
]
}
GET /{companyId}/token-editions/check-rfid?rfid=text HTTP/1.1
Host:
x-w3block-api-key: YOUR_API_KEY
Accept: */*
{
"used": true
}
Make a bulk of tokens ready to mint
Change status to ready to mint
Array of token ids
PATCH /{companyId}/token-editions/ready-to-mint HTTP/1.1
Host:
x-w3block-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 16
{
"editionId": []
}
No content
Make a single token ready to mint
Change status to ready to mint by token
PATCH /{companyId}/token-editions/{id}/ready-to-mint HTTP/1.1
Host:
x-w3block-api-key: YOUR_API_KEY
Accept: */*
{
"id": "text",
"companyId": "text",
"editionNumber": 1,
"tokenCollection": {
"id": "text",
"companyId": "text",
"deletedAt": "2025-07-03T03:52:58.242Z",
"createdAt": "2025-07-03T03:52:58.242Z",
"updatedAt": "2025-07-03T03:52:58.242Z",
"status": "draft",
"contractId": "text",
"subcategoryId": "text",
"name": "text",
"description": "text",
"mainImage": "text",
"tokenData": {},
"publishedTokenTemplate": {
"prop1": {
"type": "SELECT",
"config": {
"required": {},
"label": "text",
"tooltip": "text",
"placeholder": "text",
"order": 1,
"childrenType": "SELECT",
"range": {
"min": 1,
"max": 1
},
"options": [
"text"
],
"float": true
},
"children": {}
},
"prop2": {
"type": "SELECT",
"config": {
"required": {},
"label": "text",
"tooltip": "text",
"placeholder": "text",
"order": 1,
"childrenType": "SELECT",
"range": {
"min": 1,
"max": 1
},
"options": [
"text"
],
"float": true
},
"children": {}
}
},
"quantity": 1,
"initialQuantityToMint": 1,
"initialQuantity": 1,
"rangeInitialToMint": "text",
"quantityMinted": 1,
"rfids": [
"text"
],
"ownerAddress": "text",
"pass": true,
"similarTokens": true,
"settings": {
"sendWebhookWhenTokenEditionIsUpdated": true
}
},
"contractId": "text",
"contract": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"companyId": "123e4567-e89b-12d3-a456-426614174000",
"royaltyId": "123e4567-e89b-12d3-a456-426614174000",
"address": "text",
"chainId": 1,
"name": "text",
"symbol": "text",
"description": "text",
"image": "text",
"externalLink": "text",
"operators": [
"text"
],
"roles": [
[]
],
"status": "draft",
"contractActionId": "text",
"features": [
"admin:minter"
],
"deletedAt": "2025-07-03T03:52:58.242Z",
"createdAt": "2025-07-03T03:52:58.242Z",
"updatedAt": "2025-07-03T03:52:58.242Z",
"transferWhitelistId": "123e4567-e89b-12d3-a456-426614174000",
"minterWhitelistId": "123e4567-e89b-12d3-a456-426614174000",
"maxSupply": 1
},
"tokenCollectionId": "text",
"rfid": "text",
"status": "draft",
"contractAddress": "text",
"ownerAddress": "text",
"chainId": 1,
"tokenId": 1,
"mintedHash": "text",
"mintedAt": "2025-07-03T03:52:58.242Z",
"nftMinting": {
"id": "text",
"companyId": "text",
"contractId": "text",
"contractAddress": "text",
"ownerAddress": "text",
"sender": "text",
"chainId": 1,
"startEdition": 1,
"endEdition": 1,
"batchNumber": 1,
"status": "created",
"txHash": "text",
"txId": "text",
"mintedAt": "2025-07-03T03:52:58.242Z",
"metadata": {},
"nfts": [
[]
],
"createdAt": "2025-07-03T03:52:58.242Z",
"updatedAt": "2025-07-03T03:52:58.242Z"
},
"nftMintingId": "text",
"name": "text",
"description": "text",
"mainImage": "text",
"tokenData": {},
"rawData": {},
"deletedAt": "2025-07-03T03:52:58.242Z",
"createdAt": "2025-07-03T03:52:58.242Z",
"updatedAt": "2025-07-03T03:52:58.242Z"
}
Estimate mint gas
Estimate gas to mint tokens
quantity of token to mint
1
GET /{companyId}/token-editions/{id}/estimate-gas/mint?quantityToMint=1 HTTP/1.1
Host:
x-w3block-api-key: YOUR_API_KEY
Accept: */*
{
"totalGas": 1,
"totalGasPrice": {
"safe": "text",
"proposed": "text",
"fast": "text"
}
}
Burn a token edition
Burn token
DELETE /{companyId}/token-editions/burn HTTP/1.1
Host:
x-w3block-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 19
{
"tokens": [
"text"
]
}
No content
Estimate gas to burn a token
Estimate gas to burn
GET /{companyId}/token-editions/{id}/estimate-gas/burn HTTP/1.1
Host:
x-w3block-api-key: YOUR_API_KEY
Accept: */*
{
"totalGas": 1,
"totalGasPrice": {
"safe": "text",
"proposed": "text",
"fast": "text"
}
}
Change rfid by id
zf4pg538qx
PATCH /{companyId}/token-editions/{id}/rfid HTTP/1.1
Host:
x-w3block-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 21
{
"rfid": "zf4pg538qx"
}
{
"id": "text",
"companyId": "text",
"editionNumber": 1,
"tokenCollection": {
"id": "text",
"companyId": "text",
"deletedAt": "2025-07-03T03:52:58.242Z",
"createdAt": "2025-07-03T03:52:58.242Z",
"updatedAt": "2025-07-03T03:52:58.242Z",
"status": "draft",
"contractId": "text",
"subcategoryId": "text",
"name": "text",
"description": "text",
"mainImage": "text",
"tokenData": {},
"publishedTokenTemplate": {
"prop1": {
"type": "SELECT",
"config": {
"required": {},
"label": "text",
"tooltip": "text",
"placeholder": "text",
"order": 1,
"childrenType": "SELECT",
"range": {
"min": 1,
"max": 1
},
"options": [
"text"
],
"float": true
},
"children": {}
},
"prop2": {
"type": "SELECT",
"config": {
"required": {},
"label": "text",
"tooltip": "text",
"placeholder": "text",
"order": 1,
"childrenType": "SELECT",
"range": {
"min": 1,
"max": 1
},
"options": [
"text"
],
"float": true
},
"children": {}
}
},
"quantity": 1,
"initialQuantityToMint": 1,
"initialQuantity": 1,
"rangeInitialToMint": "text",
"quantityMinted": 1,
"rfids": [
"text"
],
"ownerAddress": "text",
"pass": true,
"similarTokens": true,
"settings": {
"sendWebhookWhenTokenEditionIsUpdated": true
}
},
"contractId": "text",
"contract": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"companyId": "123e4567-e89b-12d3-a456-426614174000",
"royaltyId": "123e4567-e89b-12d3-a456-426614174000",
"address": "text",
"chainId": 1,
"name": "text",
"symbol": "text",
"description": "text",
"image": "text",
"externalLink": "text",
"operators": [
"text"
],
"roles": [
[]
],
"status": "draft",
"contractActionId": "text",
"features": [
"admin:minter"
],
"deletedAt": "2025-07-03T03:52:58.242Z",
"createdAt": "2025-07-03T03:52:58.242Z",
"updatedAt": "2025-07-03T03:52:58.242Z",
"transferWhitelistId": "123e4567-e89b-12d3-a456-426614174000",
"minterWhitelistId": "123e4567-e89b-12d3-a456-426614174000",
"maxSupply": 1
},
"tokenCollectionId": "text",
"rfid": "text",
"status": "draft",
"contractAddress": "text",
"ownerAddress": "text",
"chainId": 1,
"tokenId": 1,
"mintedHash": "text",
"mintedAt": "2025-07-03T03:52:58.242Z",
"nftMinting": {
"id": "text",
"companyId": "text",
"contractId": "text",
"contractAddress": "text",
"ownerAddress": "text",
"sender": "text",
"chainId": 1,
"startEdition": 1,
"endEdition": 1,
"batchNumber": 1,
"status": "created",
"txHash": "text",
"txId": "text",
"mintedAt": "2025-07-03T03:52:58.242Z",
"metadata": {},
"nfts": [
[]
],
"createdAt": "2025-07-03T03:52:58.242Z",
"updatedAt": "2025-07-03T03:52:58.242Z"
},
"nftMintingId": "text",
"name": "text",
"description": "text",
"mainImage": "text",
"tokenData": {},
"rawData": {},
"deletedAt": "2025-07-03T03:52:58.242Z",
"createdAt": "2025-07-03T03:52:58.242Z",
"updatedAt": "2025-07-03T03:52:58.242Z"
}
Get a token by id
GET /{companyId}/token-editions/{id} HTTP/1.1
Host:
x-w3block-api-key: YOUR_API_KEY
Accept: */*
{
"id": "text",
"companyId": "text",
"editionNumber": 1,
"tokenCollection": {
"id": "text",
"companyId": "text",
"deletedAt": "2025-07-03T03:52:58.242Z",
"createdAt": "2025-07-03T03:52:58.242Z",
"updatedAt": "2025-07-03T03:52:58.242Z",
"status": "draft",
"contractId": "text",
"subcategoryId": "text",
"name": "text",
"description": "text",
"mainImage": "text",
"tokenData": {},
"publishedTokenTemplate": {
"prop1": {
"type": "SELECT",
"config": {
"required": {},
"label": "text",
"tooltip": "text",
"placeholder": "text",
"order": 1,
"childrenType": "SELECT",
"range": {
"min": 1,
"max": 1
},
"options": [
"text"
],
"float": true
},
"children": {}
},
"prop2": {
"type": "SELECT",
"config": {
"required": {},
"label": "text",
"tooltip": "text",
"placeholder": "text",
"order": 1,
"childrenType": "SELECT",
"range": {
"min": 1,
"max": 1
},
"options": [
"text"
],
"float": true
},
"children": {}
}
},
"quantity": 1,
"initialQuantityToMint": 1,
"initialQuantity": 1,
"rangeInitialToMint": "text",
"quantityMinted": 1,
"rfids": [
"text"
],
"ownerAddress": "text",
"pass": true,
"similarTokens": true,
"settings": {
"sendWebhookWhenTokenEditionIsUpdated": true
}
},
"contractId": "text",
"contract": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"companyId": "123e4567-e89b-12d3-a456-426614174000",
"royaltyId": "123e4567-e89b-12d3-a456-426614174000",
"address": "text",
"chainId": 1,
"name": "text",
"symbol": "text",
"description": "text",
"image": "text",
"externalLink": "text",
"operators": [
"text"
],
"roles": [
[]
],
"status": "draft",
"contractActionId": "text",
"features": [
"admin:minter"
],
"deletedAt": "2025-07-03T03:52:58.242Z",
"createdAt": "2025-07-03T03:52:58.242Z",
"updatedAt": "2025-07-03T03:52:58.242Z",
"transferWhitelistId": "123e4567-e89b-12d3-a456-426614174000",
"minterWhitelistId": "123e4567-e89b-12d3-a456-426614174000",
"maxSupply": 1
},
"tokenCollectionId": "text",
"rfid": "text",
"status": "draft",
"contractAddress": "text",
"ownerAddress": "text",
"chainId": 1,
"tokenId": 1,
"mintedHash": "text",
"mintedAt": "2025-07-03T03:52:58.242Z",
"nftMinting": {
"id": "text",
"companyId": "text",
"contractId": "text",
"contractAddress": "text",
"ownerAddress": "text",
"sender": "text",
"chainId": 1,
"startEdition": 1,
"endEdition": 1,
"batchNumber": 1,
"status": "created",
"txHash": "text",
"txId": "text",
"mintedAt": "2025-07-03T03:52:58.242Z",
"metadata": {},
"nfts": [
[]
],
"createdAt": "2025-07-03T03:52:58.242Z",
"updatedAt": "2025-07-03T03:52:58.242Z"
},
"nftMintingId": "text",
"name": "text",
"description": "text",
"mainImage": "text",
"tokenData": {},
"rawData": {},
"deletedAt": "2025-07-03T03:52:58.242Z",
"createdAt": "2025-07-03T03:52:58.242Z",
"updatedAt": "2025-07-03T03:52:58.242Z",
"mintedAddress": "text"
}
Transfer token
Array of token ids
PATCH /{companyId}/token-editions/transfer-token HTTP/1.1
Host:
x-w3block-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 35
{
"toAddress": "text",
"editionId": []
}
Need user with one of these roles: superAdmin, admin
No content
Estimate gas to transfer token
GET /{companyId}/token-editions/{id}/estimate-gas/transfer?toAddress=text HTTP/1.1
Host:
x-w3block-api-key: YOUR_API_KEY
Accept: */*
{
"totalGas": 1,
"totalGasPrice": {
"safe": "text",
"proposed": "text",
"fast": "text"
}
}
PATCH /{companyId}/token-editions/{id}/transfer-token HTTP/1.1
Host:
x-w3block-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 20
{
"toAddress": "text"
}
No content
Get last transfer or burn transaction
GET /{companyId}/token-editions/{id}/get-last/{type} HTTP/1.1
Host:
x-w3block-api-key: YOUR_API_KEY
Accept: */*
{
"toAddress": "text",
"sender": "text",
"status": "created",
"txHash": "text",
"chainId": 80001,
"metadata": {
"status": "text",
"message": "text"
}
}
["0x82dbB0A14F79f50c8f8e0D50FC9F1ef30Aeb6C79","0x39926ceceb3cc78ab2cced96f217df3e7bed48c1"]
PATCH /tokens/check-collection-token-holder HTTP/1.1
Host:
x-w3block-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 401
{
"walletAddresses": [
"0x82dbB0A14F79f50c8f8e0D50FC9F1ef30Aeb6C79",
"0x39926ceceb3cc78ab2cced96f217df3e7bed48c1"
],
"collections": [
{
"contractAddress": "0x389dd295657a6fb2336aa33e40aeb8fb81f97fe4",
"chainId": 80001,
"startTokenId": 1,
"endTokenId": 100,
"metadataRequirements": [
[]
],
"collectionId": "123e4567-e89b-12d3-a456-426614174000",
"erc20ContractId": "123e4567-e89b-12d3-a456-426614174000",
"requiredAmount": 10
}
]
}
Need user with one of these roles: superAdmin, admin
No content
Last updated