Skip to main content
GET
/
v1
/
allocations
/
overview
Org Overview
curl --request GET \
  --url https://api.example.com/v1/allocations/overview
Endpoint: GET https://api.rebelfi.io/v1/allocations/overview
Get an org-level overview of all wallet allocations, scoped to the wallet profile associated with your API key. Returns aggregate metrics including total value, yield earned, average APY, and distributions by protocol, asset, and blockchain.

​
Example Request

curl -X GET "https://api.rebelfi.io/v1/allocations/overview" \
  -H "x-api-key: your_api_key"

​
Example Response

{
  "walletProfileId": 1,
  "walletProfileName": "Production",
  "totalWallets": 1250,
  "activeWallets": 980,
  "totalValueUsd": "4250000.500000",
  "totalYieldEarnedUsd": "127500.150000",
  "averageApyDecimal": 0.065,
  "protocolDistribution": [
    {
      "name": "AAVE V3",
      "valueUsd": "2550000.300000",
      "percentage": 60.0,
      "walletCount": 620
    },
    {
      "name": "Kamino",
      "valueUsd": "1700000.200000",
      "percentage": 40.0,
      "walletCount": 360
    }
  ],
  "assetDistribution": [
    {
      "name": "USDC",
      "valueUsd": "3400000.400000",
      "percentage": 80.0,
      "walletCount": 850
    },
    {
      "name": "USDT",
      "valueUsd": "850000.100000",
      "percentage": 20.0,
      "walletCount": 130
    }
  ],
  "blockchainDistribution": [
    {
      "name": "ethereum",
      "valueUsd": "2550000.300000",
      "percentage": 60.0,
      "walletCount": 620
    },
    {
      "name": "solana",
      "valueUsd": "1700000.200000",
      "percentage": 40.0,
      "walletCount": 360
    }
  ]
}

​
Response Fields

FieldTypeDescription
walletProfileIdnumberWallet profile ID associated with the API key
walletProfileNamestringWallet profile name
totalWalletsnumberTotal number of wallets in the profile
activeWalletsnumberWallets with at least one active allocation
totalValueUsdstringTotal value across all wallets (USD)
totalYieldEarnedUsdstringTotal yield earned across all wallets (USD)
averageApyDecimalnumberWeighted average APY as decimal (e.g., 0.065 for 6.5%)
protocolDistributionDistributionEntry[]Breakdown by protocol/venue
assetDistributionDistributionEntry[]Breakdown by token (USDC, USDT, etc.)
blockchainDistributionDistributionEntry[]Breakdown by blockchain network

​
DistributionEntry Object

FieldTypeDescription
namestringProtocol name, token symbol, or blockchain name
valueUsdstringTotal value in this category (USD)
percentagenumberPercentage of total value (0-100)
walletCountnumberNumber of wallets with allocations in this category
The overview is automatically scoped to the wallet profile associated with your API key. To see data for a different profile, use an API key linked to that profile.