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

# Get Asset Allocation Breakdown

> Aggregates canonical or CAIP assets into sector, industry, theme, or category buckets.

Returns deterministic category makeup for an arbitrary list of holdings. Each
holding must identify either a canonical asset (`assetCanonicalId`) or a
chain-scoped CAIP-19 asset (`caipAssetId`). CAIP assets are resolved upward to
their canonical subject before sector, industry, theme, or crypto-category
membership is loaded.

* Auth: `x-api-key` header (required)
* Scope: `portfolios:read`

Supported dimensions:

* `sector`
* `industryGroup`
* `industry`
* `subIndustry`
* `gliderSector`
* `gliderTheme`
* `cryptoCategory`

For multi-valued category dimensions, set `multiCategoryMode`:

* `primary` selects the highest-confidence category for each holding.
* `apportioned` splits each holding's weight across all matching categories.
* `overlap` assigns the full holding weight to every matching category, so
  totals can exceed 100%.

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url 'https://api.glider.fi/v2/assets/allocation-breakdown' \
    --header 'content-type: application/json' \
    --header 'x-api-key: gldr_sk_your_api_key' \
    --data '{
      "dimensions": ["sector", "industry", "gliderTheme"],
      "multiCategoryMode": "primary",
      "holdings": [
        {
          "assetCanonicalId": "11111111-1111-4111-8111-111111111111",
          "symbol": "NOW",
          "weight": "25"
        },
        {
          "caipAssetId": "eip155:56/erc20:0x2222222222222222222222222222222222222222",
          "symbol": "NVDAON",
          "weight": "75"
        }
      ]
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "normalization": {
        "inputMode": "weights",
        "normalizedTotal": "1",
        "sourceTotal": "100"
      },
      "holdings": [
        {
          "inputIndex": 0,
          "assetCanonicalId": "11111111-1111-4111-8111-111111111111",
          "caipAssetId": null,
          "symbol": "NOW",
          "name": null,
          "normalizedWeight": "0.25",
          "sourceValue": "25"
        }
      ],
      "breakdowns": [
        {
          "dimension": "sector",
          "aggregationMode": "single",
          "totalWeight": "1",
          "absoluteTotalWeight": "1",
          "totalMayExceedOne": false,
          "buckets": [
            {
              "key": "technology",
              "label": "Technology",
              "weight": "1",
              "absoluteWeight": "1",
              "holdingCount": 2,
              "holdings": []
            }
          ]
        }
      ],
      "diagnostics": {
        "unresolved": [],
        "unsupported": [],
        "unclassified": [],
        "lowConfidence": []
      }
    }
  }
  ```
</ResponseExample>