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

# Measure portfolio exposure across strategies

> Measures how the supplied portfolio overlaps with each strategy visible to the caller. For every owned or public non-archived strategy, the response reports the portfolio's overlap, exposure, and returns against that strategy's latest completed run, sorted by exposure from highest to lowest.



## OpenAPI

````yaml /api-reference/openapi-v2.json post /strategies/exposures
openapi: 3.0.0
info:
  title: Noonum API v2
  version: 2.0.0
  contact:
    name: Noonum Support
    email: hello@noonum.com
  description: >
    Create and manage investment strategies, portfolios, and backtests. The API
    covers the full strategy lifecycle, including creation and editing, the
    archive and revive flow, version submission and run state, result companies,
    evidence, factsheets, exposures, and taxonomy.
servers:
  - url: https://api.noonum.ai/v2
security:
  - bearerAuth: []
tags:
  - name: UserStrategies
    description: Create, read, update, and manage your own investment strategies.
  - name: Helper
    description: >-
      Shared utilities for company lookup and search, objective tooling, and a
      health check.
  - name: Portfolios
    description: Create, read, update, and delete portfolios.
  - name: Backtest
    description: Run a standalone backtest on a portfolio of companies.
paths:
  /strategies/exposures:
    post:
      tags:
        - UserStrategies
      summary: Measure portfolio exposure across strategies
      description: >-
        Measures how the supplied portfolio overlaps with each strategy visible
        to the caller. For every owned or public non-archived strategy, the
        response reports the portfolio's overlap, exposure, and returns against
        that strategy's latest completed run, sorted by exposure from highest to
        lowest.
      operationId: app.api.v2.strategies.exposures
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - companiesWeight
              properties:
                strategyIds:
                  type: array
                  description: >-
                    Strategies to score. When empty or omitted, all of the
                    caller's visible strategies are scored, meaning every owned
                    or public non-archived strategy.
                  minItems: 0
                  items:
                    type: string
                    format: uuid
                companiesWeight:
                  type: object
                  description: >-
                    The portfolio to measure exposure against, given as a map of
                    company ID to weight. Each weight is between 0 and 1.
                  additionalProperties:
                    type: number
                    format: float
                    minimum: 0
                    maximum: 1
                returnDateRange:
                  type: string
                  description: Window over which the returns figure is computed.
                  enum:
                    - 1-month
                    - 6-month
                    - 1-year
                    - 5-year
                  default: 1-year
      responses:
        '200':
          description: >-
            One exposure row per strategy, sorted by exposure from highest to
            lowest.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  description: The supplied portfolio's exposure to one strategy.
                  required:
                    - id
                    - name
                    - overlap
                    - exposure
                    - returns
                  properties:
                    id:
                      description: Identifier of the strategy.
                      type: string
                      format: uuid
                    name:
                      description: Name of the strategy.
                      type: string
                    overlap:
                      description: >-
                        Fraction of the portfolio's holdings that also appear in
                        the strategy.
                      type: number
                      format: float
                    exposure:
                      description: >-
                        Portfolio weight allocated to companies that appear in
                        the strategy.
                      type: number
                      format: float
                    returns:
                      description: >-
                        The portfolio's return over the requested window,
                        attributed to the strategy.
                      type: number
                      format: float
        '400':
          description: >-
            The `companiesWeight` field is missing or `returnDateRange` is
            invalid.
        '500':
          description: Internal server error.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT or API Key
      description: |
        Enter 'Bearer' followed by a space and then your JWT or API Key.
        Example: `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`
        or `Bearer YOUR_API_KEY_HERE`

````