---
title: "Espacios de trabajo"
description: "Esta guía explica cómo obtener estadísticas y analíticas de un espacio de trabajo usando la API de Fystack."
url: https://docs.fystack.io/es/workspaces
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.

# Espacios de trabajo

Los espacios de trabajo ofrecen una vista centralizada de tus operaciones blockchain, incluidas las estadísticas de billeteras, los volúmenes de transacciones, las comisiones de red y la actividad de smart contracts.

---

## Obtener estadísticas del espacio de trabajo

**Endpoint:** `GET /workspaces/{workspace_id}/stats`

Obtén estadísticas y analíticas completas de un espacio de trabajo específico, incluidos los volúmenes de transacciones, las comisiones de red, la cantidad de billeteras y la actividad de smart contracts.

### Parámetros de ruta

- `workspace_id` (string): El UUID del espacio de trabajo del que se obtendrán las estadísticas.

### 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): Contiene las estadísticas del espacio de trabajo.
  - `total_value` (string): Valor total de todos los activos del espacio de trabajo (en USD).
  - `total_wallets` (integer): Número total de billeteras en este espacio de trabajo.
  - `total_smart_contracts` (integer): Número total de smart contracts desplegados en este espacio de trabajo.
  - `total_pending_transactions` (integer): Número de transacciones actualmente pendientes.
  - `daily_volume_stats` (array): Arreglo de estadísticas diarias de volumen de transacciones de los últimos 8 días.
    - `id` (object): Identificador de fecha para las estadísticas diarias.
      - `day` (integer): Día del mes.
      - `month` (integer): Número de mes (1-12).
    - `total` (string): Volumen total de transacciones del día (en USD).
    - `total_inflow_usd` (string): Volumen total de transacciones entrantes (en USD).
    - `total_outflow_usd` (string): Volumen total de transacciones salientes (en USD).
  - `monthly_stats` (array): Arreglo de estadísticas mensuales de transacciones.
    - `id` (object): Identificador de fecha para las estadísticas mensuales.
      - `month` (integer): Número de mes (1-12).
      - `year` (integer): Año.
    - `total_transaction` (integer): Número total de transacciones del mes.
    - `total_volume` (string): Volumen total de transacciones del mes (en USD).
  - `monthly_total_fee_spent_per_network` (array): Arreglo de comisiones de red pagadas por mes, desglosadas por red blockchain.
    - `id` (object): Identificador del registro de comisiones.
      - `month` (integer): Número de mes (1-12).
      - `network_id` (string): UUID de la red blockchain.
      - `year` (integer): Año.
    - `total_fee_spent` (string): Total de comisiones pagadas en la moneda nativa de la red.
    - `value` (string): Total de comisiones pagadas en USD.
    - `network` (object): Detalles de la red.
      - `name` (string): Nombre de la red blockchain (por ejemplo, "Ethereum", "Solana mainnet", "Base").
      - `native_currency` (string): Símbolo de la moneda nativa de la red (por ejemplo, "ETH", "SOL").

> **Info.** Las estadísticas diarias de volumen muestran los últimos 8 días de actividad de transacciones, mientras que las estadísticas mensuales ofrecen una vista histórica de los volúmenes y la cantidad de transacciones por mes.

**Request** `GET /workspaces/{workspace_id}/stats`

```bash
curl -X GET https://api.fystack.io/api/v1/workspaces/ffb8c9d1-0bd2-4c30-bf4f-2a8fe7710d51/stats \
  -H "ACCESS-API-KEY: your_api_key" \
  -H "ACCESS-TIMESTAMP: 1667836889" \
  -H "ACCESS-SIGN: YourBase64EncodedSignature=="
```

```json
{
  "success": true,
  "message": "success",
  "code": 0,
  "data": {
    "total_value": "1534.84534320254792485502487275776",
    "total_wallets": 39,
    "total_smart_contracts": 0,
    "total_pending_transactions": 0,
    "daily_volume_stats": [
      {
        "id": {
          "day": 16,
          "month": 11
        },
        "total": "0",
        "total_inflow_usd": "0",
        "total_outflow_usd": "0"
      },
      {
        "id": {
          "day": 15,
          "month": 11
        },
        "total": "0",
        "total_inflow_usd": "0",
        "total_outflow_usd": "0"
      },
      {
        "id": {
          "day": 14,
          "month": 11
        },
        "total": "0",
        "total_inflow_usd": "0",
        "total_outflow_usd": "0"
      },
      {
        "id": {
          "day": 13,
          "month": 11
        },
        "total": "0",
        "total_inflow_usd": "0",
        "total_outflow_usd": "0"
      },
      {
        "id": {
          "day": 12,
          "month": 11
        },
        "total": "0",
        "total_inflow_usd": "0",
        "total_outflow_usd": "0"
      },
      {
        "id": {
          "day": 11,
          "month": 11
        },
        "total": "0",
        "total_inflow_usd": "0",
        "total_outflow_usd": "0"
      },
      {
        "id": {
          "day": 10,
          "month": 11
        },
        "total": "0",
        "total_inflow_usd": "0",
        "total_outflow_usd": "0"
      },
      {
        "id": {
          "day": 9,
          "month": 11
        },
        "total": "0",
        "total_inflow_usd": "0",
        "total_outflow_usd": "0"
      }
    ],
    "monthly_stats": [
      {
        "id": {
          "month": 2,
          "year": 2025
        },
        "total_transaction": 1,
        "total_volume": "3.0232548466894343"
      },
      {
        "id": {
          "month": 3,
          "year": 2025
        },
        "total_transaction": 0,
        "total_volume": "0"
      },
      {
        "id": {
          "month": 4,
          "year": 2025
        },
        "total_transaction": 2,
        "total_volume": "5.38689432482736497038665"
      },
      {
        "id": {
          "month": 5,
          "year": 2025
        },
        "total_transaction": 2,
        "total_volume": "3.4820715177482234"
      },
      {
        "id": {
          "month": 6,
          "year": 2025
        },
        "total_transaction": 3,
        "total_volume": "6016.123408531333541256"
      },
      {
        "id": {
          "month": 7,
          "year": 2025
        },
        "total_transaction": 24,
        "total_volume": "716.62394897558719889991228"
      },
      {
        "id": {
          "month": 8,
          "year": 2025
        },
        "total_transaction": 0,
        "total_volume": "0"
      },
      {
        "id": {
          "month": 9,
          "year": 2025
        },
        "total_transaction": 19,
        "total_volume": "61.99795033878070467252234"
      },
      {
        "id": {
          "month": 10,
          "year": 2025
        },
        "total_transaction": 2,
        "total_volume": "10.997992387864311"
      },
      {
        "id": {
          "month": 11,
          "year": 2025
        },
        "total_transaction": 0,
        "total_volume": "0"
      }
    ],
    "monthly_total_fee_spent_per_network": [
      {
        "id": {
          "month": 7,
          "network_id": "ab3553b6-1472-4ee2-bbb7-7a3df71db90d",
          "year": 2025
        },
        "total_fee_spent": "0.000000408265132",
        "value": "0.0012847633534240739867953232",
        "network": {
          "name": "Base",
          "native_currency": "ETH"
        }
      },
      {
        "id": {
          "month": 7,
          "network_id": "8ae1f43f-d428-484d-8ad4-ee9ccc65a9ac",
          "year": 2025
        },
        "total_fee_spent": "0.00004",
        "value": "0.0055775034112016304",
        "network": {
          "name": "Solana mainnet",
          "native_currency": "SOL"
        }
      },
      {
        "id": {
          "month": 6,
          "network_id": "8ae1f43f-d428-484d-8ad4-ee9ccc65a9ac",
          "year": 2025
        },
        "total_fee_spent": "0.000005",
        "value": "0.0006971879264002038",
        "network": {
          "name": "Solana mainnet",
          "native_currency": "SOL"
        }
      },
      {
        "id": {
          "month": 4,
          "network_id": "8ae1f43f-d428-484d-8ad4-ee9ccc65a9ac",
          "year": 2025
        },
        "total_fee_spent": "0.00001",
        "value": "0.0013943758528004076",
        "network": {
          "name": "Solana mainnet",
          "native_currency": "SOL"
        }
      },
      {
        "id": {
          "month": 6,
          "network_id": "dd21bfb5-f809-4070-a789-18ec8abbee1b",
          "year": 2025
        },
        "total_fee_spent": "0.0001131949830806",
        "value": "0.35621157589674587496249666856",
        "network": {
          "name": "Ethereum",
          "native_currency": "ETH"
        }
      },
      {
        "id": {
          "month": 2,
          "network_id": "dd21bfb5-f809-4070-a789-18ec8abbee1b",
          "year": 2025
        },
        "total_fee_spent": "0.0000294725852381",
        "value": "0.09274683159711570977946276556",
        "network": {
          "name": "Ethereum",
          "native_currency": "ETH"
        }
      },
      {
        "id": {
          "month": 9,
          "network_id": "8ae1f43f-d428-484d-8ad4-ee9ccc65a9ac",
          "year": 2025
        },
        "total_fee_spent": "0.00001",
        "value": "0.0013943758528004076",
        "network": {
          "name": "Solana mainnet",
          "native_currency": "SOL"
        }
      },
      {
        "id": {
          "month": 5,
          "network_id": "8ae1f43f-d428-484d-8ad4-ee9ccc65a9ac",
          "year": 2025
        },
        "total_fee_spent": "0.00001",
        "value": "0.0013943758528004076",
        "network": {
          "name": "Solana mainnet",
          "native_currency": "SOL"
        }
      },
      {
        "id": {
          "month": 6,
          "network_id": "ab3553b6-1472-4ee2-bbb7-7a3df71db90d",
          "year": 2025
        },
        "total_fee_spent": "0.000000012727953",
        "value": "0.0000400534023035403443967228",
        "network": {
          "name": "Base",
          "native_currency": "ETH"
        }
      }
    ]
  }
}
```

---

## Obtener saldos del espacio de trabajo por símbolo

**Endpoint:** `GET /workspaces/{workspace_id}/balances`

Consulta los saldos del espacio de trabajo filtrados por uno o más símbolos de activos. Este endpoint agrega los saldos de todas las redes para los símbolos indicados y ofrece una vista consolidada de los activos en posesión.

### Parámetros de ruta

- `workspace_id` (string): El UUID del espacio de trabajo del que se obtendrán los saldos.

### Parámetros de consulta

- `symbol` (string): Símbolo del activo por el que filtrar (por ejemplo, USDC, SOL, ETH). Puede especificarse varias veces para consultar varios símbolos: `?symbol=USDC&symbol=SOL&symbol=ETH`

### 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): Arreglo con la información de saldos agrupada por símbolo.
  - `symbol` (string): El símbolo del activo (por ejemplo, "USDC", "SOL", "ETH").
  - `total_balance` (string): Saldo total del activo en todas las redes.
  - `total_value_usd` (string): Valor total del activo en USD.
  - `total_wallet_count` (integer): Número total de billeteras que contienen este activo.
  - `networks` (array): Arreglo con la información de saldos por red.
    - `asset_id` (string): UUID del activo.
    - `asset_name` (string): Nombre del activo (por ejemplo, "USDC Sepolia test").
    - `asset_logo` (string): URL de la imagen del logo del activo.
    - `network_id` (string): UUID de la red blockchain.
    - `network_name` (string): Nombre de la red blockchain (por ejemplo, "Sepolia Ethereum Testnet", "Solana devnet").
    - `network_logo` (string): URL de la imagen del logo de la red.
    - `balance` (string): Saldo del activo en esta red específica.
    - `wallet_count` (integer): Número de billeteras que contienen este activo en esta red.

> **Info.** Puedes consultar varios símbolos en una sola solicitud repitiendo el parámetro `symbol`. La respuesta agrupa los saldos por símbolo y muestra su distribución entre las distintas redes.

**Request** `GET /workspaces/{workspace_id}/balances`

```bash
curl -X GET "https://api.fystack.io/api/v1/workspaces/ffb8c9d1-0bd2-4c30-bf4f-2a8fe7710d51/balances?symbol=USDC&symbol=SOL" \
  -H "ACCESS-API-KEY: your_api_key" \
  -H "ACCESS-TIMESTAMP: 1667836889" \
  -H "ACCESS-SIGN: YourBase64EncodedSignature=="
```

```json
{
  "success": true,
  "message": "success",
  "code": 0,
  "data": [
    {
      "symbol": "SOL",
      "total_balance": "0.22379716",
      "total_value_usd": "29.8080102529293016511548",
      "total_wallet_count": 7,
      "networks": [
        {
          "asset_id": "d10f85c1-a89d-439f-b488-57cd06b064d5",
          "asset_name": "Solana dev net",
          "asset_logo": "https://upload.wikimedia.org/wikipedia/en/b/b9/Solana_logo.png",
          "network_id": "2e89cd02-8585-47b3-90e3-a92185f6ca5f",
          "network_name": "Solana devnet",
          "network_logo": "https://upload.wikimedia.org/wikipedia/en/b/b9/Solana_logo.png",
          "balance": "0.22379716",
          "wallet_count": 7
        }
      ]
    },
    {
      "symbol": "USDC",
      "total_balance": "36515.008265",
      "total_value_usd": "36510.1973390962088334367595",
      "total_wallet_count": 25,
      "networks": [
        {
          "asset_id": "f1be472d-1338-43ff-b547-06faba7ecce7",
          "asset_name": "USDC Sepolia test",
          "asset_logo": "https://assets-cdn.trustwallet.com/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
          "network_id": "23d13c03-1f3c-4e2a-9aef-1771a244b7f6",
          "network_name": "Sepolia Ethereum Testnet",
          "network_logo": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-lzp6jMVVHdxHiK4q5Xy2FbJIrC-GPmTREA&s",
          "balance": "33426.996114",
          "wallet_count": 16
        },
        {
          "asset_id": "af836c8e-3199-426d-bb00-17ae3a5c2f5a",
          "asset_name": "USDC-Test",
          "asset_logo": "https://s2.coinmarketcap.com/static/img/coins/64x64/3408.png",
          "network_id": "2e89cd02-8585-47b3-90e3-a92185f6ca5f",
          "network_name": "Solana devnet",
          "network_logo": "https://upload.wikimedia.org/wikipedia/en/b/b9/Solana_logo.png",
          "balance": "35.012151",
          "wallet_count": 5
        },
        {
          "asset_id": "60cd62ac-f100-42aa-a16e-d1a8ed28e39f",
          "asset_name": "USDC( Tron testnet)",
          "asset_logo": "https://assets-cdn.trustwallet.com/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
          "network_id": "c5725221-fa98-4d6c-a6ca-8c5cd65cd884",
          "network_name": "Tron testnet",
          "network_logo": "https://s2.coinmarketcap.com/static/img/coins/64x64/1958.png",
          "balance": "3053",
          "wallet_count": 4
        }
      ]
    }
  ]
}
```
