---
title: "Workspaces"
description: "This guide explains how to retrieve workspace statistics and analytics using the Fystack API."
url: https://docs.fystack.io/workspaces
last_updated: 2026-10-15
---

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

# Workspaces

Workspaces provide a centralized view of your blockchain operations, including wallet statistics, transaction volumes, network fees, and smart contract activity.

---

## Get workspace statistics

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

Retrieve comprehensive statistics and analytics for a specific workspace, including transaction volumes, network fees, wallet counts, and smart contract activity.

### Path parameters

- `workspace_id` (string): The UUID of the workspace to retrieve statistics for.

### Response

- `success` (boolean): Indicates whether the request was successful.
- `message` (string): A message describing the result of the operation.
- `code` (integer): A numeric code indicating the result status (0 for success).
- `data` (object): Contains the workspace statistics.
  - `total_value` (string): Total value of all assets in the workspace (in USD).
  - `total_wallets` (integer): Total number of wallets in this workspace.
  - `total_smart_contracts` (integer): Total number of smart contracts deployed in this workspace.
  - `total_pending_transactions` (integer): Number of transactions currently pending.
  - `daily_volume_stats` (array): Array of daily transaction volume statistics for the past 8 days.
    - `id` (object): Date identifier for the daily stats.
      - `day` (integer): Day of the month.
      - `month` (integer): Month number (1-12).
    - `total` (string): Total transaction volume for the day (in USD).
    - `total_inflow_usd` (string): Total incoming transaction volume (in USD).
    - `total_outflow_usd` (string): Total outgoing transaction volume (in USD).
  - `monthly_stats` (array): Array of monthly transaction statistics.
    - `id` (object): Date identifier for the monthly stats.
      - `month` (integer): Month number (1-12).
      - `year` (integer): Year.
    - `total_transaction` (integer): Total number of transactions in the month.
    - `total_volume` (string): Total transaction volume for the month (in USD).
  - `monthly_total_fee_spent_per_network` (array): Array of network fees spent per month, broken down by blockchain network.
    - `id` (object): Identifier for the fee record.
      - `month` (integer): Month number (1-12).
      - `network_id` (string): UUID of the blockchain network.
      - `year` (integer): Year.
    - `total_fee_spent` (string): Total fees spent in the network's native currency.
    - `value` (string): Total fees spent in USD.
    - `network` (object): Network details.
      - `name` (string): Name of the blockchain network (e.g., "Ethereum", "Solana mainnet", "Base").
      - `native_currency` (string): Native currency symbol for the network (e.g., "ETH", "SOL").

> **Info.** Daily volume stats show the last 8 days of transaction activity, while monthly stats provide a historical view of transaction volumes and counts by month.

**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"
        }
      }
    ]
  }
}
```

---

## Get workspace balances by symbol

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

Query workspace balances filtered by one or more asset symbols. This endpoint aggregates balances across all networks for the specified symbols, providing a consolidated view of asset holdings.

### Path parameters

- `workspace_id` (string): The UUID of the workspace to retrieve balances for.

### Query parameters

- `symbol` (string): Asset symbol to filter by (e.g., USDC, SOL, ETH). Can be specified multiple times to query multiple symbols: `?symbol=USDC&symbol=SOL&symbol=ETH`

### Response

- `success` (boolean): Indicates whether the request was successful.
- `message` (string): A message describing the result of the operation.
- `code` (integer): A numeric code indicating the result status (0 for success).
- `data` (array): Array of balance information grouped by symbol.
  - `symbol` (string): The asset symbol (e.g., "USDC", "SOL", "ETH").
  - `total_balance` (string): Total balance of the asset across all networks.
  - `total_value_usd` (string): Total value of the asset in USD.
  - `total_wallet_count` (integer): Total number of wallets holding this asset.
  - `networks` (array): Array of network-specific balance information.
    - `asset_id` (string): UUID of the asset.
    - `asset_name` (string): Name of the asset (e.g., "USDC Sepolia test").
    - `asset_logo` (string): URL to the asset logo image.
    - `network_id` (string): UUID of the blockchain network.
    - `network_name` (string): Name of the blockchain network (e.g., "Sepolia Ethereum Testnet", "Solana devnet").
    - `network_logo` (string): URL to the network logo image.
    - `balance` (string): Balance of the asset on this specific network.
    - `wallet_count` (integer): Number of wallets holding this asset on this network.

> **Info.** You can query multiple symbols in a single request by repeating the `symbol` parameter. The response groups balances by symbol and shows the distribution across different networks.

**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
        }
      ]
    }
  ]
}
```