# TradepilotUSA Sentiment Analysis

> TradepilotUSA Sentiment Analysis 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).

Analyzes the sentiment of a provided text, returning a topic breakdown, sentiment summary, assumptions, evidence gaps, and a human-review flag.

## Facts

- Endpoint: POST https://www.tradepilotusa.com/api/agent-commerce/v1/services/sentiment_analysis/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-sentiment-analysis-2b2a48d7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kH-16CB41os8Sb-7DNojJ

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-sentiment-analysis-2b2a48d7 -d '<json body>'
```

Example prompt: Can you run a sentiment analysis on this customer feedback for me? The brief is 'Post-installation survey for residential door services in Dallas', the audience is 'operations managers', and the source text is: 'The installation team was punctual and professional, but we experienced significant delays in the initial consultation scheduling that pushed back our project timeline by two weeks.'

## When to prefer this

Choose this endpoint when you need structured sentiment analysis with topic decomposition, assumption tracking, and evidence gap identification — particularly useful in business operations contexts (customer feedback, support tickets, employee surveys) where auditability and human-review flagging matter. Prefer this over generic NLP APIs if you need the full analytical artifact with provenance metadata rather than just a sentiment label.

## Known failure modes

- source_text too short (< 20 chars) or too long (> 32000 chars) returns validation error
- brief too short (< 10 chars) or too long (> 12000 chars) returns validation error
- malformed JSON body returns 400 error
- insufficient USDC balance or payment failure returns 402 error
- ambiguous or low-content text may produce low-confidence output with requires_human_review: true
- no external research performed, so real-time or web-sourced data is not incorporated

## How this service works

Analyze supplied customer-feedback text by topic and expressed sentiment; do not infer personal traits. Uses buyer-supplied information only; no external research or outbound actions. Returns a draft for human review.

## Output

Returns a JSON object containing: a task label, a plain-language sentiment summary, a detailed artifact with topics identified and their associated sentiment, a list of assumptions made, evidence gaps flagged, a provenance block (source, timestamp, whether external research was used), a request ID, and a boolean 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": "sentiment_analysis",
  "summary": "The feedback details operational procedures for residential door installation, focusing on consultation scheduling and measurement confirmation. A concern about appointment delays is noted, with a mee",
  "artifact": "Illustrative excerpt from a synthetic provider check:\n## Customer Feedback Analysis by Topic and Sentiment\n\n### Topics Identified\n1. **Service Offering**\n   - Residential entry door installation in Dallas.\n   - Consultations available Monday through Friday.\n\n2. **Operations and Scheduling**\n   - Consultation scheduling managed by the operations manager.\n   - Installation crew confirms measurements prior to final quoting.\n\n3. **Project Management and Delays**\n   - Upcoming meeting to review appointment delays.\n   - Current delay rates and final proj",
  "provenance": {
   "source": "buyer_supplied",
   "generated_at": "2026-09-22T14:42:36.270Z",
   "external_research_performed": false
  },
  "request_id": "example_sentiment_analysis",
  "assumptions": [
   "The operations manager has access to detailed scheduling notes relevant to appointment delays.",
   "Appointment delays are significant enough to warrant a dedicated meeting."
  ],
  "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-sentiment-analysis-2b2a48d7/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)