TraceQueryClient

from valiqor import ValiqorClient

client = ValiqorClient(api_key="your-api-key")
tq = client.traces

from valiqor.trace import TraceQueryClient

tq = TraceQueryClient(api_key="your-api-key")

TraceQueryClient(
    api_key: Optional[str] = None,
    base_url: Optional[str] = None,
    timeout: int = 300,
)

def list_traces(
    self,
    project_name: Optional[str] = None,
    project_id: Optional[str] = None,
    page: int = 1,
    page_size: int = 20,
) -> TraceListResponse

# Auto-resolve project from config
traces = client.traces.list_traces()

# Or specify explicitly
traces = client.traces.list_traces(project_name="my-app", page_size=10)
for t in traces:
    print(f"{t.trace_id} | {t.status} | {t.duration_ms}ms | {t.llm_calls} LLM calls")

def get_trace(self, trace_id: str) -> TraceOverview

def get_summary(self, trace_id: str) -> TraceSummary

summary = client.traces.get_summary("trace-id-123")
print(f"Duration: {summary.duration_ms}ms")
print(f"Total tokens: {summary.total_tokens}")
print(f"Cost: ${summary.total_cost:.4f}")
print(f"LLM calls: {summary.llm_calls}, Tool calls: {summary.tool_calls}")

def get_messages(self, trace_id: str) -> List[TraceMessage]

messages = client.traces.get_messages("trace-id-123")
for msg in messages:
    print(f"[{msg.role}] {msg.content[:100]}")

def get_spans(self, trace_id: str) -> List[TraceSpan]

spans = client.traces.get_spans("trace-id-123")
for span in spans:
    indent = "  " if span.parent_span_id else ""
    print(f"{indent}{span.name} ({span.kind}) - {span.duration_ms}ms")

def get_full_trace(self, trace_id: str) -> TraceFullResult

full = client.traces.get_full_trace("trace-id-123")
print(f"Messages: {len(full.messages)}")
print(f"Retrievals: {len(full.retrievals)}")

def get_eval_steps(self, trace_id: str) -> List[TraceEvalStep]

steps = client.traces.get_eval_steps("trace-id-123")
for step in steps:
    print(f"{step.metric}: {step.score} — {step.explanation}")