# TimeSeriesPoint

> Tracon documentation. Tracon is a .NET package family that adds a control
> plane on Microsoft Agent Framework, published as NuGet packages that run
> inside your own ASP.NET Core application.
>
> Page: https://tracon.dev/http-api/schemas/timeseriespoint/
> Summary: OpenAPI request or response schema for TimeSeriesPoint, including required fields, defaults, constraints, and linked nested types.

[← All HTTP schemas](/http-api/schemas/)

A summary of the runs in a time bucket. The result unit of
`/api/stats/timeseries`; empty buckets are also returned (with zero events).

**Shape:** `object`

| Property | Required | Type | Description | Rules |
|---|---|---|---|---|
| `bucket` | yes | `string (date-time)` | The bucket's start time (UTC). | — |
| `runs` | no | `integer (int64)` | The number of runs that started in this bucket. | pattern `^-?(?:0\\|[1-9]\d*)$` |
| `failedRuns` | no | `integer (int64)` | The number of runs that ended in an error in this bucket. | pattern `^-?(?:0\\|[1-9]\d*)$` |
| `inputTokens` | no | `integer (int64)` | The total input tokens. | pattern `^-?(?:0\\|[1-9]\d*)$` |
| `outputTokens` | no | `integer (int64)` | The total output tokens. | pattern `^-?(?:0\\|[1-9]\d*)$` |
| `cost` | no | `number (double)` | The total cost. `null` if no run was ever priced. | pattern `^-?(?:0\\|[1-9]\d*)(?:\.\d+)?$` |
| `currencyCount` | no | `integer (int32)` | The number of currencies the priced runs of the WHOLE series are in. | pattern `^-?(?:0\\|[1-9]\d*)$` |
| `averageDurationMs` | no | `number (double)` | The average duration of settled runs (milliseconds). | pattern `^-?(?:0\\|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$` |