FIfireblocks
Tokenization

Link a contract

Link an a contract

post/tokenization/tokens/link

Request

Headers

Idempotency-Keystring

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.

Request body

type'FUNGIBLE_TOKEN' | 'NON_FUNGIBLE_TOKEN' | 'TOKEN_UTILITY' | 'TOKEN_EXTENSION' required

The type of token being linked

refIdstring

The Fireblocks' token link reference id. For example, 'BQ5R_BDESC_ABC' if it's a fungible asset

displayNamestring

The token display name

baseAssetIdstring

The blockchain base assetId

contractAddressstring

The contract's onchain address

Example request

{
  "refId": "USDC_ETH_TEST3_1XF5",
  "displayName": "My Simple ERC20 Token",
  "baseAssetId": "ETH_TEST3",
  "contractAddress": "0xC2c4e1Db41F0bB97996D0eD0542D2170d146FB66"
}

Response

Token linked successfully

idstring required

The token link id

status'PENDING' | 'COMPLETED' required

The token status

type'FUNGIBLE_TOKEN' | 'NON_FUNGIBLE_TOKEN' | 'TOKEN_UTILITY' | 'TOKEN_EXTENSION'

The type of token

refIdstring

The Fireblocks' reference id

displayNamestring

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

Example response

{
  "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",
    "type": "ERC20",
    "contractAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "issuerAddress": "rGyXjc5d7s17vvt3NtKKascvJrnSxV21kQ",
    "testnet": true,
    "blockchain": "ETH_TEST5",
    "decimals": 18,
    "vaultAccountId": "0"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.