Assets

Assets represent the cryptocurrency tokens and coins supported by Fystack across different blockchain networks. You can query assets by various filters including network, symbol, and whitelist status.

Asset information

Each asset in Fystack contains comprehensive information about the token:

Asset properties

Token identification: Unique ID, name, symbol, and contract address
Network association: The blockchain network where the asset exists
Asset type: Token standard (ERC20, TRC20, native, etc.)
Whitelist status: Whether the asset is approved for use on the platform
Pricing: Current USD price with last update timestamp
Visual: Logo URL for display purposes

GET/assets

Get assets

This endpoint allows you to retrieve cryptocurrency assets across all supported networks. This is a public endpoint that does not require authentication.

Optional parameters

Name
network_id
Type
string (uuid)
Description
Filter assets by network UUID. For example, ?network_id=c03b242f-5091-499c-86c5-78dbc47ed719 will return assets only on BNB Mainnet.
Name
search
Type
string
Description
Search assets by name or symbol. For example, ?search=USDC will return assets matching "USDC".
Name
is_native
Type
boolean
Description
Filter by native assets. Set to true to get only native currencies (ETH, BNB, etc.), or false to get only tokens.
Name
is_whitelisted
Type
boolean
Description
Filter by whitelist status. Set to true to get only whitelisted assets approved for platform use.
Name
offset
Type
integer
Description
The number of items to skip before starting to collect the result set. Maximum: 100000.
Name
limit
Type
integer
Description
Limit the number of items returned per page. Maximum: 1000.

Response

Name
success
Type
boolean
Description
Indicates whether the request was successful.
Name
message
Type
string
Description
A message describing the result of the operation.
Name
code
Type
integer
Description
A numeric code indicating the result status (0 for success).
Name
data
Type
array
Description
An array of asset objects.

Name: id
Type: string
Description: The UUID of the asset.

Name: created_at
Type: string
Description: Timestamp when the asset was added to the system.

Name: updated_at
Type: string
Description: Timestamp of the last asset update.

Name: name
Type: string
Description: The full display name of the asset.

Name: symbol
Type: string
Description: The ticker symbol of the asset (e.g., USDC, ETH).

Name: decimals
Type: integer
Description: The number of decimal places for the asset.

Name: logo_url
Type: string
Description: URL to the asset's logo image.

Name: address
Type: string
Description: The contract address of the asset. Empty for native currencies.

Name: asset_type
Type: string
Description: The token standard or type. Can be erc20, trc20, native, etc.

Name: is_native
Type: boolean
Description: Whether this is the native currency of the network.

Name: address_type
Type: string
Description: The address format type. Can be evm, tron, etc.

Name: is_whitelisted
Type: boolean
Description: Whether the asset is whitelisted and approved for platform use.

Name: network_id
Type: string
Description: The UUID of the network this asset belongs to.

Name: network
Type: object
Description: The full network object containing network details.

Name: network.id
Type: string
Description: The UUID of the network.

Name: network.name
Type: string
Description: The display name of the network.

Name: network.chain_id
Type: integer
Description: The unique chain identifier for the network.

Name: network.native_currency
Type: string
Description: The native currency symbol of the network.

Name: network.is_evm
Type: boolean
Description: Whether the network is EVM compatible.

Name: network.explorer_tx
Type: string
Description: URL template for transaction explorer links.

Name: network.explorer_address
Type: string
Description: URL template for address explorer links.

Name: network.explorer_token
Type: string
Description: URL template for token explorer links.

Name: price_usd
Type: string
Description: The current price of the asset in USD.

Name: price_usd_updated_at
Type: string
Description: Timestamp when the USD price was last updated.

This endpoint is public and does not require authentication. You can use it to retrieve asset information without API credentials.

Request

GET

/assets

curl -X GET "https://api.fystack.io/api/v1/assets?search=USDC"

Response

{
  "success": true,
  "message": "success",
  "code": 0,
  "data": [
    {
      "id": "bf130274-e80c-43f3-aac3-c7dbfcbd74cd",
      "created_at": "2026-01-21T12:27:39.902081+07:00",
      "updated_at": "2026-01-21T12:27:39.902081+07:00",
      "name": "USDC (Binance-Peg USD Coin)",
      "symbol": "USDC",
      "decimals": 18,
      "logo_url": "https://bscscan.com/token/images/centre-usdc_28.png",
      "address": "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
      "asset_type": "erc20",
      "is_native": false,
      "address_type": "evm",
      "is_whitelisted": true,
      "network_id": "c03b242f-5091-499c-86c5-78dbc47ed719",
      "network": {
        "id": "c03b242f-5091-499c-86c5-78dbc47ed719",
        "created_at": "2024-11-03T20:18:36.254727+07:00",
        "updated_at": "2025-08-22T08:32:32.534204+07:00",
        "name": "BNB Mainnet",
        "description": "BNB Mainnet",
        "is_evm": true,
        "chain_id": 56,
        "native_currency": "BNB",
        "internal_code": "BSC_MAINNET",
        "explorer_tx": "https://bscscan.com/tx/%s",
        "explorer_address": "https://bscscan.com/address/%s",
        "explorer_token": "https://bscscan.com/token/%s",
        "confirmation_blocks": 12,
        "block_interval_in_seconds": 3.2,
        "disabled": false,
        "logo_url": "https://s2.coinmarketcap.com/static/img/coins/64x64/1839.png"
      },
      "price_usd": "1",
      "price_usd_updated_at": "2026-02-03T06:47:55.879075+07:00"
    },
    {
      "id": "a52495a7-39b3-4ee9-9a94-e461e2057748",
      "created_at": "2026-01-09T11:09:23.092265+07:00",
      "updated_at": "2026-01-09T11:15:12.374079+07:00",
      "name": "Bridged USDC on Lisk",
      "symbol": "USDC",
      "decimals": 6,
      "logo_url": "https://assets-cdn.trustwallet.com/blockchains/base/assets/0xEB466342C4d449BC9f53A865D5Cb90586f405215/logo.png",
      "address": "0xF242275d3a6527d877f2c927a82D9b057609cc71",
      "asset_type": "erc20",
      "is_native": false,
      "address_type": "evm",
      "is_whitelisted": true,
      "network_id": "d2d90216-2530-4704-bc58-48719dacb76f",
      "network": {
        "id": "d2d90216-2530-4704-bc58-48719dacb76f",
        "created_at": "2026-01-08T11:58:34.277954+07:00",
        "updated_at": "2026-01-08T11:58:34.277954+07:00",
        "name": "Lisk",
        "description": "Lisk is an Ethereum Layer-2 blockchain network.",
        "is_evm": true,
        "chain_id": 1135,
        "native_currency": "ETH",
        "is_testnet": true,
        "internal_code": "LISK_MAINNET",
        "explorer_tx": "https://blockscout.lisk.com/tx/%s",
        "explorer_address": "https://blockscout.lisk.com/address/%s",
        "explorer_token": "https://blockscout.lisk.com/token/%s",
        "confirmation_blocks": 5,
        "block_interval_in_seconds": 2,
        "disabled": false,
        "logo_url": "https://avatars.githubusercontent.com/u/16600915?s=200&v=4"
      },
      "price_usd": "1",
      "price_usd_updated_at": "2026-02-03T06:47:55.879075+07:00"
    }
  ]
}

Common use cases

Finding stablecoins

To find all stablecoins like USDC and USDT across networks:

curl -X GET "https://api.fystack.io/api/v1/assets?search=USD&is_whitelisted=true"

Getting native currencies

To get all native currencies (ETH, BNB, etc.) for gas estimation:

curl -X GET "https://api.fystack.io/api/v1/assets?is_native=true"

Listing assets on a specific network

To get all assets available on a specific network (e.g., BNB Mainnet):

curl -X GET "https://api.fystack.io/api/v1/assets?network_id=c03b242f-5091-499c-86c5-78dbc47ed719&is_whitelisted=true"

Pagination

For large result sets, use pagination to retrieve assets in batches:

# First page
curl -X GET "https://api.fystack.io/api/v1/assets?limit=50&offset=0"

# Second page
curl -X GET "https://api.fystack.io/api/v1/assets?limit=50&offset=50"