Concentration | termina | Documentation

curl -G https://app.termina.ai/api/v1/group/1/deal/1/data/concentration \
     -H "Authorization: Bearer <token>" \
     -d user_type=business \
     -d metric=metric

{
  "time_series_metrics": [
    {
      "date": "2026-01",
      "top_5_count": 5,
      "top_10_count": 10,
      "top_20_count": 20,
      "top_10_percent": 0.1,
      "top_20_percent": 0.2,
      "mean": 100,
      "p25": 50,
      "median": 100,
      "p75": 150,
      "p90": 200,
      "average_to_median": 1.5,
      "gini_coefficient": 0.7
    }
  ],
  "endpoint_top_users": [
    {
      "user_id": "user_1",
      "amount": 100,
      "amount_percent": 0.1
    }
  ],
  "endpoint_cdf": [
    {
      "method": "top_user",
      "amount": 100,
      "cdf_users": 0.7,
      "cdf_amount": 0.88
    }
  ]
}

Get the product concentration for the company associated with the deal.

curl -G https://app.termina.ai/api/v1/group/1/deal/1/data/concentration \
     -H "Authorization: Bearer <token>" \
     -d user_type=business \
     -d metric=metric

{
  "time_series_metrics": [
    {
      "date": "2026-01",
      "top_5_count": 5,
      "top_10_count": 10,
      "top_20_count": 20,
      "top_10_percent": 0.1,
      "top_20_percent": 0.2,
      "mean": 100,
      "p25": 50,
      "median": 100,
      "p75": 150,
      "p90": 200,
      "average_to_median": 1.5,
      "gini_coefficient": 0.7
    }
  ],
  "endpoint_top_users": [
    {
      "user_id": "user_1",
      "amount": 100,
      "amount_percent": 0.1
    }
  ],
  "endpoint_cdf": [
    {
      "method": "top_user",
      "amount": 100,
      "cdf_users": 0.7,
      "cdf_amount": 0.88
    }
  ]
}

Get the product concentration for the company associated with the deal.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

group_idintegerRequired

deal_idintegerRequired

Query parameters

user_typeenumRequired

metricstringRequired

freqenumOptional

Allowed values:

Response

Successful Response

time_series_metricslist of objects or null

The time series metrics for the concentration of the amount. The top 5, 10, and 20 users are shown, as well as the top 10% and 20% of users, and some other supporting aggregate concentration metrics.

endpoint_top_userslist of objects

Detail for the top users at the endpoint. Up to the top 100 users are show.

endpoint_cdflist of objects

The detailed cumulative distribution function (CDF). The CDF is presented at the top 100 users, and beyond that it is presented at approximately evenly spaced quantiles. This approach enables robustness to extremely large user bases. The CDF is presented for both users and amount.

Errors

422

Unprocessable Entity Error

$	curl -G https://app.termina.ai/api/v1/group/1/deal/1/data/concentration \
>	-H "Authorization: Bearer <token>" \
>	-d user_type=business \
>	-d metric=metric

1	{
2	"time_series_metrics": [
3	{
4	"date": "2026-01",
5	"top_5_count": 5,
6	"top_10_count": 10,
7	"top_20_count": 20,
8	"top_10_percent": 0.1,
9	"top_20_percent": 0.2,
10	"mean": 100,
11	"p25": 50,
12	"median": 100,
13	"p75": 150,
14	"p90": 200,
15	"average_to_median": 1.5,
16	"gini_coefficient": 0.7
17	}
18	],
19	"endpoint_top_users": [
20	{
21	"user_id": "user_1",
22	"amount": 100,
23	"amount_percent": 0.1
24	}
25	],
26	"endpoint_cdf": [
27	{
28	"method": "top_user",
29	"amount": 100,
30	"cdf_users": 0.7,
31	"cdf_amount": 0.88
32	}
33	]
34	}