Skip to main content
POST
/
tokenization
/
tokens
TypeScript
const response: Promise<FireblocksResponse<TokenLinkDto>> = fireblocks.tokenization.issueNewToken(tokenizationApiIssueNewTokenRequest);
{
  "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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://developers.fireblocks.com/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
Idempotency-Key
string

A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours.

Body

application/json
​
vaultAccountId
string
required

The id of the vault account that initiated the request to issue the token

Example:

"0"

​
createParams
object
required
​
blockchainId
string

The id of the blockchain the request was initiated on

Example:

"B7QG017M"

​
assetId
string

The base asset identifier of the blockchain you want to deploy to

Example:

"ETH_TEST5"

​
displayName
string
​
useGasless
boolean

Indicates whether the token should be created in a gasless manner, utilizing the ERC-2771 standard. When set to true, the transaction will be relayed by a designated relayer. The workspace must be configured to use Fireblocks gasless relay.

Example:

false

​
fee
string

Max fee amount for the write function transaction. interchangeable with the 'feeLevel' field

Example:

"2000"

​
feeLevel
enum<string>

Fee level for the write function transaction. interchangeable with the 'fee' field

Available options:
LOW,
MEDIUM,
HIGH
Example:

"MEDIUM"

​
txNote
string

Custom note that describes the transaction at your Fireblocks workspace. This note will be visible in the Fireblocks UI and in the transaction details and not on the blockchain.

Example:

"Token creation transaction for new stablecoin"

​
externalId
string

External id that can be used to identify the transaction in your system. The unique identifier of the transaction outside of Fireblocks with max length of 255 characters

Example:

"0192e4f5-924e-7bb9-8e5b-c748270feb38"

Response

Token was created successfully

​
id
string
required

The token link id

Example:

"fbfbfbfb-fbfb-fbfb-fbfb-fbfbfbfbfbfb"

​
status
enum<string>
required

The token status

Available options:
PENDING,
COMPLETED
Example:

"COMPLETED"

​
type
enum<string>

The type of token

Available options:
FUNGIBLE_TOKEN,
NON_FUNGIBLE_TOKEN,
TOKEN_UTILITY,
TOKEN_EXTENSION
Example:

"NON_FUNGIBLE_TOKEN"

​
refId
string

The Fireblocks' reference id

Example:

"BQ5R_MY_TOKEN"

​
displayName
string

The token display name. If was not provided, would be taken from the contract template

Example:

"My Simple ERC20 Token"

​
tokenMetadata
object

The token's metadata