# TradepilotUSA Field Mapping Executor

> TradepilotUSA Field Mapping Executor 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).

Maps source text fields to a structured target schema using AI, extracting and transforming business data fields with validation and gap analysis.

## Facts

- Endpoint: POST https://www.tradepilotusa.com/api/agent-commerce/v1/services/field_mapping/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-field-mapping-executor-47a0737d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cCI1JVgkUDA_tmUuy8Ox4

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-field-mapping-executor-47a0737d -d '<json body>'
```

Example prompt: Take this raw business brief about our door installation company and map all the source fields — company name, service type, location, availability, crew roles, and action items — to our CRM target schema, flagging any missing critical data like delay rates or budget figures.

## When to prefer this

Choose this endpoint when you need to extract and organize structured fields from unstructured or semi-structured business text — such as sales notes, operational briefs, supplier documents, or meeting summaries — and map them to a defined target schema with gap identification. It is particularly useful when the source data is messy or incomplete and you need both the mapping result and an audit trail of assumptions and missing data, rather than a simple regex or rule-based extraction.

## Known failure modes

- Source text too short (below 20 characters) returns validation error
- Brief field missing or below minimum length (10 characters) returns 400 error
- Source text exceeds 32,000 character limit causing rejection
- Ambiguous or highly unstructured source text may produce incomplete or low-confidence mappings
- Missing critical fields in source result in evidence_gaps list requiring human follow-up
- requires_human_review flag set to true when data is insufficient for full automated mapping

## How this service works

Map supplied source fields to a target schema, specifying transformations, required validation, and unmapped fields. Uses buyer-supplied information only; no external research or outbound actions. Returns a draft for human review.

## Output

Returns a JSON object containing the mapped field summary, a detailed artifact excerpt with extracted and transformed fields, a list of assumptions made during mapping, identified evidence gaps (missing critical data), a provenance record, a request ID, and a flag indicating whether human review is required.

## 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": "field_mapping",
  "summary": "Mapped source fields from the fictional example to a target schema with specified transformations and validation rules. Identified missing critical data such as delay rates and project budget for foll",
  "artifact": "Illustrative excerpt from a synthetic provider check:\n## Business Draft: Mapping Source Fields to Target Schema\n\n### Source Fields Extracted\n- Company Name: Example Door Company\n- Service Offered: Residential entry door installation\n- Location: Dallas\n- Consultation Availability: Monday through Friday\n- Consultation Scheduling Owner: Operations Manager\n- Installation Crew Role: Confirms measurements before final quote\n- Upcoming Meeting Purpose: Review appointment delays\n- Missing Data: Current delay rates, final project budget\n- Action Item: Opera",
  "provenance": {
   "source": "buyer_supplied",
   "generated_at": "2026-09-22T14:42:44.436Z",
   "external_research_performed": false
  },
  "request_id": "example_field_mapping",
  "assumptions": [
   "The source text fields represent the complete set of relevant data for this mapping.",
   "Consultation availability is limited to weekdays as stated."
  ],
  "evidence_gaps": [
   "Quantitative data on current appointment delay rates.",
   "Final project budget figures."
  ],
  "requires_human_review": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradepilotusa-field-mapping-executor-47a0737d/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)