---
title: "Register an asset"
method: POST
path: "/assets"
tags: ["Blockchains & assets"]
---

# Register an asset

`POST /assets`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/assets`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/assets/post.ts> (a function with typed inputs; its response is checked against the schema)

Register a new asset to a workspace and return the newly created asset's details. Currently supported chains are:
- EVM based chains
- Stellar
- Algorand
- TRON
- NEAR
- Solana
- Sui
- TON

## Headers

- `Idempotency-Key` string

## Request body

- RegisterNewAssetRequest
  - `blockchainId` string, required: Native asset ID of the blockchain
  - `address` string, required: Asset address. - EVM-based chains: token contract address - Stellar (XLM): issuer address - Algorand (ALGO): asset ID - TRON (TRX): token contract address - NEAR: token address - Solana: token's mint account address - Sui: token's type - TON: token's address
  - `symbol` string: Required for Stellar only, asset code is expected.

## Response `200`

A new asset has been created successfully

- AssetResponse
  - `legacyId` string, required
  - `assetClass` 'NATIVE' | 'FT' | 'NFT' | 'SFT', required
  - `onchain` AssetOnchain, required
    - `symbol` string, required: The asset symbol
    - `name` string, required: The asset name
    - `address` string: The asset address
    - `decimals` number, required: Number of decimals
    - `standard` string: The asset standard
  - `metadata` AssetMetadata, required
    - `scope` 'Global' | 'Local', required: The scope of the asset
    - `deprecated` boolean, required: Is asset deprecated

## Other responses

- `400`: - Listing an asset on the requested blockchain is not supported. Error code: 1000 - The asset address is invalid. Error code: 1003 - Self serve listing an asset on the requested blockchain is currently not supported, please contact support. Error code: 1004 - Blockchain is deprecated. Error code: 1006 - The asset's standard is not supported. Error code: 1007 - Unable to get expected metadata: decimals | name | symbol. Error code: 1010
- `403`: - The asset creation quota reached. Error code: 1005 - Tenant is not allowed to create testnet assets. Error code: 1008 - Tenant is not allowed to create mainnet assets. Error code: 1009
- `404`: - Invalid address, could not get asset information. Error code 1003
- `409`: - The asset is already supported globally. Error code: 1001 - The asset has already been added to this workspace. Error code: 1002
- `500`: Failed to create asset
- `default`: Error Response

---

[API](https://skmtc.dev/fireblocks/apis/fireblocks-api.md) - [All operations](https://skmtc.dev/fireblocks/apis/fireblocks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireblocks/apis/fireblocks-api/revisions/4eba9965659a?raw)