{"openapi":"3.1.0","info":{"title":"Basic Utils Agent","version":"1.0.0","description":"A versatile utility agent offering calculator, statistics, datetime, and unit conversion services.","x-guidance":"Use the default explain_service and ask_question endpoints before calling the paid service endpoint.","contact":{"email":"basic-utils@mymail.com"}},"paths":{"/health":{"get":{"operationId":"getHealth","summary":"Health check","description":"Simple check to ensure the application is running.","tags":["Health"],"security":[],"responses":{"200":{"description":"Service is healthy","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"message":{"type":"string"},"timestamp":{"type":"number","description":"Unix timestamp"}},"required":["status","message"]}}}}}}},"/explain_service":{"get":{"operationId":"explainService","summary":"Get detailed information about this service","tags":["service"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0015"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Service information","content":{"application/json":{"schema":{"properties":{"name":{"description":"The name of the agent","title":"Name","type":"string"},"mission":{"description":"The agent's mission and what they can do for you","title":"Mission","type":"string"},"endpoints":{"description":"The agent's service endpoints / You options to interact with the agent","items":{"additionalProperties":true,"type":"object"},"title":"Endpoints","type":"array"}},"required":["name","mission","endpoints"],"title":"ServiceDetailsResponse","type":"object"}}}},"402":{"description":"Payment Required"}}}},"/ask_question":{"post":{"operationId":"askQuestion","summary":"Ask questions before using the service","tags":["service"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"question":{"description":"Ask a question before purchasing the service!","title":"Question","type":"string"}},"required":["question"],"title":"QuestionAboutServiceRequest","type":"object"}}}},"responses":{"200":{"description":"Answer to the question","content":{"application/json":{"schema":{"properties":{"answer":{"description":"The agent's answer to your question.","title":"Answer","type":"string"}},"required":["answer"],"title":"QuestionAboutServiceResponse","type":"object"}}}},"402":{"description":"Payment Required"}}}},"/calculator":{"post":{"operationId":"calculator","summary":"Evaluate mathematical expressions and perform arithmetic operations.","tags":["math","calculator"],"responses":{"200":{"description":"Evaluate mathematical expressions and perform arithmetic operations.","content":{"application/json":{"schema":{"properties":{"expression":{"description":"The original mathematical expression that was evaluated","title":"Expression","type":"string"},"result":{"description":"The result of evaluating the mathematical expression","title":"Result","type":"number"}},"required":["expression","result"],"title":"CalculatorResponse","type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0015"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"expression":{"description":"Mathematical expression to evaluate (e.g., '2+2', '10*5')","title":"Expression","type":"string"}},"required":["expression"],"title":"CalculatorRequest","type":"object"}}}}}},"/statistics/mean":{"post":{"operationId":"statisticsMean","summary":"Compute the mean (average) of your dataset.","tags":["statistics"],"responses":{"200":{"description":"Compute the mean (average) of your dataset.","content":{"application/json":{"schema":{"properties":{"mean":{"description":"The mean (average) of the dataset","title":"Mean","type":"number"}},"required":["mean"],"title":"StatisticalMeanResponse","type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"data":{"description":"List of numeric values for statistical analysis. Maximum length: 10000","items":{"type":"number"},"title":"Data","type":"array"}},"required":["data"],"title":"StatisticsRequest","type":"object"}}}}}},"/statistics/median":{"post":{"operationId":"statisticsMedian","summary":"Compute the median (middle value) of your dataset.","tags":["statistics"],"responses":{"200":{"description":"Compute the median (middle value) of your dataset.","content":{"application/json":{"schema":{"properties":{"median":{"description":"The median (middle value) of the dataset","title":"Median","type":"number"}},"required":["median"],"title":"StatisticalMedianResponse","type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"data":{"description":"List of numeric values for statistical analysis. Maximum length: 10000","items":{"type":"number"},"title":"Data","type":"array"}},"required":["data"],"title":"StatisticsRequest","type":"object"}}}}}},"/statistics/mode":{"post":{"operationId":"statisticsMode","summary":"Compute the mode (most frequent value) of your dataset.","tags":["statistics"],"responses":{"200":{"description":"Compute the mode (most frequent value) of your dataset.","content":{"application/json":{"schema":{"properties":{"mode":{"description":"The mode (most frequent value(s)) of the dataset","items":{"type":"number"},"title":"Mode","type":"array"}},"required":["mode"],"title":"StatisticalModeResponse","type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"data":{"description":"List of numeric values for statistical analysis. Maximum length: 10000","items":{"type":"number"},"title":"Data","type":"array"}},"required":["data"],"title":"StatisticsRequest","type":"object"}}}}}},"/statistics/stddev":{"post":{"operationId":"statisticsStddev","summary":"Compute the standard deviation (measure of spread) of your dataset.","tags":["statistics"],"responses":{"200":{"description":"Compute the standard deviation (measure of spread) of your dataset.","content":{"application/json":{"schema":{"properties":{"stddev":{"description":"The standard deviation of the dataset","title":"Stddev","type":"number"}},"required":["stddev"],"title":"StatisticalStddevResponse","type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"data":{"description":"List of numeric values for statistical analysis. Maximum length: 10000","items":{"type":"number"},"title":"Data","type":"array"}},"required":["data"],"title":"StatisticsRequest","type":"object"}}}}}},"/statistics/variance":{"post":{"operationId":"statisticsVariance","summary":"Compute the variance (squared standard deviation) of your dataset.","tags":["statistics"],"responses":{"200":{"description":"Compute the variance (squared standard deviation) of your dataset.","content":{"application/json":{"schema":{"properties":{"variance":{"description":"The variance of the dataset","title":"Variance","type":"number"}},"required":["variance"],"title":"StatisticalVarianceResponse","type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"data":{"description":"List of numeric values for statistical analysis. Maximum length: 10000","items":{"type":"number"},"title":"Data","type":"array"}},"required":["data"],"title":"StatisticsRequest","type":"object"}}}}}},"/statistics/min-max":{"post":{"operationId":"statisticsMinmax","summary":"Compute the minimum and maximum values of your dataset.","tags":["statistics"],"responses":{"200":{"description":"Compute the minimum and maximum values of your dataset.","content":{"application/json":{"schema":{"properties":{"min":{"description":"The minimum value of the dataset","title":"Min","type":"number"},"max":{"description":"The maximum value of the dataset","title":"Max","type":"number"}},"required":["min","max"],"title":"StatisticalMinMaxResponse","type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"data":{"description":"List of numeric values for statistical analysis. Maximum length: 10000","items":{"type":"number"},"title":"Data","type":"array"}},"required":["data"],"title":"StatisticsRequest","type":"object"}}}}}},"/statistics/range":{"post":{"operationId":"statisticsRange","summary":"Compute the range (max - min) of your dataset.","tags":["statistics"],"responses":{"200":{"description":"Compute the range (max - min) of your dataset.","content":{"application/json":{"schema":{"properties":{"range":{"description":"The range (max - min) of the dataset","title":"Range","type":"number"}},"required":["range"],"title":"StatisticalRangeResponse","type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"data":{"description":"List of numeric values for statistical analysis. Maximum length: 10000","items":{"type":"number"},"title":"Data","type":"array"}},"required":["data"],"title":"StatisticsRequest","type":"object"}}}}}},"/statistics/summary":{"post":{"operationId":"statisticsSummary","summary":"Compute a comprehensive summary of statistics (mean, median, mode, stddev, variance, min, max, range) for a dataset.","tags":["statistics"],"responses":{"200":{"description":"Compute a comprehensive summary of statistics (mean, median, mode, stddev, variance, min, max, range) for a dataset.","content":{"application/json":{"schema":{"properties":{"mean":{"description":"The mean (average) of the dataset","title":"Mean","type":"number"},"median":{"description":"The median (middle value) of the dataset","title":"Median","type":"number"},"mode":{"description":"The mode (most frequent value(s)) of the dataset","items":{"type":"number"},"title":"Mode","type":"array"},"stddev":{"description":"The standard deviation of the dataset","title":"Stddev","type":"number"},"variance":{"description":"The variance of the dataset","title":"Variance","type":"number"},"min":{"description":"The minimum value of the dataset","title":"Min","type":"number"},"max":{"description":"The maximum value of the dataset","title":"Max","type":"number"},"range":{"description":"The range (max - min) of the dataset","title":"Range","type":"number"}},"required":["mean","median","mode","stddev","variance","min","max","range"],"title":"StatisticsSummaryResponse","type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"data":{"description":"List of numeric values for statistical analysis. Maximum length: 10000","items":{"type":"number"},"title":"Data","type":"array"}},"required":["data"],"title":"StatisticsRequest","type":"object"}}}}}},"/datetime/now":{"post":{"operationId":"datetimeNow","summary":"Get the current timestamp.","tags":["datetime"],"responses":{"200":{"description":"Get the current timestamp.","content":{"application/json":{"schema":{"properties":{"now":{"description":"The current timestamp","format":"date-time","title":"Now","type":"string"}},"required":["now"],"title":"DatetimeNowResponse","type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0015"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"The base date for the operation (required for add, subtract, difference, and day-of-week operations)","title":"Date"},"days":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Number of days to add or subtract from the date (required for add and subtract operations)","title":"Days"},"date2":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"The second date for difference calculation (required for difference operation)","title":"Date2"}},"title":"DatetimeRequest","type":"object"}}}}}},"/datetime/add":{"post":{"operationId":"datetimeAdd","summary":"Add days to a given date.","tags":["datetime"],"responses":{"200":{"description":"Add days to a given date.","content":{"application/json":{"schema":{"properties":{"result":{"description":"The resulting date after adding the specified number of days to the base date","format":"date-time","title":"Result","type":"string"}},"required":["result"],"title":"DatetimeAddResponse","type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0015"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"The base date for the operation (required for add, subtract, difference, and day-of-week operations)","title":"Date"},"days":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Number of days to add or subtract from the date (required for add and subtract operations)","title":"Days"},"date2":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"The second date for difference calculation (required for difference operation)","title":"Date2"}},"title":"DatetimeRequest","type":"object"}}}}}},"/datetime/subtract":{"post":{"operationId":"datetimeSubtract","summary":"Subtract days from a given date.","tags":["datetime"],"responses":{"200":{"description":"Subtract days from a given date.","content":{"application/json":{"schema":{"properties":{"result":{"description":"The resulting date after subtracting the specified number of days from the base date","format":"date-time","title":"Result","type":"string"}},"required":["result"],"title":"DatetimeSubtractResponse","type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0015"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"The base date for the operation (required for add, subtract, difference, and day-of-week operations)","title":"Date"},"days":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Number of days to add or subtract from the date (required for add and subtract operations)","title":"Days"},"date2":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"The second date for difference calculation (required for difference operation)","title":"Date2"}},"title":"DatetimeRequest","type":"object"}}}}}},"/datetime/difference":{"post":{"operationId":"datetimeDifference","summary":"Calculate the difference (in days) between two dates.","tags":["datetime"],"responses":{"200":{"description":"Calculate the difference (in days) between two dates.","content":{"application/json":{"schema":{"properties":{"difference":{"description":"The difference in days between the two provided dates","title":"Difference","type":"integer"}},"required":["difference"],"title":"DatetimeDifferenceResponse","type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0015"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"The base date for the operation (required for add, subtract, difference, and day-of-week operations)","title":"Date"},"days":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Number of days to add or subtract from the date (required for add and subtract operations)","title":"Days"},"date2":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"The second date for difference calculation (required for difference operation)","title":"Date2"}},"title":"DatetimeRequest","type":"object"}}}}}},"/datetime/day-of-week":{"post":{"operationId":"datetimeDayOfWeek","summary":"Get the day of the week for a given date.","tags":["datetime"],"responses":{"200":{"description":"Get the day of the week for a given date.","content":{"application/json":{"schema":{"properties":{"day_of_week":{"description":"The day of the week for the given date (e.g., 'Monday')","title":"Day Of Week","type":"string"}},"required":["day_of_week"],"title":"DatetimeDayOfWeekResponse","type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0015"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"The base date for the operation (required for add, subtract, difference, and day-of-week operations)","title":"Date"},"days":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Number of days to add or subtract from the date (required for add and subtract operations)","title":"Days"},"date2":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"The second date for difference calculation (required for difference operation)","title":"Date2"}},"title":"DatetimeRequest","type":"object"}}}}}},"/convert/length":{"post":{"operationId":"converterLength","summary":"Convert between length units (meters, feet, miles, kilometers, etc.).","tags":["conversion","length"],"responses":{"200":{"description":"Convert between length units (meters, feet, miles, kilometers, etc.).","content":{"application/json":{"schema":{"properties":{"original_value":{"description":"The original value before conversion","title":"Original Value","type":"number"},"original_unit":{"description":"The original unit of the value","title":"Original Unit","type":"string"},"converted_value":{"description":"The value after conversion to the target unit","title":"Converted Value","type":"number"},"target_unit":{"description":"The unit to which the value was converted","title":"Target Unit","type":"string"},"conversion_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"The conversion rate from the source unit to the target unit (if applicable)","title":"Conversion Rate"}},"required":["original_value","original_unit","converted_value","target_unit"],"title":"LengthConverterResponse","type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"value":{"description":"The numeric value to convert","title":"Value","type":"number"},"source_unit":{"description":"The source unit of the value (e.g., 'meters', 'feet', 'kg', 'lbs')","title":"Source Unit","type":"string"},"target_unit":{"description":"The target unit to convert to (e.g., 'kilometers', 'miles', 'grams', 'ounces')","title":"Target Unit","type":"string"}},"required":["value","source_unit","target_unit"],"title":"UnitConverterRequest","type":"object"}}}}}},"/convert/weight":{"post":{"operationId":"converterWeight","summary":"Convert between weight units (kilograms, pounds, grams, ounces, etc.).","tags":["conversion","weight"],"responses":{"200":{"description":"Convert between weight units (kilograms, pounds, grams, ounces, etc.).","content":{"application/json":{"schema":{"properties":{"original_value":{"description":"The original value before conversion","title":"Original Value","type":"number"},"original_unit":{"description":"The original unit of the value","title":"Original Unit","type":"string"},"converted_value":{"description":"The value after conversion to the target unit","title":"Converted Value","type":"number"},"target_unit":{"description":"The unit to which the value was converted","title":"Target Unit","type":"string"},"conversion_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"The conversion rate from the source unit to the target unit (if applicable)","title":"Conversion Rate"}},"required":["original_value","original_unit","converted_value","target_unit"],"title":"WeightConverterResponse","type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"value":{"description":"The numeric value to convert","title":"Value","type":"number"},"source_unit":{"description":"The source unit of the value (e.g., 'meters', 'feet', 'kg', 'lbs')","title":"Source Unit","type":"string"},"target_unit":{"description":"The target unit to convert to (e.g., 'kilometers', 'miles', 'grams', 'ounces')","title":"Target Unit","type":"string"}},"required":["value","source_unit","target_unit"],"title":"UnitConverterRequest","type":"object"}}}}}},"/convert/temperature":{"post":{"operationId":"converterTemperature","summary":"Convert between temperature units (Celsius, Fahrenheit, Kelvin).","tags":["conversion","temperature"],"responses":{"200":{"description":"Convert between temperature units (Celsius, Fahrenheit, Kelvin).","content":{"application/json":{"schema":{"properties":{"original_value":{"description":"The original temperature value before conversion","title":"Original Value","type":"number"},"original_unit":{"description":"The original temperature unit (e.g., 'Celsius', 'Fahrenheit', 'Kelvin')","title":"Original Unit","type":"string"},"converted_value":{"description":"The temperature value after conversion to the target unit","title":"Converted Value","type":"number"},"target_unit":{"description":"The unit to which the temperature value was converted (e.g., 'Celsius', 'Fahrenheit', 'Kelvin')","title":"Target Unit","type":"string"}},"required":["original_value","original_unit","converted_value","target_unit"],"title":"TemperatureConverterResponse","type":"object"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"value":{"description":"The numeric value to convert","title":"Value","type":"number"},"source_unit":{"description":"The source unit of the value (e.g., 'meters', 'feet', 'kg', 'lbs')","title":"Source Unit","type":"string"},"target_unit":{"description":"The target unit to convert to (e.g., 'kilometers', 'miles', 'grams', 'ounces')","title":"Target Unit","type":"string"}},"required":["value","source_unit","target_unit"],"title":"UnitConverterRequest","type":"object"}}}}}}}}