# Market Intelligence API – Weighted Composite Score

> Market Intelligence API – Weighted Composite Score is a paid API for AI agents from api.marketintelligenceapi.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Combines multiple factor scores (e.g. momentum, fundamentals, risk) into a single 0–100 composite score using weighted-mean aggregation, with full transparency on normalized weights and per-factor contributions.

## Facts

- Endpoint: POST https://api.marketintelligenceapi.com/api/v1/analytics/weighted-score?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/market-intelligence-api-weighted-composite-score-c52621bd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SYjEEYaI9ChuUMShgehhp

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability market-intelligence-api-weighted-composite-score-c52621bd -d '<json body>'
```

Example prompt: Combine these three factor scores into one composite: momentum score 82 with weight 0.3, fundamentals score 74 with weight 0.4, and risk score 63 with weight 0.3 — show me the final 0–100 score with each factor's normalized weight and contribution.

## When to prefer this

Choose this endpoint when you need a transparent, reproducible weighted composite score from multiple pre-computed factor scores — especially when weights don't need to sum to 1 and you want per-factor contribution breakdowns. It performs no data fetching, so it is ideal as a pure aggregation step after you have already gathered individual factor scores from other sources. Prefer this over manual weighted averaging when you need structured, auditable output with normalized weights.

## Known failure modes

- Missing required 'score' field on any factor returns a validation error
- Providing an empty factors array (violates minItems:1) returns a 400 error
- Score value outside the specified scoreMin/scoreMax range may cause validation rejection
- Malformed JSON body returns a 400 parse error
- Payment failure (insufficient USDC balance) returns a 402 Payment Required

## How this service works

Use to combine factor scores into one composite ($0.01), e.g. momentum, fundamentals and risk: send factors {name, score, weight}; get the 0-100 score with each factor's normalised weight and contribution. Weights need not sum to 1. Transparent and reproducible, no data fetched.

## Output

Returns a JSON object containing the composite weighted-mean score (0–100 by default, or custom range), the method used (WEIGHTED_MEAN), the number of input factors, and a components array detailing each factor's name, original score, weight, normalized weight, and numeric contribution to the final score. Also includes total weight and whether weights were normalized.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "factors": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "score"
    ],
    "properties": {
     "name": {
      "type": "string",
      "maxLength": 64,
      "description": "Factor label, echoed back (default factorN)"
     },
     "score": {
      "type": "number",
      "description": "The factor's score, within the score range"
     },
     "weight": {
      "type": "number",
      "description": "Weight >= 0, default 1; normalised by the total"
     }
    }
   },
   "maxItems": 100,
   "minItems": 1,
   "description": "The factors: each a score with an optional name and weight"
  },
  "scoreMax": {
   "type": "number",
   "description": "Highest allowed score (default 100)"
  },
  "scoreMin": {
   "type": "number",
   "description": "Lowest allowed score (default 0)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "score": 73.1,
  "method": "WEIGHTED_MEAN",
  "result": 73.1,
  "factors": 3,
  "operation": "weighted-score",
  "components": [
   {
    "name": "momentum",
    "score": 82,
    "weight": 0.3,
    "contribution": 24.6,
    "normalizedWeight": 0.3
   },
   {
    "name": "fundamentals",
    "score": 74,
    "weight": 0.4,
    "contribution": 29.6,
    "normalizedWeight": 0.4
   },
   {
    "name": "risk",
    "score": 63,
    "weight": 0.3,
    "contribution": 18.9,
    "normalizedWeight": 0.3
   }
  ],
  "scoreRange": {
   "max": 100,
   "min": 0
  },
  "totalWeight": 1,
  "weightsNormalized": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/market-intelligence-api-weighted-composite-score-c52621bd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.marketintelligenceapi.com](https://www.zero.xyz/host/api.marketintelligenceapi.com/llms.txt)