Activos

Los activos representan los tokens y monedas criptográficas que Fystack admite en distintas redes blockchain. Puedes consultar los activos con varios filtros, como la red, el símbolo y el estado en la lista blanca.

Información de los activos

Cada activo en Fystack contiene información completa sobre el token:

Propiedades del activo

Identificación del token: ID único, nombre, símbolo y dirección del contrato
Red asociada: la red blockchain en la que existe el activo
Tipo de activo: estándar del token (ERC20, TRC20, nativo, etc.)
Estado en la lista blanca: si el activo está aprobado para usarse en la plataforma
Precio: precio actual en USD con la marca de tiempo de la última actualización
Visual: URL del logo para su visualización

Obtener activos

GET

/assets

Este endpoint te permite obtener criptoactivos de todas las redes compatibles. Es un endpoint público que no requiere autenticación.

Parámetros

Name
network_id
Type
string (uuid)
Description
Filtra los activos por el UUID de la red. Por ejemplo, ?network_id=c03b242f-5091-499c-86c5-78dbc47ed719 devolverá solo los activos de BNB Mainnet.
Name
search
Type
string
Description
Busca activos por nombre o símbolo. Por ejemplo, ?search=USDC devolverá los activos que coincidan con "USDC".
Name
is_native
Type
boolean
Description
Filtra por activos nativos. Usa true para obtener solo monedas nativas (ETH, BNB, etc.) o false para obtener solo tokens.
Name
is_whitelisted
Type
boolean
Description
Filtra por estado en la lista blanca. Usa true para obtener solo los activos de la lista blanca aprobados para usarse en la plataforma.
Name
offset
Type
integer
Description
La cantidad de elementos que se omiten antes de empezar a recopilar el conjunto de resultados. Máximo: 100000.
Name
limit
Type
integer
Description
Limita la cantidad de elementos devueltos por página. Máximo: 1000.

Respuesta

Name
success
Type
boolean
Description
Indica si la solicitud se realizó correctamente.
Name
message
Type
string
Description
Un mensaje que describe el resultado de la operación.
Name
code
Type
integer
Description
Un código numérico que indica el estado del resultado (0 si fue exitoso).
Name
data
Type
array
Description
Un array de objetos de activo.

Name: id
Type: string
Description: El UUID del activo.

Name: created_at
Type: string
Description: Marca de tiempo en que el activo se agregó al sistema.

Name: updated_at
Type: string
Description: Marca de tiempo de la última actualización del activo.

Name: name
Type: string
Description: El nombre visible completo del activo.

Name: symbol
Type: string
Description: El símbolo del ticker del activo (por ejemplo, USDC, ETH).

Name: decimals
Type: integer
Description: La cantidad de decimales del activo.

Name: logo_url
Type: string
Description: URL de la imagen del logo del activo.

Name: address
Type: string
Description: La dirección del contrato del activo. Vacía para las monedas nativas.

Name: asset_type
Type: string
Description: El estándar o tipo del token. Puede ser erc20, trc20, native, etc.

Name: is_native
Type: boolean
Description: Indica si es la moneda nativa de la red.

Name: address_type
Type: string
Description: El tipo de formato de dirección. Puede ser evm, tron, etc.

Name: is_whitelisted
Type: boolean
Description: Indica si el activo está en la lista blanca y aprobado para usarse en la plataforma.

Name: network_id
Type: string
Description: El UUID de la red a la que pertenece este activo.

Name: network
Type: object
Description: El objeto de red completo con los detalles de la red.

Name: network.id
Type: string
Description: El UUID de la red.

Name: network.name
Type: string
Description: El nombre visible de la red.

Name: network.chain_id
Type: integer
Description: El identificador único de cadena de la red.

Name: network.native_currency
Type: string
Description: El símbolo de la moneda nativa de la red.

Name: network.is_evm
Type: boolean
Description: Indica si la red es compatible con EVM.

Name: network.explorer_tx
Type: string
Description: Plantilla de URL para los enlaces del explorador de transacciones.

Name: network.explorer_address
Type: string
Description: Plantilla de URL para los enlaces del explorador de direcciones.

Name: network.explorer_token
Type: string
Description: Plantilla de URL para los enlaces del explorador de tokens.

Name: price_usd
Type: string
Description: El precio actual del activo en USD.

Name: price_usd_updated_at
Type: string
Description: Marca de tiempo de la última actualización del precio en USD.

Este endpoint es público y no requiere autenticación. Puedes usarlo para obtener información de los activos sin credenciales de 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"
    }
  ]
}

Agregar un activo a una billetera

PUT

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

Este endpoint agrega un activo a una billetera, lo que le permite mantener y recibir ese activo. Si el activo se había eliminado anteriormente, se restaurará automáticamente.

La billetera ya debe tener un tipo de dirección compatible con la red del activo. Por ejemplo, para agregar un token ERC-20, la billetera debe tener una dirección EVM.

Parámetros de ruta

Name
wallet_id
Type
string (uuid)
Description
El UUID de la billetera a la que se agregará el activo.
Name
asset_id
Type
string (uuid)
Description
El UUID del activo que se va a agregar.

Respuesta

Name
success
Type
boolean
Description
Indica si la solicitud se realizó correctamente.
Name
message
Type
string
Description
Un mensaje que describe el resultado de la operación.
Name
code
Type
integer
Description
Un código numérico que indica el estado del resultado (0 si fue exitoso).
Name
data
Type
object
Description
El registro del activo en la billetera.

Name: id
Type: string
Description: El UUID del registro del activo en la billetera.

Name: wallet_id
Type: string
Description: El UUID de la billetera.

Name: asset_id
Type: string
Description: El UUID del activo.

Name: deposit_address
Type: string
Description: La dirección de depósito asignada a este activo en la billetera.

Si el activo ya existe en la billetera, se devuelve el registro existente. Volver a agregar un activo eliminado anteriormente lo restaura sin crear un duplicado.

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
  }
}

Eliminar un activo de una billetera

DELETE

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

Este endpoint elimina un activo de una billetera. El activo solo se puede eliminar si su saldo es cero. Si el activo todavía tiene fondos, primero debes transferirlos o retirarlos.

Parámetros de ruta

Name
wallet_id
Type
string (uuid)
Description
El UUID de la billetera de la que se eliminará el activo.
Name
asset_id
Type
string (uuid)
Description
El UUID del activo que se va a eliminar.

Respuesta

Name
success
Type
boolean
Description
Indica si la solicitud se realizó correctamente.
Name
message
Type
string
Description
Un mensaje que describe el resultado de la operación.
Name
code
Type
integer
Description
Un código numérico que indica el estado del resultado (0 si fue exitoso).

No puedes eliminar un activo con saldo distinto de cero. Transfiere o retira todos los fondos antes de eliminar el activo.

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
}

Casos de uso comunes

Buscar stablecoins

Para encontrar todas las stablecoins como USDC y USDT en todas las redes:

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

Obtener las monedas nativas

Para obtener todas las monedas nativas (ETH, BNB, etc.) para la estimación de gas:

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

Listar los activos de una red específica

Para obtener todos los activos disponibles en una red específica (por ejemplo, BNB Mainnet):

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

Paginación

Para conjuntos de resultados grandes, usa la paginación para obtener los activos por lotes:

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