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

# Factor breakdown

> The "why" behind a composite: every one of the 16 factors (15 additive across four pillars plus the multiplicative exploit-history modifier) with its sub-score, weight, raw input and a plain-English label. Served from the stored score row, so it is exactly what the engine computed at `scoredAt`, not a recomputation.



## OpenAPI

````yaml api-reference/openapi.yaml GET /vaults/{chainId}/{address}/factors
openapi: 3.1.0
info:
  title: AtlasYield API
  version: '1.0'
  description: >-
    Read-only access to the Atlas Score Index: neutral 16-factor vault scores
    across four pillars — Yield, Safety, Liquidity, Sustainability — plus the
    tracked vault catalog and the Atlas Engine, which turns those scores into a
    risk-adjusted allocation. Research and information, not investment advice.
servers:
  - url: https://api.atlasyield.club/v1
security: []
paths:
  /vaults/{chainId}/{address}/factors:
    get:
      summary: 16-factor breakdown for one vault
      description: >-
        The "why" behind a composite: every one of the 16 factors (15 additive
        across four pillars plus the multiplicative exploit-history modifier)
        with its sub-score, weight, raw input and a plain-English label. Served
        from the stored score row, so it is exactly what the engine computed at
        `scoredAt`, not a recomputation.
      operationId: getVaultFactors
      parameters:
        - name: chainId
          in: path
          required: true
          schema:
            type: integer
          example: 8453
        - name: address
          in: path
          required: true
          schema:
            type: string
          description: Vault contract address. Case-insensitive.
          example: '0x4e65fe4dba92790696d040ac24aa414708f5c0ab'
      responses:
        '200':
          description: The latest score row's factor breakdown.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  disclaimer:
                    type: string
                    example: Research and information, not investment advice.
                  data:
                    $ref: '#/components/schemas/VaultFactors'
        '400':
          $ref: '#/components/responses/ValidationError'
        '404':
          description: The vault is not in the scored universe.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: No score found for this vault
components:
  schemas:
    VaultFactors:
      type: object
      properties:
        vaultId:
          type: string
          example: aave-v3:8453:0x4e65fe4dba92790696d040ac24aa414708f5c0ab
        chainId:
          type: integer
          example: 8453
        protocolId:
          type: string
          example: aave-v3
        composite:
          type: number
          example: 87.5
        label:
          type: string
          enum:
            - Conservative
            - Balanced
            - Aggressive
        pillarScores:
          type: object
          properties:
            yield:
              type: number
            safety:
              type: number
            liquidity:
              type: number
            sustainability:
              type: number
        factors:
          type: object
          description: >-
            All 16 factors keyed by name: YIELD_LEVEL, APY_STABILITY,
            APY_PERSISTENCE, YIELD_SOURCE, AUDIT_QUALITY, PROTOCOL_MATURITY,
            TVL_DEPTH_SAFETY, TVL_STABILITY, ADMIN_TOPOLOGY, CHAIN_SECURITY,
            EXPLOIT_HISTORY, WITHDRAWAL_TYPE, TVL_DEPTH_LIQUIDITY,
            EMISSION_DEPENDENCY, ASSET_RISK, UTILIZATION_HEALTH.
          additionalProperties:
            $ref: '#/components/schemas/FactorResult'
        dataQuality:
          type: string
          enum:
            - sufficient
            - partial
            - fallback
        scoredAt:
          type: string
          format: date-time
        scorerVersion:
          type: string
          example: 2.1.0
    FactorResult:
      type: object
      properties:
        score:
          type: number
          description: Sub-score 0–100. For EXPLOIT_HISTORY this is multiplier × 100.
          example: 82
        weight:
          type: number
          description: >-
            Weight inside its pillar's arithmetic mean. 0 for EXPLOIT_HISTORY
            (multiplicative).
          example: 0.3
        rawValue:
          type: number
          description: >-
            The raw input that drove the score (TVL USD, audit count, slope,
            ...).
          example: 5.2
        label:
          type: string
          description: Plain-English description of the input.
          example: 5.2% APY, stablecoin
        pillar:
          type: string
          enum:
            - yield
            - safety
            - liquidity
            - sustainability
  responses:
    ValidationError:
      description: >-
        A query parameter is missing or out of range. The body carries per-field
        detail under `details.fieldErrors`.
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                example: false
              error:
                type: string
                example: Validation error
              details:
                type: object
                description: Zod field errors, keyed by parameter name.

````