# TradepilotUSA KPI Definition Engine

> TradepilotUSA KPI Definition Engine is a paid API for AI agents from www.tradepilotusa.com, paid per call via x402, $0.25/call, status unknown (last checked 2026-10-02).

Generates structured KPI definitions and metrics frameworks from a business brief and source text, tailored to a specified audience.

## Facts

- Endpoint: POST https://www.tradepilotusa.com/api/agent-commerce/v1/services/kpi_definition/execute?utm_source=zero.xyz
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tradepilotusa-kpi-definition-engine-fb486892
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dbRqJ2lrn5yOPzYK8FVL8

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 tradepilotusa-kpi-definition-engine-fb486892 -d '<json body>'
```

Example prompt: Can you define KPIs for my residential door installation business's scheduling improvement project? The audience is our operations managers, and here's the brief: we want to reduce booking gaps and improve consultation completion rates — use that as the source text.

## When to prefer this

Choose this endpoint when you need to convert an unstructured business brief or project description into a formal, structured KPI framework with defined formulas, ownership, and cadence — especially for small-to-midsize trade or service businesses. Prefer it over generic LLM prompting when you need a consistent, structured JSON artifact with explicit evidence gaps and assumptions documented. Best for operational improvement projects, not real-time dashboard querying or financial reporting.

## Known failure modes

- Brief or source_text below minimum length (10 and 20 characters respectively) returns a validation error
- Source text exceeding 32,000 characters is rejected
- Ambiguous or overly vague briefs may produce generic or low-utility KPI definitions
- External research is not performed, so gaps in input data lead to evidence_gap flags rather than filled metrics
- Response may require human review when assumptions are significant

## How this service works

Define metrics with purpose, formula, source requirements, cadence, ownership, and interpretation limits. Uses buyer-supplied information only; no external research or outbound actions. Returns a draft for human review.

## Output

Returns a structured JSON response containing a task label, a plain-English summary of the defined metrics, a detailed artifact (markdown-formatted KPI definitions with purpose, formula, data source requirements, cadence, and ownership), a list of assumptions made, identified evidence gaps, a provenance record, a unique request ID, and a flag indicating whether human review is recommended.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "brief": {
   "type": "string",
   "maxLength": 12000,
   "minLength": 10
  },
  "audience": {
   "type": "string",
   "maxLength": 500
  },
  "source_text": {
   "type": "string",
   "maxLength": 32000,
   "minLength": 20
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "task": "kpi_definition",
  "summary": "Defined five metrics for improving scheduling in a residential door installation business: booking volume, consultation completion rate, staff training effectiveness, process assessment findings, and ",
  "artifact": "Illustrative excerpt from a synthetic provider check:\n## Metrics Definition for Scheduling Improvement Project\n\n### 1. Booking Volume\n- **Purpose:** Measure the number of door installation consultations booked to assess demand and scheduling load.\n- **Formula:** Count of consultations booked per week.\n- **Source Requirements:** Appointment booking system or manual logs capturing date and time of each consultation.\n- **Cadence:** Weekly.\n- **Ownership:** Scheduling coordinator or operations manager.\n- **Interpretation Limits:** Does not indicate con",
  "provenance": {
   "source": "buyer_supplied",
   "generated_at": "2026-09-22T14:42:09.958Z",
   "external_research_performed": false
  },
  "request_id": "example_kpi_definition",
  "assumptions": [
   "The company uses some form of appointment booking system or manual logs.",
   "Staff workshops and vendor assessments are part of the improvement project."
  ],
  "evidence_gaps": [
   "Actual booking volume and consultation completion data.",
   "Customer feedback survey results."
  ],
  "requires_human_review": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradepilotusa-kpi-definition-engine-fb486892/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.tradepilotusa.com](https://www.zero.xyz/host/www.tradepilotusa.com/llms.txt)