---
title: "Average Percentile Rank"
method: POST
path: "/assets/indicators/aggregation/average-percentile-rank"
tags: ["Assets / Indicators Aggregation"]
---

# Average Percentile Rank

`POST /assets/indicators/aggregation/average-percentile-rank`

## Request

- Base URL: `https://api.portfoliooptimizer.io/v1`
- URL: `https://api.portfoliooptimizer.io/v1/assets/indicators/aggregation/average-percentile-rank`
- Auth: API key in header `X-API-Key`

Aggregate the percentile ranks of the values of different asset indicators through a simple or a weighted arithmetic averaging scheme.

References
* [Cakici, Nusret and Zaremba, Adam, Getting the Target Right in Return Prediction (April 20, 2026)](https://papers.ssrn.com/sol3/papers.cfm?abstract_id=6615698)

## Request body

- object
  - `assets` object[], required
    - `assetIndicatorsValues` number[], required: assetIndicatorsValues[i] is the value of the i-th asset indicator; all assetIndicatorsValues arrays must have the same length
  - `assetsIndicatorsValuesPercentileRankOrderingTypes` string[]: assetsIndicatorsValuesPercentileRankOrderingTypes[i] is the type of ordering to apply to the i-th asset indicator values when transforming them into percentile ranks; assetsIndicatorsValuesPercentileRankOrderingTypes must have the same length as all the assetIndicatorsValues arrays
  - `assetsIndicatorsWeights` number[]: assetsIndicatorsWeights[i] is the weight to apply to the percentile ranks of the i-th asset indicator values when aggregating them; assetsIndicatorsWeights must have the same length as all the assetIndicatorsValues arrays; the elements of assetsIndicatorsWeights must sum to 1; defaults to 1/the common length of all the assetIndicatorsValues arrays

## Response `200`

OK

- object
  - `assets` object[], required
    - `assetIndicatorValue` number, required: The average percentile rank of the asset indicator values

## Changes

- **2026-09-05** `dc61548270fb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/portfoliooptimizer/apis/portfolio-optimizer/changes/assets/indicators/aggregation/average-percentile-rank/post.md)

---

[API](https://skmtc.dev/portfoliooptimizer/apis/portfolio-optimizer.md) - [All operations](https://skmtc.dev/portfoliooptimizer/apis/portfolio-optimizer/llms.txt) - [OpenAPI document](https://skmtc.dev/portfoliooptimizer/apis/portfolio-optimizer/revisions/9d075aa717bf?raw)