--- title: "Activos" description: "Esta guía explica cómo obtener y consultar criptoactivos usando la API de Fystack." url: https://docs.fystack.io/es/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. # 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 **Endpoint:** `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 - `network_id` (string (uuid)): 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. - `search` (string): Busca activos por nombre o símbolo. Por ejemplo, `?search=USDC` devolverá los activos que coincidan con "USDC". - `is_native` (boolean): Filtra por activos nativos. Usa `true` para obtener solo monedas nativas (ETH, BNB, etc.) o `false` para obtener solo tokens. - `is_whitelisted` (boolean): Filtra por estado en la lista blanca. Usa `true` para obtener solo los activos de la lista blanca aprobados para usarse en la plataforma. - `offset` (integer): La cantidad de elementos que se omiten antes de empezar a recopilar el conjunto de resultados. Máximo: 100000. - `limit` (integer): Limita la cantidad de elementos devueltos por página. Máximo: 1000. ### Respuesta - `success` (boolean): Indica si la solicitud se realizó correctamente. - `message` (string): Un mensaje que describe el resultado de la operación. - `code` (integer): Un código numérico que indica el estado del resultado (0 si fue exitoso). - `data` (array): Un array de objetos de activo. - `id` (string): El UUID del activo. - `created_at` (string): Marca de tiempo en que el activo se agregó al sistema. - `updated_at` (string): Marca de tiempo de la última actualización del activo. - `name` (string): El nombre visible completo del activo. - `symbol` (string): El símbolo del ticker del activo (por ejemplo, USDC, ETH). - `decimals` (integer): La cantidad de decimales del activo. - `logo_url` (string): URL de la imagen del logo del activo. - `address` (string): La dirección del contrato del activo. Vacía para las monedas nativas. - `asset_type` (string): El estándar o tipo del token. Puede ser `erc20`, `trc20`, `native`, etc. - `is_native` (boolean): Indica si es la moneda nativa de la red. - `address_type` (string): El tipo de formato de dirección. Puede ser `evm`, `tron`, etc. - `is_whitelisted` (boolean): Indica si el activo está en la lista blanca y aprobado para usarse en la plataforma. - `network_id` (string): El UUID de la red a la que pertenece este activo. - `network` (object): El objeto de red completo con los detalles de la red. - `network.id` (string): El UUID de la red. - `network.name` (string): El nombre visible de la red. - `network.chain_id` (integer): El identificador único de cadena de la red. - `network.native_currency` (string): El símbolo de la moneda nativa de la red. - `network.is_evm` (boolean): Indica si la red es compatible con EVM. - `network.explorer_tx` (string): Plantilla de URL para los enlaces del explorador de transacciones. - `network.explorer_address` (string): Plantilla de URL para los enlaces del explorador de direcciones. - `network.explorer_token` (string): Plantilla de URL para los enlaces del explorador de tokens. - `price_usd` (string): El precio actual del activo en USD. - `price_usd_updated_at` (string): Marca de tiempo de la última actualización del precio en USD. > **Info.** 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` ```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" } ] } ``` --- ## Agregar un activo a una billetera **Endpoint:** `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 - `wallet_id` (string (uuid)): El UUID de la billetera a la que se agregará el activo. - `asset_id` (string (uuid)): El UUID del activo que se va a agregar. ### Respuesta - `success` (boolean): Indica si la solicitud se realizó correctamente. - `message` (string): Un mensaje que describe el resultado de la operación. - `code` (integer): Un código numérico que indica el estado del resultado (0 si fue exitoso). - `data` (object): El registro del activo en la billetera. - `id` (string): El UUID del registro del activo en la billetera. - `wallet_id` (string): El UUID de la billetera. - `asset_id` (string): El UUID del activo. - `deposit_address` (string): La dirección de depósito asignada a este activo en la billetera. > **Info.** 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` ```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 } } ``` --- ## Eliminar un activo de una billetera **Endpoint:** `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 - `wallet_id` (string (uuid)): El UUID de la billetera de la que se eliminará el activo. - `asset_id` (string (uuid)): El UUID del activo que se va a eliminar. ### Respuesta - `success` (boolean): Indica si la solicitud se realizó correctamente. - `message` (string): Un mensaje que describe el resultado de la operación. - `code` (integer): Un código numérico que indica el estado del resultado (0 si fue exitoso). > **Warning.** 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` ```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 } ``` --- ## Casos de uso comunes ### Buscar stablecoins Para encontrar todas las stablecoins como USDC y USDT en todas las redes: ```bash 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: ```bash 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): ```bash 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: ```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" ```