> ## 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. Research and information, not investment advice.
servers:
  - url: https://api.atlasyield.club/v1
security:
  - apiKey: []
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.0.0
                  count:
                    type: integer
                    example: 341
                  disclaimer:
                    type: string
                    example: Research and information, not investment advice.
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Score'
        '401':
          $ref: '#/components/responses/Unauthorized'
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 (aave-v3, morpho, beefy, aura, yearn-v3,
            pendle).
          example: aave-v3
        asset:
          type: string
          description: Underlying asset symbol.
          example: USDC
        assetClass:
          type: string
          description: Asset class bucket (e.g. stable, eth, btc).
          example: stable
        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.0.0
  responses:
    Unauthorized:
      description: Missing or invalid API key.
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Per-partner API key. The API fails closed — a missing or invalid key is
        rejected with 401.

````