Tài sản

Tài sản đại diện cho các token và coin tiền mã hóa được Fystack hỗ trợ trên nhiều mạng lưới blockchain khác nhau. Bạn có thể truy vấn tài sản theo nhiều bộ lọc, bao gồm mạng lưới, ký hiệu và trạng thái whitelist.

Thông tin tài sản

Mỗi tài sản trong Fystack chứa thông tin đầy đủ về token:

Thuộc tính tài sản

  • Định danh token: ID duy nhất, tên, ký hiệu và địa chỉ hợp đồng
  • Liên kết mạng lưới: Mạng lưới blockchain nơi tài sản tồn tại
  • Loại tài sản: Tiêu chuẩn token (ERC20, TRC20, native, v.v.)
  • Trạng thái whitelist: Tài sản có được phê duyệt để sử dụng trên nền tảng hay không
  • Giá: Giá USD hiện tại kèm thời điểm cập nhật gần nhất
  • Hình ảnh: URL logo dùng để hiển thị

Lấy danh sách tài sản

GET
/assets

Endpoint này cho phép bạn truy xuất các tài sản tiền mã hóa trên tất cả các mạng lưới được hỗ trợ. Đây là endpoint công khai, không yêu cầu xác thực.

Tham số

  • Name
    network_id
    Type
    string (uuid)
    Description

    Lọc tài sản theo UUID của mạng lưới. Ví dụ, ?network_id=c03b242f-5091-499c-86c5-78dbc47ed719 sẽ chỉ trả về các tài sản trên BNB Mainnet.

  • Name
    search
    Type
    string
    Description

    Tìm kiếm tài sản theo tên hoặc ký hiệu. Ví dụ, ?search=USDC sẽ trả về các tài sản khớp với "USDC".

  • Name
    is_native
    Type
    boolean
    Description

    Lọc theo tài sản native. Đặt thành true để chỉ lấy các tiền tệ native (ETH, BNB, v.v.), hoặc false để chỉ lấy token.

  • Name
    is_whitelisted
    Type
    boolean
    Description

    Lọc theo trạng thái whitelist. Đặt thành true để chỉ lấy các tài sản trong whitelist đã được phê duyệt để sử dụng trên nền tảng.

  • Name
    offset
    Type
    integer
    Description

    Số mục cần bỏ qua trước khi bắt đầu lấy tập kết quả. Tối đa: 100000.

  • Name
    limit
    Type
    integer
    Description

    Giới hạn số mục trả về trên mỗi trang. Tối đa: 1000.

Response

  • Name
    success
    Type
    boolean
    Description

    Cho biết request có thành công hay không.

  • Name
    message
    Type
    string
    Description

    Thông điệp mô tả kết quả của thao tác.

  • Name
    code
    Type
    integer
    Description

    Mã số cho biết trạng thái kết quả (0 nghĩa là thành công).

  • Name
    data
    Type
    array
    Description

    Một mảng các đối tượng tài sản.

  • Name
    id
    Type
    string
    Description

    UUID của tài sản.

  • Name
    created_at
    Type
    string
    Description

    Thời điểm tài sản được thêm vào hệ thống.

  • Name
    updated_at
    Type
    string
    Description

    Thời điểm tài sản được cập nhật gần nhất.

  • Name
    name
    Type
    string
    Description

    Tên hiển thị đầy đủ của tài sản.

  • Name
    symbol
    Type
    string
    Description

    Ký hiệu ticker của tài sản (ví dụ: USDC, ETH).

  • Name
    decimals
    Type
    integer
    Description

    Số chữ số thập phân của tài sản.

  • Name
    logo_url
    Type
    string
    Description

    URL dẫn đến hình ảnh logo của tài sản.

  • Name
    address
    Type
    string
    Description

    Địa chỉ hợp đồng của tài sản. Để trống đối với tiền tệ native.

  • Name
    asset_type
    Type
    string
    Description

    Tiêu chuẩn hoặc loại token. Có thể là erc20, trc20, native, v.v.

  • Name
    is_native
    Type
    boolean
    Description

    Đây có phải là tiền tệ native của mạng lưới hay không.

  • Name
    address_type
    Type
    string
    Description

    Loại định dạng địa chỉ. Có thể là evm, tron, v.v.

  • Name
    is_whitelisted
    Type
    boolean
    Description

    Tài sản có nằm trong whitelist và được phê duyệt để sử dụng trên nền tảng hay không.

  • Name
    network_id
    Type
    string
    Description

    UUID của mạng lưới mà tài sản này thuộc về.

  • Name
    network
    Type
    object
    Description

    Đối tượng mạng lưới đầy đủ chứa thông tin chi tiết về mạng lưới.

  • Name
    network.id
    Type
    string
    Description

    UUID của mạng lưới.

  • Name
    network.name
    Type
    string
    Description

    Tên hiển thị của mạng lưới.

  • Name
    network.chain_id
    Type
    integer
    Description

    Định danh chuỗi duy nhất của mạng lưới.

  • Name
    network.native_currency
    Type
    string
    Description

    Ký hiệu tiền tệ native của mạng lưới.

  • Name
    network.is_evm
    Type
    boolean
    Description

    Mạng lưới có tương thích EVM hay không.

  • Name
    network.explorer_tx
    Type
    string
    Description

    Mẫu URL cho liên kết explorer của giao dịch.

  • Name
    network.explorer_address
    Type
    string
    Description

    Mẫu URL cho liên kết explorer của địa chỉ.

  • Name
    network.explorer_token
    Type
    string
    Description

    Mẫu URL cho liên kết explorer của token.

  • Name
    price_usd
    Type
    string
    Description

    Giá hiện tại của tài sản tính bằng USD.

  • Name
    price_usd_updated_at
    Type
    string
    Description

    Thời điểm giá USD được cập nhật gần nhất.

Endpoint này là công khai và không yêu cầu xác thực. Bạn có thể dùng nó để truy xuất thông tin tài sản mà không cần thông tin xác thực API.

Request

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

Response

200
{
  "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"
    }
  ]
}

Thêm tài sản vào ví

PUT
/wallets/{wallet_id}/asset/{asset_id}

Endpoint này thêm một tài sản vào ví, cho phép ví nắm giữ và nhận tài sản đó. Nếu tài sản đã bị gỡ trước đó, nó sẽ được tự động khôi phục.

Ví phải có sẵn loại địa chỉ hỗ trợ mạng lưới của tài sản. Ví dụ, để thêm một token ERC-20, ví cần có địa chỉ EVM.

Tham số đường dẫn

  • Name
    wallet_id
    Type
    string (uuid)
    Description

    UUID của ví cần thêm tài sản.

  • Name
    asset_id
    Type
    string (uuid)
    Description

    UUID của tài sản cần thêm.

Response

  • Name
    success
    Type
    boolean
    Description

    Cho biết request có thành công hay không.

  • Name
    message
    Type
    string
    Description

    Thông điệp mô tả kết quả của thao tác.

  • Name
    code
    Type
    integer
    Description

    Mã số cho biết trạng thái kết quả (0 nghĩa là thành công).

  • Name
    data
    Type
    object
    Description

    Bản ghi tài sản của ví.

  • Name
    id
    Type
    string
    Description

    UUID của bản ghi tài sản của ví.

  • Name
    wallet_id
    Type
    string
    Description

    UUID của ví.

  • Name
    asset_id
    Type
    string
    Description

    UUID của tài sản.

  • Name
    deposit_address
    Type
    string
    Description

    Địa chỉ nạp tiền được gán cho tài sản này trên ví.

Nếu tài sản đã tồn tại trong ví, bản ghi hiện có sẽ được trả về. Thêm lại một tài sản đã bị gỡ trước đó sẽ khôi phục nó mà không tạo bản trùng lặp.

Request

PUT
/wallets/:wallet_id/asset/:asset_id
curl -X PUT https://api.fystack.io/api/v1/wallets/c2b71329-34c9-45aa-89d3-ddde8b15dec5/asset/bf130274-e80c-43f3-aac3-c7dbfcbd74cd \
  -H "ACCESS-API-KEY: your_api_key" \
  -H "ACCESS-TIMESTAMP: 1667836889" \
  -H "ACCESS-SIGN: YourBase64EncodedSignature=="

Response

200
{
  "success": true,
  "message": "success",
  "code": 0,
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "wallet_id": "c2b71329-34c9-45aa-89d3-ddde8b15dec5",
    "asset_id": "bf130274-e80c-43f3-aac3-c7dbfcbd74cd",
    "deposit_address": "0xA793457d84CFD255Ed68295984300C4f799E759F",
    "hidden": false
  }
}

Gỡ tài sản khỏi ví

DELETE
/wallets/{wallet_id}/asset/{asset_id}

Endpoint này gỡ một tài sản khỏi ví. Tài sản chỉ có thể bị gỡ khi số dư bằng không. Nếu tài sản vẫn còn tiền, bạn phải chuyển hoặc rút hết trước.

Tham số đường dẫn

  • Name
    wallet_id
    Type
    string (uuid)
    Description

    UUID của ví cần gỡ tài sản.

  • Name
    asset_id
    Type
    string (uuid)
    Description

    UUID của tài sản cần gỡ.

Response

  • Name
    success
    Type
    boolean
    Description

    Cho biết request có thành công hay không.

  • Name
    message
    Type
    string
    Description

    Thông điệp mô tả kết quả của thao tác.

  • Name
    code
    Type
    integer
    Description

    Mã số cho biết trạng thái kết quả (0 nghĩa là thành công).

Bạn không thể gỡ tài sản có số dư khác không. Hãy chuyển hoặc rút toàn bộ tiền trước khi gỡ tài sản.

Request

DELETE
/wallets/:wallet_id/asset/:asset_id
curl -X DELETE https://api.fystack.io/api/v1/wallets/c2b71329-34c9-45aa-89d3-ddde8b15dec5/asset/bf130274-e80c-43f3-aac3-c7dbfcbd74cd \
  -H "ACCESS-API-KEY: your_api_key" \
  -H "ACCESS-TIMESTAMP: 1667836889" \
  -H "ACCESS-SIGN: YourBase64EncodedSignature=="

Response

200
{
  "success": true,
  "message": "success",
  "code": 0,
  "data": null
}

Các trường hợp sử dụng phổ biến

Tìm stablecoin

Để tìm tất cả stablecoin như USDC và USDT trên các mạng lưới:

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

Lấy tiền tệ native

Để lấy tất cả tiền tệ native (ETH, BNB, v.v.) phục vụ ước tính gas:

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

Liệt kê tài sản trên một mạng lưới cụ thể

Để lấy tất cả tài sản có trên một mạng lưới cụ thể (ví dụ: BNB Mainnet):

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

Phân trang

Với tập kết quả lớn, hãy dùng phân trang để truy xuất tài sản theo từng lô:

# 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"