# Aient Telemetry Trace Query

> Aient Telemetry Trace Query is a paid API for AI agents from aient.ai, paid per call via x402, $0.005000/call, status unknown (last checked 2026-09-15).

Query and filter OpenTelemetry traces ingested by your Aient organisation, returning up to 100 trace summaries per call

## Facts

- Endpoint: GET https://aient.ai/x402/telemetry/traces
- Price: $0.005000/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aient-ai-8a44720d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ecK-upQl69EfDNijHfr4F

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability aient-ai-8a44720d
```

Example prompt: Show me the last 50 error traces from my checkout service in Aient between 2025-01-15T14:00:00Z and 2025-01-15T15:00:00Z for the processPayment operation.

## When to prefer this

Use this endpoint when you need to browse or filter a list of traces across your Aient-monitored services — especially when you want to narrow down by service name, operation, time window, or error status before diving into individual trace details. Prefer this over the span-fetch endpoint when you don't yet have a specific traceId and need to discover which traces are relevant.

## Known failure modes

- Invalid date-time format for since/until returns a 400 error
- Unknown service or operation name returns an empty traces array
- Expired or invalid authentication returns 401/402
- Requesting more than the maximum limit (100) may be capped or rejected
- Very broad time ranges may time out or return partial results

## How this service works

Query OpenTelemetry traces ingested by your Aient organisation; filter by service, operation, time range, and error status. Returns up to 100 trace summaries per call.

## Output

Returns an array of up to 100 trace summaries (each containing trace metadata like traceId, service, operation, status, and timestamps), plus an optional nextCursor string for pagination through additional results.

## Request schema (JSON Schema)

```json
{
 "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"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer"
      },
      "since": {
       "type": "string",
       "format": "date-time"
      },
      "until": {
       "type": "string",
       "format": "date-time"
      },
      "status": {
       "enum": [
        "ok",
        "error"
       ],
       "type": "string"
      },
      "service": {
       "type": "string"
      },
      "operation": {
       "type": "string"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "traces"
     ],
     "properties": {
      "traces": {
       "type": "array",
       "items": {
        "type": "object"
       }
      },
      "nextCursor": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aient-ai-8a44720d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aient.ai](https://www.zero.xyz/host/aient.ai/llms.txt)