{"uid":"cap_5FBTO2DXBBPnIvveoQUt_","slug":"duo-data-utilities-descriptive-statistics-64f18492","name":"Duo Data Utilities – Descriptive Statistics","description":"Descriptive statistics for a supplied numeric array in one call: count, sum, mean, median, mode, variance and standard deviation with variance and standard deviation honouring ddof (default 1, the sample form; 0 gives the population form) and always-population *_population fields, min, max, range, the quartiles and interquartile range, skewness, kurtosis, and any requested percentiles. Percentiles use a named interpolation method so the result is reproducible rather than implementation-defined.","url":"https://api.duoleads.com/v1/num/stats?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["values"],"properties":{"ddof":{"type":"string","default":"1","pattern":"^[+-]?\\d+$","maxLength":64,"description":"Delta degrees of freedom for variance/stdev: 1 (default, sample, n-1) or 0 (population, n). The *_population fields are always population."},"method":{"enum":["linear","nearest","lower","higher","midpoint"],"type":"string","default":"linear","maxLength":64,"description":"Percentile interpolation (NumPy/R names): linear (default), nearest, lower, higher, midpoint."},"values":{"type":"string","maxLength":4096,"description":"Comma-separated finite numbers, at most 500 values."},"percentiles":{"type":"string","default":"25,50,75","maxLength":256,"description":"Comma-separated percentiles 0-100, at most 20. Default 25,50,75."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","route","version","data","meta"],"properties":{"ok":{"const":true},"data":{"type":"object","required":["n","sum","mean","median","mode","ddof","variance","stdev","variance_population","stdev_population","min","max","range","q1","q3","iqr","skewness","kurtosis_excess","percentiles","method","outliers_tukey"],"properties":{"n":{"type":"integer"},"q1":{"type":["number","null"]},"q3":{"type":["number","null"]},"iqr":{"type":["number","null"]},"max":{"type":"number"},"min":{"type":"number"},"sum":{"type":["number","null"]},"ddof":{"type":"integer"},"mean":{"type":["number","null"]},"mode":{"type":["array","null"],"items":{"type":"number"}},"range":{"type":["number","null"]},"stdev":{"type":["number","null"]},"median":{"type":["number","null"]},"method":{"type":"string"},"skewness":{"type":["number","null"]},"variance":{"type":["number","null"]},"percentiles":{"type":"object","description":"keyed by caller-chosen names","additionalProperties":{"type":["number","null"]}},"outliers_tukey":{"type":"array","items":{"type":"number"}},"kurtosis_excess":{"type":["number","null"]},"stdev_population":{"type":["number","null"]},"variance_population":{"type":["number","null"]}}},"meta":{"type":"object","required":["request_id","computed_at","price_usd","deterministic","disclaimer"],"properties":{"sources":{"type":"array","items":{"type":"object","required":["id","version","published"]}},"price_usd":{"type":"string"},"disclaimer":{"type":"string"},"request_id":{"type":"string"},"computed_at":{"type":"string","description":"RFC 3339 UTC with milliseconds"},"deterministic":{"type":"boolean"}}},"route":{"const":"/v1/num/stats"},"version":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"data":{"n":5,"q1":2,"q3":4,"iqr":2,"max":5,"min":1,"sum":15,"ddof":1,"mean":3,"mode":null,"range":4,"stdev":1.58113883008419,"median":3,"method":"linear","skewness":0,"variance":2.5,"percentiles":{"25":2,"50":3,"75":4},"outliers_tukey":[],"kurtosis_excess":-1.199999999999999,"stdev_population":1.414213562373095,"variance_population":2},"meta":{"price_usd":"0.05","disclaimer":"Factual output of a deterministic computation over public data. Provided as is, with no warranty of accuracy, completeness or availability. Not investment, financial, legal, tax, medical or any other professional advice, and not a recommendation. Verify before relying on it. Terms: https://api.duoleads.com/terms","request_id":"01K6B7Q4ZC8H3F2M9WXR5TYN0D","computed_at":"2026-09-28T12:00:00.000Z","deterministic":true},"route":"/v1/num/stats","version":"1.0.0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7BrA-b7lttOQDaCL-LRBw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes comprehensive descriptive statistics (count, mean, median, mode, variance, stdev, quartiles, skewness, kurtosis, percentiles, and more) for a supplied numeric array in a single call.","exampleAgentPrompt":"Can you give me a full statistical summary for these numbers: 4, 7, 13, 2, 19, 8, 5, 11 — including mean, median, standard deviation, quartiles, skewness, and kurtosis, using linear interpolation for percentiles?","exampleUseCases":[{"title":"Summarize student test score distribution","prompt":"I have these student exam scores: 55, 62, 70, 71, 75, 78, 80, 82, 85, 90, 95 — can you compute the full statistical summary including quartiles, skewness, and the 10th and 90th percentiles using linear interpolation?"},{"title":"Compare sample vs population variance for sensor readings","prompt":"Here are some sensor temperature readings: 22.1, 22.4, 21.9, 23.0, 22.7, 21.8, 22.6 — calculate the descriptive stats and make sure I get both sample and population variance and standard deviation."},{"title":"Detect outliers in monthly revenue figures","prompt":"Run a stats summary on these monthly revenue numbers: 4200, 4350, 4100, 4500, 9800, 4250, 4400, 4300 — I want to see the IQR, Tukey outliers, median, and mean so I can spot any anomalies."}],"resultDescription":"A JSON object containing: n (count), sum, mean, median, mode, variance (sample and population), standard deviation (sample and population), min, max, range, q1, q3, iqr, skewness, excess kurtosis, percentiles keyed by requested values, Tukey outliers list, plus metadata including request_id, computed_at timestamp, price, and a deterministic flag.","failureModes":["Missing or empty 'values' parameter returns a validation error","Non-numeric or non-finite values in the array cause a parse/validation error","More than 500 values provided exceeds the array size limit","More than 20 percentiles requested exceeds the percentile limit","Invalid 'method' enum value returns a validation error","Invalid 'ddof' value (non-integer) causes a parameter error","Payment of 0.05 USDC not fulfilled results in HTTP 402"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, reproducible statistical summary of a numeric dataset in a single API call, especially when you need both sample and population variance/stdev, multiple named percentiles with a specified interpolation method, or distributional shape metrics like skewness and kurtosis — without building your own stats library or running a Python/R environment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:44:59.545Z","isFirstParty":false,"canonicalSlug":"duo-data-utilities-descriptive-statistics-64f18492"}