Issue a new token
Facilitates the creation of a new token, supporting both EVM-based and Stellar/Ripple platforms. For EVM, it deploys the corresponding contract template to the blockchain and links the token to the workspace. For Stellar/Ripple, it links a newly created token directly to the workspace without deploying a contract. Returns the token link with status “PENDING” until the token is deployed or “SUCCESS” if no deployment is needed. Endpoint Permission: Owner, Admin, Non-Signing Admin, Signer, and Editor.
POST
/
tokenization
/
tokens
TypeScript
const response: Promise<FireblocksResponse<TokenLinkDto>> = fireblocks.tokenization.issueNewToken(tokenizationApiIssueNewTokenRequest);CompletableFuture<ApiResponse<TokenLinkDto>> response = fireblocks.tokenization().issueNewToken(createTokenRequestDto, idempotencyKey);response = fireblocks.tokenization.issue_new_token(create_token_request_dto, idempotency_key);curl --request POST \
--url https://api.fireblocks.io/v1/tokenization/tokens \
--header 'Content-Type: application/json' \
--data '
{
"vaultAccountId": "0",
"createParams": {
"contractId": "b70701f4-d7b1-4795-a8ee-b09cdb5b850d",
"deployFunctionParams": [
{
"internalType": "string",
"name": "name",
"type": "string",
"value": "name"
},
{
"internalType": "string",
"name": "symbol",
"type": "string",
"value": "symbol"
},
{
"components": [
{
"internalType": "bool",
"name": "_isMintable",
"type": "bool"
}
],
"internalType": "struct MyStruct",
"name": "customConfigProps",
"type": "tuple",
"value": [
{
"internalType": "bool",
"name": "_isMintable",
"type": "bool",
"value": false
}
]
}
]
},
"blockchainId": "B7QG017M",
"assetId": "ETH_TEST5",
"displayName": "<string>",
"useGasless": false,
"fee": "2000",
"feeLevel": "MEDIUM",
"txNote": "Token creation transaction for new stablecoin",
"externalId": "0192e4f5-924e-7bb9-8e5b-c748270feb38"
}
'const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
vaultAccountId: '0',
createParams: {
contractId: 'b70701f4-d7b1-4795-a8ee-b09cdb5b850d',
deployFunctionParams: [
{internalType: 'string', name: 'name', type: 'string', value: 'name'},
{internalType: 'string', name: 'symbol', type: 'string', value: 'symbol'},
{
components: [{internalType: 'bool', name: '_isMintable', type: 'bool'}],
internalType: 'struct MyStruct',
name: 'customConfigProps',
type: 'tuple',
value: [{internalType: 'bool', name: '_isMintable', type: 'bool', value: false}]
}
]
},
blockchainId: 'B7QG017M',
assetId: 'ETH_TEST5',
displayName: '<string>',
useGasless: false,
fee: '2000',
feeLevel: 'MEDIUM',
txNote: 'Token creation transaction for new stablecoin',
externalId: '0192e4f5-924e-7bb9-8e5b-c748270feb38'
})
};
fetch('https://api.fireblocks.io/v1/tokenization/tokens', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fireblocks.io/v1/tokenization/tokens",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'vaultAccountId' => '0',
'createParams' => [
'contractId' => 'b70701f4-d7b1-4795-a8ee-b09cdb5b850d',
'deployFunctionParams' => [
[
'internalType' => 'string',
'name' => 'name',
'type' => 'string',
'value' => 'name'
],
[
'internalType' => 'string',
'name' => 'symbol',
'type' => 'string',
'value' => 'symbol'
],
[
'components' => [
[
'internalType' => 'bool',
'name' => '_isMintable',
'type' => 'bool'
]
],
'internalType' => 'struct MyStruct',
'name' => 'customConfigProps',
'type' => 'tuple',
'value' => [
[
'internalType' => 'bool',
'name' => '_isMintable',
'type' => 'bool',
'value' => false
]
]
]
]
],
'blockchainId' => 'B7QG017M',
'assetId' => 'ETH_TEST5',
'displayName' => '<string>',
'useGasless' => false,
'fee' => '2000',
'feeLevel' => 'MEDIUM',
'txNote' => 'Token creation transaction for new stablecoin',
'externalId' => '0192e4f5-924e-7bb9-8e5b-c748270feb38'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fireblocks.io/v1/tokenization/tokens"
payload := strings.NewReader("{\n \"vaultAccountId\": \"0\",\n \"createParams\": {\n \"contractId\": \"b70701f4-d7b1-4795-a8ee-b09cdb5b850d\",\n \"deployFunctionParams\": [\n {\n \"internalType\": \"string\",\n \"name\": \"name\",\n \"type\": \"string\",\n \"value\": \"name\"\n },\n {\n \"internalType\": \"string\",\n \"name\": \"symbol\",\n \"type\": \"string\",\n \"value\": \"symbol\"\n },\n {\n \"components\": [\n {\n \"internalType\": \"bool\",\n \"name\": \"_isMintable\",\n \"type\": \"bool\"\n }\n ],\n \"internalType\": \"struct MyStruct\",\n \"name\": \"customConfigProps\",\n \"type\": \"tuple\",\n \"value\": [\n {\n \"internalType\": \"bool\",\n \"name\": \"_isMintable\",\n \"type\": \"bool\",\n \"value\": false\n }\n ]\n }\n ]\n },\n \"blockchainId\": \"B7QG017M\",\n \"assetId\": \"ETH_TEST5\",\n \"displayName\": \"<string>\",\n \"useGasless\": false,\n \"fee\": \"2000\",\n \"feeLevel\": \"MEDIUM\",\n \"txNote\": \"Token creation transaction for new stablecoin\",\n \"externalId\": \"0192e4f5-924e-7bb9-8e5b-c748270feb38\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}require 'uri'
require 'net/http'
url = URI("https://api.fireblocks.io/v1/tokenization/tokens")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"vaultAccountId\": \"0\",\n \"createParams\": {\n \"contractId\": \"b70701f4-d7b1-4795-a8ee-b09cdb5b850d\",\n \"deployFunctionParams\": [\n {\n \"internalType\": \"string\",\n \"name\": \"name\",\n \"type\": \"string\",\n \"value\": \"name\"\n },\n {\n \"internalType\": \"string\",\n \"name\": \"symbol\",\n \"type\": \"string\",\n \"value\": \"symbol\"\n },\n {\n \"components\": [\n {\n \"internalType\": \"bool\",\n \"name\": \"_isMintable\",\n \"type\": \"bool\"\n }\n ],\n \"internalType\": \"struct MyStruct\",\n \"name\": \"customConfigProps\",\n \"type\": \"tuple\",\n \"value\": [\n {\n \"internalType\": \"bool\",\n \"name\": \"_isMintable\",\n \"type\": \"bool\",\n \"value\": false\n }\n ]\n }\n ]\n },\n \"blockchainId\": \"B7QG017M\",\n \"assetId\": \"ETH_TEST5\",\n \"displayName\": \"<string>\",\n \"useGasless\": false,\n \"fee\": \"2000\",\n \"feeLevel\": \"MEDIUM\",\n \"txNote\": \"Token creation transaction for new stablecoin\",\n \"externalId\": \"0192e4f5-924e-7bb9-8e5b-c748270feb38\"\n}"
response = http.request(request)
puts response.read_body{
"id": "fbfbfbfb-fbfb-fbfb-fbfb-fbfbfbfbfbfb",
"status": "COMPLETED",
"type": "NON_FUNGIBLE_TOKEN",
"refId": "BQ5R_MY_TOKEN",
"displayName": "My Simple ERC20 Token",
"tokenMetadata": {
"assetId": "BQ5R_MY_TOKEN",
"name": "MyToken",
"symbol": "MYT",
"networkProtocol": "ETH",
"totalSupply": "1000000000000000",
"holdersCount": "6",
"type": "ERC20",
"contractAddress": "0x1234567890abcdef1234567890abcdef12345678",
"issuerAddress": "rGyXjc5d7s17vvt3NtKKascvJrnSxV21kQ",
"testnet": true,
"blockchain": "ETH_TEST5",
"decimals": 18,
"vaultAccountId": "0"
}
}{
"statusCode": 409,
"message": "<string>",
"error": "Conflict"
}Headers
Body
application/json
Response
Token was created successfully
Was this page helpful?
⌘I
TypeScript
const response: Promise<FireblocksResponse<TokenLinkDto>> = fireblocks.tokenization.issueNewToken(tokenizationApiIssueNewTokenRequest);CompletableFuture<ApiResponse<TokenLinkDto>> response = fireblocks.tokenization().issueNewToken(createTokenRequestDto, idempotencyKey);response = fireblocks.tokenization.issue_new_token(create_token_request_dto, idempotency_key);curl --request POST \
--url https://api.fireblocks.io/v1/tokenization/tokens \
--header 'Content-Type: application/json' \
--data '
{
"vaultAccountId": "0",
"createParams": {
"contractId": "b70701f4-d7b1-4795-a8ee-b09cdb5b850d",
"deployFunctionParams": [
{
"internalType": "string",
"name": "name",
"type": "string",
"value": "name"
},
{
"internalType": "string",
"name": "symbol",
"type": "string",
"value": "symbol"
},
{
"components": [
{
"internalType": "bool",
"name": "_isMintable",
"type": "bool"
}
],
"internalType": "struct MyStruct",
"name": "customConfigProps",
"type": "tuple",
"value": [
{
"internalType": "bool",
"name": "_isMintable",
"type": "bool",
"value": false
}
]
}
]
},
"blockchainId": "B7QG017M",
"assetId": "ETH_TEST5",
"displayName": "<string>",
"useGasless": false,
"fee": "2000",
"feeLevel": "MEDIUM",
"txNote": "Token creation transaction for new stablecoin",
"externalId": "0192e4f5-924e-7bb9-8e5b-c748270feb38"
}
'const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
vaultAccountId: '0',
createParams: {
contractId: 'b70701f4-d7b1-4795-a8ee-b09cdb5b850d',
deployFunctionParams: [
{internalType: 'string', name: 'name', type: 'string', value: 'name'},
{internalType: 'string', name: 'symbol', type: 'string', value: 'symbol'},
{
components: [{internalType: 'bool', name: '_isMintable', type: 'bool'}],
internalType: 'struct MyStruct',
name: 'customConfigProps',
type: 'tuple',
value: [{internalType: 'bool', name: '_isMintable', type: 'bool', value: false}]
}
]
},
blockchainId: 'B7QG017M',
assetId: 'ETH_TEST5',
displayName: '<string>',
useGasless: false,
fee: '2000',
feeLevel: 'MEDIUM',
txNote: 'Token creation transaction for new stablecoin',
externalId: '0192e4f5-924e-7bb9-8e5b-c748270feb38'
})
};
fetch('https://api.fireblocks.io/v1/tokenization/tokens', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fireblocks.io/v1/tokenization/tokens",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'vaultAccountId' => '0',
'createParams' => [
'contractId' => 'b70701f4-d7b1-4795-a8ee-b09cdb5b850d',
'deployFunctionParams' => [
[
'internalType' => 'string',
'name' => 'name',
'type' => 'string',
'value' => 'name'
],
[
'internalType' => 'string',
'name' => 'symbol',
'type' => 'string',
'value' => 'symbol'
],
[
'components' => [
[
'internalType' => 'bool',
'name' => '_isMintable',
'type' => 'bool'
]
],
'internalType' => 'struct MyStruct',
'name' => 'customConfigProps',
'type' => 'tuple',
'value' => [
[
'internalType' => 'bool',
'name' => '_isMintable',
'type' => 'bool',
'value' => false
]
]
]
]
],
'blockchainId' => 'B7QG017M',
'assetId' => 'ETH_TEST5',
'displayName' => '<string>',
'useGasless' => false,
'fee' => '2000',
'feeLevel' => 'MEDIUM',
'txNote' => 'Token creation transaction for new stablecoin',
'externalId' => '0192e4f5-924e-7bb9-8e5b-c748270feb38'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fireblocks.io/v1/tokenization/tokens"
payload := strings.NewReader("{\n \"vaultAccountId\": \"0\",\n \"createParams\": {\n \"contractId\": \"b70701f4-d7b1-4795-a8ee-b09cdb5b850d\",\n \"deployFunctionParams\": [\n {\n \"internalType\": \"string\",\n \"name\": \"name\",\n \"type\": \"string\",\n \"value\": \"name\"\n },\n {\n \"internalType\": \"string\",\n \"name\": \"symbol\",\n \"type\": \"string\",\n \"value\": \"symbol\"\n },\n {\n \"components\": [\n {\n \"internalType\": \"bool\",\n \"name\": \"_isMintable\",\n \"type\": \"bool\"\n }\n ],\n \"internalType\": \"struct MyStruct\",\n \"name\": \"customConfigProps\",\n \"type\": \"tuple\",\n \"value\": [\n {\n \"internalType\": \"bool\",\n \"name\": \"_isMintable\",\n \"type\": \"bool\",\n \"value\": false\n }\n ]\n }\n ]\n },\n \"blockchainId\": \"B7QG017M\",\n \"assetId\": \"ETH_TEST5\",\n \"displayName\": \"<string>\",\n \"useGasless\": false,\n \"fee\": \"2000\",\n \"feeLevel\": \"MEDIUM\",\n \"txNote\": \"Token creation transaction for new stablecoin\",\n \"externalId\": \"0192e4f5-924e-7bb9-8e5b-c748270feb38\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}require 'uri'
require 'net/http'
url = URI("https://api.fireblocks.io/v1/tokenization/tokens")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"vaultAccountId\": \"0\",\n \"createParams\": {\n \"contractId\": \"b70701f4-d7b1-4795-a8ee-b09cdb5b850d\",\n \"deployFunctionParams\": [\n {\n \"internalType\": \"string\",\n \"name\": \"name\",\n \"type\": \"string\",\n \"value\": \"name\"\n },\n {\n \"internalType\": \"string\",\n \"name\": \"symbol\",\n \"type\": \"string\",\n \"value\": \"symbol\"\n },\n {\n \"components\": [\n {\n \"internalType\": \"bool\",\n \"name\": \"_isMintable\",\n \"type\": \"bool\"\n }\n ],\n \"internalType\": \"struct MyStruct\",\n \"name\": \"customConfigProps\",\n \"type\": \"tuple\",\n \"value\": [\n {\n \"internalType\": \"bool\",\n \"name\": \"_isMintable\",\n \"type\": \"bool\",\n \"value\": false\n }\n ]\n }\n ]\n },\n \"blockchainId\": \"B7QG017M\",\n \"assetId\": \"ETH_TEST5\",\n \"displayName\": \"<string>\",\n \"useGasless\": false,\n \"fee\": \"2000\",\n \"feeLevel\": \"MEDIUM\",\n \"txNote\": \"Token creation transaction for new stablecoin\",\n \"externalId\": \"0192e4f5-924e-7bb9-8e5b-c748270feb38\"\n}"
response = http.request(request)
puts response.read_body{
"id": "fbfbfbfb-fbfb-fbfb-fbfb-fbfbfbfbfbfb",
"status": "COMPLETED",
"type": "NON_FUNGIBLE_TOKEN",
"refId": "BQ5R_MY_TOKEN",
"displayName": "My Simple ERC20 Token",
"tokenMetadata": {
"assetId": "BQ5R_MY_TOKEN",
"name": "MyToken",
"symbol": "MYT",
"networkProtocol": "ETH",
"totalSupply": "1000000000000000",
"holdersCount": "6",
"type": "ERC20",
"contractAddress": "0x1234567890abcdef1234567890abcdef12345678",
"issuerAddress": "rGyXjc5d7s17vvt3NtKKascvJrnSxV21kQ",
"testnet": true,
"blockchain": "ETH_TEST5",
"decimals": 18,
"vaultAccountId": "0"
}
}{
"statusCode": 409,
"message": "<string>",
"error": "Conflict"
}