{"uid":"cap_iyRRsDeqxTPvC_6dEYBqV","slug":"one-engine-numeric-clamp-top-10-cac1571e","name":"ONE Engine Numeric Clamp Top-10","description":"Low-cost pay-per-call utility APIs for autonomous agents using x402 on Base.","url":"https://one-search.one-engine.workers.dev/v3/numeric/clamp/t10?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["values"],"properties":{"max":{"type":"number"},"min":{"type":"number"},"size":{"type":"integer"},"digits":{"type":"integer"},"factor":{"type":"number"},"offset":{"type":"number"},"values":{"type":"array","description":"Finite numbers, maximum 1000"}}},"responseSchema":{"type":"object","additionalProperties":true},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UjCv3FsrUMWYhs4m1dywh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Clamps an array of up to 1000 numbers to a specified range and returns the top 10 results, with optional scaling, rounding, and offset transformations.","exampleAgentPrompt":"Clamp these numbers between 0 and 100, scale by 1.5, round to 2 decimal places, and give me the top 10: [45.3, 120, -5, 78.9, 200, 33.1, 99, 0.5, 150, 88.2, 42, 67, 11, 95, 130]","exampleUseCases":[{"title":"Bounding sensor readings to valid range","prompt":"I have 500 temperature sensor readings — some are clearly out of range. Clamp them all between -40 and 125, round to 1 decimal place, and give me the top 10 highest valid values."},{"title":"Scoring normalization for recommendation engine","prompt":"Normalize these 200 raw recommendation scores by clamping them between 0 and 1, apply a factor of 2.5 and an offset of -0.5, keep 3 decimal digits, and return the top 10."},{"title":"Ranking clamped financial signals","prompt":"Take these 300 momentum indicators, clamp them to a range of -50 to 50, scale by a factor of 0.8, and show me the top 10 highest values rounded to 2 decimal places."}],"resultDescription":"Returns a JSON object containing the top 10 numeric values from the input array after applying clamping (min/max bounds), optional scaling (factor), optional offset, and optional decimal rounding — sorted in descending order.","failureModes":["Array exceeds 1000 elements — request rejected","Non-finite numbers (Infinity, NaN) in the values array cause validation errors","Missing required 'values' field returns a 400 error","Payment not included or insufficient USDC triggers a 402 Payment Required response","Invalid types for min/max/factor/offset parameters cause schema errors"],"whenToPreferThis":"Choose this endpoint when you need a lightweight, pay-per-call numeric clamping and ranking operation without spinning up your own compute. Ideal for AI agents that occasionally need to bound, scale, and rank numeric arrays in real-time pipelines, especially when integrated with x402 micropayment flows on Base. Best for arrays up to 1000 numbers where you want the top 10 results after transformation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T12:42:56.808Z","isFirstParty":false,"canonicalSlug":"one-engine-numeric-clamp-top-10-cac1571e"}