---
title: "Tài sản"
description: "Hướng dẫn này giải thích cách truy xuất và truy vấn tài sản tiền mã hóa bằng Fystack API."
url: https://docs.fystack.io/vi/assets
last_updated: 2026-11-13
---

> ## Documentation index
> Fetch the complete documentation index at: https://docs.fystack.io/llms.txt
> Use it to discover all available pages before exploring further.

# 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

**Endpoint:** `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ố

- `network_id` (string (uuid)): 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.
- `search` (string): 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".
- `is_native` (boolean): 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.
- `is_whitelisted` (boolean): 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.
- `offset` (integer): Số mục cần bỏ qua trước khi bắt đầu lấy tập kết quả. Tối đa: 100000.
- `limit` (integer): Giới hạn số mục trả về trên mỗi trang. Tối đa: 1000.

### Response

- `success` (boolean): Cho biết request có thành công hay không.
- `message` (string): Thông điệp mô tả kết quả của thao tác.
- `code` (integer): Mã số cho biết trạng thái kết quả (0 nghĩa là thành công).
- `data` (array): Một mảng các đối tượng tài sản.
  - `id` (string): UUID của tài sản.
  - `created_at` (string): Thời điểm tài sản được thêm vào hệ thống.
  - `updated_at` (string): Thời điểm tài sản được cập nhật gần nhất.
  - `name` (string): Tên hiển thị đầy đủ của tài sản.
  - `symbol` (string): Ký hiệu ticker của tài sản (ví dụ: USDC, ETH).
  - `decimals` (integer): Số chữ số thập phân của tài sản.
  - `logo_url` (string): URL dẫn đến hình ảnh logo của tài sản.
  - `address` (string): Địa chỉ hợp đồng của tài sản. Để trống đối với tiền tệ native.
  - `asset_type` (string): Tiêu chuẩn hoặc loại token. Có thể là `erc20`, `trc20`, `native`, v.v.
  - `is_native` (boolean): Đây có phải là tiền tệ native của mạng lưới hay không.
  - `address_type` (string): Loại định dạng địa chỉ. Có thể là `evm`, `tron`, v.v.
  - `is_whitelisted` (boolean): 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.
  - `network_id` (string): UUID của mạng lưới mà tài sản này thuộc về.
  - `network` (object): Đối tượng mạng lưới đầy đủ chứa thông tin chi tiết về mạng lưới.
    - `network.id` (string): UUID của mạng lưới.
    - `network.name` (string): Tên hiển thị của mạng lưới.
    - `network.chain_id` (integer): Định danh chuỗi duy nhất của mạng lưới.
    - `network.native_currency` (string): Ký hiệu tiền tệ native của mạng lưới.
    - `network.is_evm` (boolean): Mạng lưới có tương thích EVM hay không.
    - `network.explorer_tx` (string): Mẫu URL cho liên kết explorer của giao dịch.
    - `network.explorer_address` (string): Mẫu URL cho liên kết explorer của địa chỉ.
    - `network.explorer_token` (string): Mẫu URL cho liên kết explorer của token.
  - `price_usd` (string): Giá hiện tại của tài sản tính bằng USD.
  - `price_usd_updated_at` (string): Thời điểm giá USD được cập nhật gần nhất.

> **Info.** 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`

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

```json
{
  "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í

**Endpoint:** `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

- `wallet_id` (string (uuid)): UUID của ví cần thêm tài sản.
- `asset_id` (string (uuid)): UUID của tài sản cần thêm.

### Response

- `success` (boolean): Cho biết request có thành công hay không.
- `message` (string): Thông điệp mô tả kết quả của thao tác.
- `code` (integer): Mã số cho biết trạng thái kết quả (0 nghĩa là thành công).
- `data` (object): Bản ghi tài sản của ví.
  - `id` (string): UUID của bản ghi tài sản của ví.
  - `wallet_id` (string): UUID của ví.
  - `asset_id` (string): UUID của tài sản.
  - `deposit_address` (string): Địa chỉ nạp tiền được gán cho tài sản này trên ví.

> **Info.** 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`

```bash
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=="
```

```json
{
  "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í

**Endpoint:** `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

- `wallet_id` (string (uuid)): UUID của ví cần gỡ tài sản.
- `asset_id` (string (uuid)): UUID của tài sản cần gỡ.

### Response

- `success` (boolean): Cho biết request có thành công hay không.
- `message` (string): Thông điệp mô tả kết quả của thao tác.
- `code` (integer): Mã số cho biết trạng thái kết quả (0 nghĩa là thành công).

> **Warning.** 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`

```bash
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=="
```

```json
{
  "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:

```bash
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:

```bash
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):

```bash
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ô:

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