{ "id": "time-series-inspect", "name": "Time-series cadence inspection", "description": "Inspect up to 1,000 supplied timestamp/value points for ordering, duplicate timestamps, null values and optional cadence deviations. Returns bounded interval evidence, aligned missing-point estimates and descriptive numeric summaries. No clock, interpolation, anomaly prediction or forecasting.", "category": "data-assurance", "priceUsd": "0.005", "pricingStatus": "proposed-unverified", "pricing": { "unit": "one successful operation call", "proposedNominalUsd": "0.005", "sixDecimalTokenBaseUnits": "5000", "subscription": false, "includesPayerWalletOrNetworkFees": false, "liveQuoteVerified": false, "condition": "Actual SDK challenge is authoritative only within the caller's explicit authorization; configured six-decimal token peg is an operator assertion, not a conversion guarantee." }, "intents": [ "inspect time series cadence gaps duplicate timestamps and null readings", "validate chronological telemetry points before analysis", "find irregular intervals and missing observations in supplied data" ], "whenToUse": [ "inspect time series cadence gaps duplicate timestamps and null readings", "validate chronological telemetry points before analysis", "find irregular intervals and missing observations in supplied data" ], "whenNotToUse": [ "Forecast prices predict anomalies or make trading decisions", "Fetch live telemetry or infer wall-clock freshness" ], "capabilities": [ "chronological ordering evidence", "duplicate timestamp groups", "cadence deviation evidence", "bounded descriptive summaries" ], "related": [ "interval-analyze", "timestamp-convert" ], "limits": { "inputBytes": 100000, "outputBytes": 400000, "jsonNodes": 12000, "depth": 20, "evidence": 200, "keyWorkBytes": 3000000, "matchingSteps": 2000000, "points": 1000, "timestampUnit": "Unix milliseconds", "numericAbsoluteMaximum": 1e+100 }, "errorCodes": [ "INPUT_LIMIT", "OUTPUT_LIMIT", "COMPLEXITY_LIMIT", "UNSAFE_KEY", "INVALID_NUMBER", "INVALID_POINTER", "DUPLICATE_ID", "DUPLICATE_FIELD", "INVALID_RULE", "KEY_WORK_LIMIT", "LABEL_LIMIT", "UNJUDGED_DOCUMENT", "INVALID_SPAN", "DUPLICATE_SPAN", "INVALID_UNICODE", "MATCHING_LIMIT", "INVALID_CADENCE", "INVALID_INTERVAL", "NUMERIC_OVERFLOW" ], "requirementsProfile": { "format": "declared-requirements-v1", "facts": { "execution.suppliedCode": false, "execution.remoteMutation": false, "execution.llmInference": false, "execution.paidMcp": false, "verification.semanticTruth": false, "verification.sourceAuthenticity": false, "verification.liveVulnerabilities": false, "numbers.arbitraryPrecisionJson": false, "numbers.model": "ieee754-binary64", "privacy.requestBodyPersisted": false, "execution.deterministic": true, "execution.networkAccess": false, "privacy.resultBodyPersisted": false, "payment.x402": true, "payment.mpp": true, "operation.id": "time-series-inspect", "operation.category": "data-assurance", "limit.httpRequestBytes": 131072, "limit.requestBytes": 100000, "limit.responseBytes": 524288, "limit.resultBytes": 400000, "limit.jsonDepth": 20, "limit.jsonNodes": 12000, "input.points.maxItems": 1000, "input.expectedStepMs.maximum": 8640000000000000, "input.toleranceMs.maximum": 8640000000000000, "input.toleranceMs.minimum": 0 }, "unknownPolicy": "Undeclared requirements are unknown, never compatible. Matching declared facts does not establish semantic fit or input validity.", "preflight": "/preflight" }, "documentation": "/reference/tools/time-series-inspect.md", "serviceContract": "/reference/services/time-series-inspect.json", "errors": [ { "status": 400, "meaning": "Malformed JSON, missing/invalid idempotency key, or payment identifier mismatch", "retry": "Correct the request before payment" }, { "status": 402, "meaning": "Payment challenge or rejected payment", "retry": "Use official protocol SDK; inspect payment outcome before another payment" }, { "status": 409, "meaning": "Idempotency conflict, duplicate proof, or PAYMENT_UNCERTAIN", "retry": "Keep original key, body, and proof; reconcile uncertainty with operator; never blindly repay" }, { "status": 413, "meaning": "Input or generated output too large", "retry": "Reduce input; no payment attempted for validation failure" }, { "status": 415, "meaning": "Unsupported media type or compression", "retry": "Send uncompressed application/json" }, { "status": 422, "meaning": "Schema or service-specific semantic validation failure", "retry": "Correct input using returned error code; no payment attempted" }, { "status": 429, "meaning": "Request/payment-attempt rate exceeded", "retry": "Wait for rate limit window; preserve existing payment identity" }, { "status": 503, "meaning": "Payment configuration/provider/state unavailable, or live DNS preparation failed before settlement", "retry": "Check readiness; DNS preparation failures may retry the identical key/body/credential only; uncertainty requires reconciliation" } ], "numericPrecision": "JavaScript IEEE-754 numbers; use strings for large integer IDs/exact decimals where the schema accepts strings. No lossless numeric parsing.", "paymentWorkflow": { "discoveryOnly": false, "supportedProtocols": [ "x402", "mpp" ], "x402": { "credentialHeader": "PAYMENT-SIGNATURE", "challengeHeader": "PAYMENT-REQUIRED", "receiptHeader": "PAYMENT-RESPONSE", "version": 2, "scheme": "exact", "paymentIdentifier": "payment-identifier extension MUST equal the HTTP Idempotency-Key", "sdk": "@x402/core with @x402/evm" }, "mpp": { "supported": true, "credentialHeader": "Authorization", "challengeHeader": "WWW-Authenticate", "receiptHeader": "Payment-Receipt", "method": "tempo", "intent": "charge", "sdk": "mppx", "tokenDecimals": 6 }, "steps": [ "Check configured readiness and the exact service schema", "Generate a fresh random Idempotency-Key for this operation; never use a discovery probe fixture for purchases", "Send valid input without a credential to obtain the official protocol challenge", "Use the official SDK and authorized wallet to fulfill the challenge", "Retry only with identical key, body, protocol and credential", "On PAYMENT_UNCERTAIN stop and request operator reconciliation; never blindly pay again" ], "versionedRetries": "Request fingerprint includes service release version. Retries across a version upgrade can conflict; coordinate upgrades outside the 24-hour replay window and reconcile pending attempts.", "docs": "/llms.txt" }, "method": "POST", "paths": { "x402": "/v1/x402/time-series-inspect", "mpp": "/v1/mpp/time-series-inspect" }, "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "points": { "maxItems": 1000, "type": "array", "items": { "type": "object", "properties": { "timeMs": { "type": "integer", "minimum": 0, "maximum": 8640000000000000 }, "value": { "anyOf": [ { "type": "number", "minimum": -1e+100, "maximum": 1e+100 }, { "type": "null" } ] } }, "required": [ "timeMs", "value" ], "additionalProperties": false } }, "expectedStepMs": { "type": "integer", "exclusiveMinimum": 0, "maximum": 8640000000000000 }, "toleranceMs": { "default": 0, "type": "integer", "minimum": 0, "maximum": 8640000000000000 } }, "required": [ "points" ], "additionalProperties": false }, "outputSchema": { "type": "object", "required": [ "operation", "version", "result", "provenance" ], "properties": { "operation": { "const": "time-series-inspect", "type": "string" }, "version": { "const": "0.29.0", "type": "string" }, "result": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "profile": { "type": "string", "const": "time-series-inspection-v1" }, "pointCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "distinctTimestampCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "nullValueCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "firstTimeMs": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 8640000000000000 }, { "type": "null" } ] }, "lastTimeMs": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 8640000000000000 }, { "type": "null" } ] }, "sortedInput": { "type": "boolean" }, "outOfOrderPairCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "outOfOrderPairs": { "type": "array", "items": { "type": "object", "properties": { "previousRowIndex": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "rowIndex": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "previousTimeMs": { "type": "integer", "minimum": 0, "maximum": 8640000000000000 }, "timeMs": { "type": "integer", "minimum": 0, "maximum": 8640000000000000 } }, "required": [ "previousRowIndex", "rowIndex", "previousTimeMs", "timeMs" ], "additionalProperties": false } }, "outOfOrderPairsTruncated": { "type": "boolean" }, "duplicateTimestampCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "duplicateTimestamps": { "type": "array", "items": { "type": "object", "properties": { "timeMs": { "type": "integer", "minimum": 0, "maximum": 8640000000000000 }, "count": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "rowIndices": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "rowIndicesTruncated": { "type": "boolean" } }, "required": [ "timeMs", "count", "rowIndices", "rowIndicesTruncated" ], "additionalProperties": false } }, "duplicateTimestampsTruncated": { "type": "boolean" }, "cadenceChecked": { "type": "boolean" }, "irregularIntervalCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "irregularIntervals": { "type": "array", "items": { "type": "object", "properties": { "fromTimeMs": { "type": "integer", "minimum": 0, "maximum": 8640000000000000 }, "toTimeMs": { "type": "integer", "minimum": 0, "maximum": 8640000000000000 }, "deltaMs": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "kind": { "type": "string", "enum": [ "short", "long" ] }, "inferredMissingPoints": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "fromTimeMs", "toTimeMs", "deltaMs", "kind", "inferredMissingPoints" ], "additionalProperties": false } }, "irregularIntervalsTruncated": { "type": "boolean" }, "numeric": { "anyOf": [ { "type": "object", "properties": { "count": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "min": { "type": "number" }, "max": { "type": "number" }, "mean": { "type": "number" }, "median": { "type": "number" } }, "required": [ "count", "min", "max", "mean", "median" ], "additionalProperties": false }, { "type": "null" } ] }, "conventions": { "type": "array", "items": { "type": "string" } } }, "required": [ "profile", "pointCount", "distinctTimestampCount", "nullValueCount", "firstTimeMs", "lastTimeMs", "sortedInput", "outOfOrderPairCount", "outOfOrderPairs", "outOfOrderPairsTruncated", "duplicateTimestampCount", "duplicateTimestamps", "duplicateTimestampsTruncated", "cadenceChecked", "irregularIntervalCount", "irregularIntervals", "irregularIntervalsTruncated", "numeric", "conventions" ], "additionalProperties": false }, "provenance": { "type": "object", "required": [ "inputSha256", "outputSha256", "deterministic", "externalRequests" ], "properties": { "inputSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "outputSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "deterministic": { "const": true }, "externalRequests": { "const": 0 } } } }, "additionalProperties": false }, "exampleInput": { "points": [ { "timeMs": 0, "value": 10 }, { "timeMs": 1000, "value": 12 }, { "timeMs": 3000, "value": null }, { "timeMs": 1000, "value": 11 } ], "expectedStepMs": 1000 }, "exampleResponse": { "operation": "time-series-inspect", "version": "0.29.0", "result": { "profile": "time-series-inspection-v1", "pointCount": 4, "distinctTimestampCount": 3, "nullValueCount": 1, "firstTimeMs": 0, "lastTimeMs": 3000, "sortedInput": false, "outOfOrderPairCount": 1, "outOfOrderPairs": [ { "previousRowIndex": 2, "rowIndex": 3, "previousTimeMs": 3000, "timeMs": 1000 } ], "outOfOrderPairsTruncated": false, "duplicateTimestampCount": 1, "duplicateTimestamps": [ { "timeMs": 1000, "count": 2, "rowIndices": [ 1, 3 ], "rowIndicesTruncated": false } ], "duplicateTimestampsTruncated": false, "cadenceChecked": true, "irregularIntervalCount": 1, "irregularIntervals": [ { "fromTimeMs": 1000, "toTimeMs": 3000, "deltaMs": 2000, "kind": "long", "inferredMissingPoints": 1 } ], "irregularIntervalsTruncated": false, "numeric": { "count": 3, "min": 10, "max": 12, "mean": 11, "median": 11 }, "conventions": [ "Timestamps are supplied Unix milliseconds. Cadence checks adjacent distinct sorted timestamps, not absolute grid phase or wall-clock freshness.", "Missing-point counts are inferred only when a long interval is within tolerance of an integer step multiple. Other irregular intervals return null; no data is imputed.", "Numeric summary includes every non-null supplied value, including duplicate timestamps. Statistics use IEEE-754 arithmetic and do not establish a forecast or anomaly cause." ] }, "provenance": { "inputSha256": "9e9f6fa86c25c41d24fc6a75e6b1ecb1eac14ad7773de1b2ed73918897510926", "outputSha256": "7aa0ada91ec76f7c1cbe2f504d5a66b00d27da27f68aae4e128228d1a1ff0b99", "deterministic": true, "externalRequests": 0 } }, "requiredHeaders": { "Content-Type": "application/json", "Idempotency-Key": "random 16–128 character operation identifier" }, "fixedExample": "/reference/examples/time-series-inspect.json", "execution": { "deterministic": true, "externalRequests": 0, "maxExternalRequests": 0, "resultSnapshotPersisted": false, "fixedExampleIsIllustrativeSnapshot": false, "requiresPayment": true, "supportsMcpExecution": false }, "releaseSnapshot": { "format": "static-release-reference-v1", "sourceVersion": "0.29.0", "sourceRegistrySha256": "a2b5ec09bf6c38b9d2879d746a4fded374f5928b445377b0270ef6aa8e6cac65", "generatedAt": "2026-10-06T15:38:00Z", "releaseAcceptance": "not-verified-by-generator", "runtimeReadiness": "not-evaluated", "livePaymentsVerified": false, "indexingVerified": false, "apiOrigin": null, "notice": "Build-time release reference. Runtime readiness, deployment, payment settlement and external indexing are not evaluated here. Prices are proposed; this file cannot authorize execution or payment." } }