{"uid":"cap_SYjEEYaI9ChuUMShgehhp","slug":"market-intelligence-api-weighted-composite-score-c52621bd","name":"Market Intelligence API – Weighted Composite Score","description":"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.","url":"https://api.marketintelligenceapi.com/api/v1/analytics/weighted-score?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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)"}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JkplIO2-s_brUX74PHzWh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Multi-factor stock ranking score","prompt":"I have three signals for a stock — momentum at 78 with weight 2, quality at 65 with weight 3, and value at 55 with weight 1. Can you blend those into a single composite score on a 0–100 scale and show me how much each factor contributed?"},{"title":"Crypto asset composite rating","prompt":"Blend these crypto signals into one score: on-chain activity scored 90 with weight 0.5, social sentiment scored 60 with weight 0.3, and liquidity scored 75 with weight 0.2. I want the weighted composite and each factor's normalized contribution."},{"title":"Portfolio risk-adjusted composite","prompt":"I want to combine a fundamentals score of 70 (weight 40), a momentum score of 85 (weight 30), and a risk score of 55 (weight 30) into a single 0–100 composite — can you run the weighted aggregation and show me the breakdown?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:42:59.795Z","isFirstParty":false,"canonicalSlug":"market-intelligence-api-weighted-composite-score-c52621bd"}