> ## 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.

# Latest scores

> The most recent composite + pillar scores for every tracked vault — one row per vault, newest first.



## OpenAPI

````yaml api-reference/openapi.yaml GET /scores
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:
  /scores:
    get:
      summary: Latest scores
      description: >-
        The most recent composite + pillar scores for every tracked vault — one
        row per vault, newest first.
      operationId: getScores
      parameters:
        - name: chainId
          in: query
          required: false
          schema:
            type: integer
          description: Filter to one EVM chain id.
          example: 8453
        - name: protocolId
          in: query
          required: false
          schema:
            type: string
          description: Filter to one protocol slug.
          example: morpho
      responses:
        '200':
          description: Latest scores for all tracked vaults.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  scorerVersion:
                    type: string
                    example: 2.1.0
                  count:
                    type: integer
                    example: 570
                  disclaimer:
                    type: string
                    example: Research and information, not investment advice.
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Score'
components:
  schemas:
    Score:
      type: object
      properties:
        vaultId:
          type: string
          description: 'Stable identifier: protocol:chainId:address.'
          example: aave-v3:8453:0x4e65fe4dba92790696d040ac24aa414708f5c0ab
        chainId:
          type: integer
          description: EVM chain id (e.g. 1 Ethereum, 8453 Base, 42161 Arbitrum).
          example: 8453
        protocolId:
          type: string
          description: >-
            Adapter/protocol slug. Currently one of beefy, yearn-v3, morpho,
            pendle, aave-v3, euler, etherfi, ethena. New adapters are added over
            time — treat this as an open set rather than a fixed enum.
          example: aave-v3
        name:
          type: string
          nullable: true
          description: >-
            Human-readable vault name, the same string /catalog reports, so no
            join is needed. Null only when the vault is absent from the live
            catalog cache.
          example: Aave V3 USDC
        asset:
          type: string
          description: Underlying asset symbol.
          example: USDC
        assetClass:
          type: string
          nullable: true
          enum:
            - stablecoin
            - stablecoin-yield
            - eth
            - btc
            - top50
            - usd-exotic
            - other
          description: >-
            Asset class bucket used to contextualise the yield factors. May be
            null.
          example: stablecoin
        composite:
          type: number
          description: 0–100 composite Atlas Score.
          example: 87.5
        label:
          type: string
          enum:
            - Conservative
            - Balanced
            - Aggressive
          description: Risk-posture band for the composite.
        pillarScores:
          type: object
          description: The four pillar scores, 0–100 each.
          properties:
            yield:
              type: number
              example: 82
            safety:
              type: number
              example: 90
            liquidity:
              type: number
              example: 88
            sustainability:
              type: number
              example: 85
        apy:
          type: number
          nullable: true
          description: Current APY in percentage points (5.21 = 5.21%). May be null.
          example: 5.21
        tvl:
          type: number
          nullable: true
          description: Total value locked, USD. May be null.
          example: 1250400
        dataQuality:
          type: string
          enum:
            - sufficient
            - partial
            - fallback
          description: How complete the inputs were.
        scoredAt:
          type: string
          format: date-time
          description: ISO-8601 UTC timestamp the score was computed (ex-ante, immutable).
        scorerVersion:
          type: string
          description: Scoring engine version that produced the row.
          example: 2.1.0

````