> ## 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.
## Submitting Feedback
If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:
POST https://developers.fireblocks.com/feedback
```json
{
"path": "/api-reference/blockchains-&-assets/get-an-asset",
"feedback": "Description of the issue"
}
```
Only submit feedback when you have something specific and actionable to report.
# Get an asset
> Returns an asset by ID or legacyID.
**Note**:
- We will continue displaying and supporting the legacy ID (API ID). Since not all Fireblocks services fully support the new Assets UUID, please use only the legacy ID until further notice.
## OpenAPI
````yaml https://docs.fireblocks.com/api/v1/swagger.yaml get /assets/{id}
openapi: 3.0.0
info:
title: Fireblocks API
description: >
Fireblocks provides a suite of applications to manage digital asset
operations and a complete development platform to build your business on the
blockchain.
- Visit our website for more information: [Fireblocks
Website](https://fireblocks.com)
- Visit our developer docs: [Fireblocks
DevPortal](https://developers.fireblocks.com)
version: 1.6.2
contact:
email: developers@fireblocks.com
servers:
- url: https://api.fireblocks.io/v1
description: Fireblocks Production Environment Base URL
- url: https://sandbox-api.fireblocks.io/v1
description: Fireblocks Sandbox Environment Base URL
security: []
paths:
/assets/{id}:
get:
tags:
- Blockchains & assets
summary: Get an asset
description: |
Returns an asset by ID or legacyID.
**Note**:
- We will continue displaying and supporting the legacy ID (API ID). Since not all Fireblocks services fully support the new Assets UUID, please use only the legacy ID until further notice.
operationId: getAsset
parameters:
- name: id
in: path
required: true
description: The ID or legacyId of the asset
schema:
type: string
x-fb-entity: asset
example: ETH
- $ref: '#/components/parameters/X-Idempotency-Key'
responses:
'200':
description: Asset with requested identification
headers:
X-Request-ID:
$ref: '#/components/headers/X-Request-ID'
content:
application/json:
schema:
$ref: '#/components/schemas/Asset'
'404':
description: |
- Asset with specified ID or legacy ID is not found. Error code 1504
content:
application/json:
schema:
$ref: '#/components/schemas/AssetNotFoundErrorResponse'
'500':
description: Error occurred while getting an asset
content:
application/json:
schema:
$ref: '#/components/schemas/AssetInternalServerErrorResponse'
default:
$ref: '#/components/responses/Error'
x-codeSamples:
- lang: TypeScript
source: >-
const response: Promise> =
fireblocks.blockchainsAssets.getAsset(blockchainsAssetsApiGetAssetRequest);
- lang: Java
source: >-
CompletableFuture> response =
fireblocks.blockchainsAssets().getAsset(id, idempotencyKey);
- lang: Python
source: >-
response = fireblocks.blockchains_&_assets.get_asset(id,
idempotency_key);
components:
parameters:
X-Idempotency-Key:
name: Idempotency-Key
in: header
description: >-
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.
required: false
schema:
type: string
headers:
X-Request-ID:
schema:
type: string
description: >-
Unique ID correlated to the API request. Please provide it in any
support ticket you create or on Github issues related to Fireblocks SDKs
schemas:
Asset:
type: object
properties:
id:
type: string
description: The ID of the asset
example: 9f9f7062-df90-4fc0-8697-96685184358d
legacyId:
type: string
description: The Legacy ID of the asset
example: USDT_ERC20
blockchainId:
type: string
description: The ID of the asset's blockchain
example: e85208ff-3b15-44e9-af14-0ed0280b2a15
displayName:
type: string
description: Asset's display name
example: Tether USD
displaySymbol:
type: string
description: Asset's display symbol
example: USDT
providerId:
type: string
description: The ID of the asset provider
example: SOME_PROVIDER_ID
peggedAssetId:
type: string
description: The ID of the pegged asset
example: 6ef19b84-2144-4d38-8056-d423199bce5e
assets:
type: array
description: List of asset IDs for virtual assets
items:
type: string
description: The ID of the asset
example: 6ef19b84-2144-4d38-8056-d423199bce5e
assetClass:
$ref: '#/components/schemas/AssetClass'
decimals:
type: number
description: Number of decimals for FIAT assets
example: 2
onchain:
$ref: '#/components/schemas/AssetDetailsOnchain'
metadata:
$ref: '#/components/schemas/AssetDetailsMetadata'
required:
- id
- legacyId
- assetClass
- displayName
- displaySymbol
- metadata
AssetNotFoundErrorResponse:
type: object
properties:
message:
type: string
description: Not found error code
example: Asset with specified ID not found
code:
type: number
description: Error code
example: 1504
required:
- message
- code
AssetInternalServerErrorResponse:
type: object
properties:
message:
type: string
description: Internal server error code
example: Internal server error
code:
type: number
description: Error code
example: 3005
required:
- message
- code
AssetClass:
type: string
example: FT
enum:
- NATIVE
- FT
- FIAT
- NFT
- SFT
- VIRTUAL
AssetDetailsOnchain:
type: object
properties:
symbol:
type: string
description: The asset symbol
example: USDT
name:
type: string
description: The asset name
example: Tether USD
address:
type: string
description: The asset address
example: '0xdAC17F958D2ee523a2206206994597C13D831ec7'
decimals:
type: number
description: Number of decimals
example: 6
standards:
description: Supported standards
type: array
items:
type: string
example:
- ERC20
required:
- symbol
- name
- decimals
AssetDetailsMetadata:
type: object
properties:
scope:
$ref: '#/components/schemas/AssetScope'
verified:
type: boolean
description: Is asset verified by Fireblocks
example: false
deprecated:
type: boolean
description: Is asset deprecated
example: false
deprecationReferralId:
type: string
description: New asset ID replacement
example: 056776ab-9efa-4219-9820-9ece0cc4d90d
website:
type: string
description: Vendor’s website
example: https://example.org
media:
description: Asset’s media
type: array
items:
$ref: '#/components/schemas/AssetMedia'
note:
$ref: '#/components/schemas/AssetNote'
features:
description: Asset features
type: array
items:
$ref: '#/components/schemas/AssetFeature'
required:
- scope
- verified
- deprecated
ErrorSchema:
type: object
properties:
message:
type: string
code:
type: number
AssetScope:
type: string
description: The scope of the asset
example: GLOBAL
enum:
- GLOBAL
- LOCAL
AssetMedia:
type: object
properties:
url:
type: string
description: Media URL
example: https://example.com/image.png
type:
type: string
description: Media type
example: image/svg+xml
enum:
- image/svg+xml
- image/png
attributes:
description: Media attributes
type: object
properties:
monochrome:
type: boolean
description: Monochrome flag
example: true
required:
- url
- type
AssetNote:
type: object
properties:
text:
type: string
description: Note content
example: Pay attention to gas fees
userId:
type: string
format: uuid
description: Who updated the note (uuid)
example: 056776ab-9efa-4219-9820-9ece0cc4d90d
userName:
type: string
description: User name
example: Test test
updatedAt:
type: string
format: date-time
description: ISO Timestamp when last updated
example: '2025-06-08T19:42:49.000Z'
required:
- text
- userId
- userName
- updatedAt
AssetFeature:
type: string
description: Asset feature
example: STABLECOIN
enum:
- STABLECOIN
responses:
Error:
description: Error Response
headers:
X-Request-ID:
$ref: '#/components/headers/X-Request-ID'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorSchema'
````