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

# Org Overview

> GET /v1/allocations/overview — Aggregated metrics across all wallets

<Note>
  **Endpoint:** `GET https://api.rebelfi.io/v1/allocations/overview`
</Note>

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

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.rebelfi.io/v1/allocations/overview" \
    -H "x-api-key: your_api_key"
  ```

  ```typescript SDK theme={null}
  const overview = await client.allocations.overview();
  ```
</CodeGroup>

### Example Response

```json theme={null}
{
  "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

| Field                    | Type                  | Description                                            |
| ------------------------ | --------------------- | ------------------------------------------------------ |
| `walletProfileId`        | `number`              | Wallet profile ID associated with the API key          |
| `walletProfileName`      | `string`              | Wallet profile name                                    |
| `totalWallets`           | `number`              | Total number of wallets in the profile                 |
| `activeWallets`          | `number`              | Wallets with at least one active allocation            |
| `totalValueUsd`          | `string`              | Total value across all wallets (USD)                   |
| `totalYieldEarnedUsd`    | `string`              | Total yield earned across all wallets (USD)            |
| `averageApyDecimal`      | `number`              | Weighted average APY as decimal (e.g., 0.065 for 6.5%) |
| `protocolDistribution`   | `DistributionEntry[]` | Breakdown by protocol/venue                            |
| `assetDistribution`      | `DistributionEntry[]` | Breakdown by token (USDC, USDT, etc.)                  |
| `blockchainDistribution` | `DistributionEntry[]` | Breakdown by blockchain network                        |

### DistributionEntry Object

| Field         | Type     | Description                                         |
| ------------- | -------- | --------------------------------------------------- |
| `name`        | `string` | Protocol name, token symbol, or blockchain name     |
| `valueUsd`    | `string` | Total value in this category (USD)                  |
| `percentage`  | `number` | Percentage of total value (0-100)                   |
| `walletCount` | `number` | Number of wallets with allocations in this category |

<Info>
  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.
</Info>