Skip to main content
GET
/
tenant
/
{tenantId}
/
holdings
Get Tenant Assets Report
curl --request GET \
  --url https://api.example.com/tenant/{tenantId}/holdings
{
  "isSuccess": true,
  "isFailure": false,
  "error": null,
  "value": {
    "id": 42,
    "name": "Example"
  }
}

​
Description

Generates a detailed portfolio report for the specified tenant, showing all digital asset holdings across multiple blockchain networks. The report includes balance information, market values, holder counts, and transaction statistics for each asset.

​
Input

  • tenantId (long, required) — The unique identifier of the tenant whose asset holdings should be reported.
  • request (TenantAssetsReportRequest, optional) — Additional query parameters for filtering or configuring the report.
  • ct (optional) — Cancellation token for the async operation.

​
Output

Returns a TenantAssetsReportResponse containing:
  • assets (array) — Collection of asset report models, each containing:
    • Asset name and ticker symbol
    • Blockchain network and contract address
    • Current holdings and total supply
    • Wallet count and holder statistics
    • Market price and capitalization
    • Total transfer count

​
Examples

Request 
GET /api/tenants/1024/holdings
Response (200 OK) 
{
  "assets": [
    {
      "asset": "USD Coin",
      "ticker": "USDC",
      "network": "Ethereum Mainnet",
      "blockchainId": 1,
      "networkIcon": "https://...",
      "contractAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "walletsCount": 15,
      "holdings": 250000.50,
      "maxTotalSupply": 1000000000.00,
      "value": 250000.50,
      "holdersCount": 42,
      "totalTransfers": 1234,
      "price": 1.00,
      "onchainMarketCap": 28500000000.00,
      "circulatingSupply": 28500000000.00
    },
    {
      "asset": "Ethereum",
      "ticker": "ETH",
      "network": "Ethereum Mainnet",
      "blockchainId": 1,
      "networkIcon": "https://...",
      "contractAddress": "",
      "walletsCount": 20,
      "holdings": 125.75,
      "maxTotalSupply": 0,
      "value": 314375.00,
      "holdersCount": 0,
      "totalTransfers": 892,
      "price": 2500.00,
      "onchainMarketCap": 0,
      "circulatingSupply": 0
    }
  ]
}

​
Errors

  • 400 Bad Request: Invalid request parameters or tenant identifier validation failure.
  • 401 Unauthorized: Authentication credentials are missing or invalid.
  • 403 Forbidden: The authenticated user does not have permission to view this tenant’s assets report.
  • 404 Not Found: The specified tenant does not exist.
  • 500 Internal Server Error: An unexpected error occurred while generating the report.

​
Notes

The report aggregates data from all wallets and smart contracts associated with the tenant. Market values are calculated based on current pricing data. Native blockchain currencies (like ETH) will have empty contract addresses and may have zero values for on-chain market cap and circulating supply fields.

Path Parameters

​
tenantId
integer<int64>
required

The unique identifier of the tenant.

Query Parameters

​
TenantId
integer<int64>

The tenant's unique identifier.

Example:

1024

​
api-version
string | null

Response

Assets report generated successfully.

Wrapper for API operation results containing success status, error information, and return value.

​
isSuccess
boolean

True if the operation completed successfully, false otherwise.

Example:

true

​
isFailure
boolean

True if the operation failed, false otherwise.

Example:

false

​
error
object

Error information returned when the operation fails.

Example:
{
  "code": "ValidationError",
  "message": "The request parameters failed validation.",
  "info": [
    "The Name field is required.",
    "The Id field must be greater than 0."
  ]
}
​
value
object

The result value returned when the operation is successful.

Example:
{
  "assets": [
    {
      "asset": "USD Coin",
      "ticker": "USDC",
      "network": "Ethereum Mainnet",
      "blockchainId": 1,
      "networkIcon": "https://...",
      "contractAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "walletsCount": 15,
      "holdings": 250000.5,
      "maxTotalSupply": 1000000000,
      "value": 250000.5,
      "holdersCount": 42,
      "totalTransfers": 1234,
      "price": 1,
      "onchainMarketCap": 28500000000,
      "circulatingSupply": 28500000000
    }
  ]
}