Skip to main content
POST
/
v2
/
assets
/
allocation-breakdown
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"
      }
    ]
  }'

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

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.

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%.
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"
      }
    ]
  }'

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