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

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

Name
workspace_id
Type
string
Description
El UUID del espacio de trabajo del que se obtendrán las estadísticas.

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
Contiene las estadísticas del espacio de trabajo.

Name: total_value
Type: string
Description: Valor total de todos los activos del espacio de trabajo (en USD).

Name: total_wallets
Type: integer
Description: Número total de billeteras en este espacio de trabajo.

Name: total_smart_contracts
Type: integer
Description: Número total de smart contracts desplegados en este espacio de trabajo.

Name: total_pending_transactions
Type: integer
Description: Número de transacciones actualmente pendientes.

Name: daily_volume_stats
Type: array
Description: Arreglo de estadísticas diarias de volumen de transacciones de los últimos 8 días.

Name: id
Type: object
Description: Identificador de fecha para las estadísticas diarias.

Name: day
Type: integer
Description: Día del mes.

Name: month
Type: integer
Description: Número de mes (1-12).

Name: total
Type: string
Description: Volumen total de transacciones del día (en USD).

Name: total_inflow_usd
Type: string
Description: Volumen total de transacciones entrantes (en USD).

Name: total_outflow_usd
Type: string
Description: Volumen total de transacciones salientes (en USD).

Name: monthly_stats
Type: array
Description: Arreglo de estadísticas mensuales de transacciones.

Name: id
Type: object
Description: Identificador de fecha para las estadísticas mensuales.

Name: month
Type: integer
Description: Número de mes (1-12).

Name: year
Type: integer
Description: Año.

Name: total_transaction
Type: integer
Description: Número total de transacciones del mes.

Name: total_volume
Type: string
Description: Volumen total de transacciones del mes (en USD).

Name: monthly_total_fee_spent_per_network
Type: array
Description: Arreglo de comisiones de red pagadas por mes, desglosadas por red blockchain.

Name: id
Type: object
Description: Identificador del registro de comisiones.

Name: month
Type: integer
Description: Número de mes (1-12).

Name: network_id
Type: string
Description: UUID de la red blockchain.

Name: year
Type: integer
Description: Año.

Name: total_fee_spent
Type: string
Description: Total de comisiones pagadas en la moneda nativa de la red.

Name: value
Type: string
Description: Total de comisiones pagadas en USD.

Name: network
Type: object
Description: Detalles de la red.

Name: name
Type: string
Description: Nombre de la red blockchain (por ejemplo, "Ethereum", "Solana mainnet", "Base").

Name: native_currency
Type: string
Description: Símbolo de la moneda nativa de la red (por ejemplo, "ETH", "SOL").

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

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

Response

200

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

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

Name
workspace_id
Type
string
Description
El UUID del espacio de trabajo del que se obtendrán los saldos.

Parámetros de consulta

Name
symbol
Type
string
Description
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

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
Arreglo con la información de saldos agrupada por símbolo.

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

Name: total_balance
Type: string
Description: Saldo total del activo en todas las redes.

Name: total_value_usd
Type: string
Description: Valor total del activo en USD.

Name: total_wallet_count
Type: integer
Description: Número total de billeteras que contienen este activo.

Name: networks
Type: array
Description: Arreglo con la información de saldos por red.

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

Name: asset_name
Type: string
Description: Nombre del activo (por ejemplo, "USDC Sepolia test").

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

Name: network_id
Type: string
Description: UUID de la red blockchain.

Name: network_name
Type: string
Description: Nombre de la red blockchain (por ejemplo, "Sepolia Ethereum Testnet", "Solana devnet").

Name: network_logo
Type: string
Description: URL de la imagen del logo de la red.

Name: balance
Type: string
Description: Saldo del activo en esta red específica.

Name: wallet_count
Type: integer
Description: Número de billeteras que contienen este activo en esta red.

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

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

Response

200

{
  "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
        }
      ]
    }
  ]
}