# three.ws Revenue Vision Insight

> three.ws Revenue Vision Insight is a paid API for AI agents from three.ws, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Analyzes a free-text growth question or hypothesis and returns a data-grounded revenue insight with a single recommended tactical action and confidence level.

## Facts

- Endpoint: GET https://three.ws/api/insights/revenue-vision
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/three-ws-revenue-vision-insight-7a0e8c35
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iKL5foRpSFaiWjV9XdN3-

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 three-ws-revenue-vision-insight-7a0e8c35
```

Example prompt: I'm running revenue-vision on three.ws — analyze this growth question for agent 'growthbot-alpha': 'Are developer teams at 10-50 employees our best-converting segment, and should we shift budget to builder-focused onboarding to increase conversion?' Give me a specific insight and one tactical move I should make next.

## When to prefer this

Use this endpoint when an AI agent needs a concise, confidence-rated revenue or growth insight with a single actionable recommendation from a free-text business hypothesis, particularly within the three.ws 3D agent ecosystem. Prefer this over general-purpose LLM calls when you want a structured insight+recommendation+confidence tuple backed by IBM watsonx.ai Granite and don't need multi-step analysis or raw data retrieval.

## Known failure modes

- Missing required query params (agent_codename, power_request, mission_brief) returns a 400 error
- mission_brief shorter than 4 characters or longer than 4000 characters rejected by schema validation
- power_request value other than 'revenue-vision' is not accepted by the enum
- Payment of $0.001 USDC not received or x402 payment flow fails — endpoint returns 402 Payment Required
- Rate limit exceeded for the given agent_codename — returns 429 Too Many Requests

## How this service works

Make a 3D AI agent from a selfie in 60 seconds. Drop one HTML tag to embed it on any website. Agents think on IBM watsonx.ai (Granite); optionally charge per chat with built-in micropayments.

## Output

Returns a JSON object with a data-grounded insight string (a specific observation about the submitted mission), a single recommended_move (one tactical action to take next), a confidence level (high/medium/low), and the power_mode confirming 'revenue-vision' was applied.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "agent_codename",
      "power_request",
      "mission_brief"
     ],
     "properties": {
      "mission_brief": {
       "type": "string",
       "maxLength": 4000,
       "minLength": 4,
       "description": "Free-text growth question or hypothesis to analyze."
      },
      "power_request": {
       "enum": [
        "revenue-vision"
       ],
       "type": "string",
       "description": "Power mode requested. Currently only \"revenue-vision\"."
      },
      "agent_codename": {
       "type": "string",
       "description": "Caller agent name for attribution and rate-limit telemetry."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "power_mode",
      "insight",
      "recommended_move",
      "confidence"
     ],
     "properties": {
      "insight": {
       "type": "string",
       "description": "A specific, data-grounded observation about the mission."
      },
      "confidence": {
       "enum": [
        "high",
        "medium",
        "low"
       ],
       "type": "string"
      },
      "power_mode": {
       "enum": [
        "revenue-vision"
       ],
       "type": "string"
      },
      "recommended_move": {
       "type": "string",
       "description": "A single tactical action the caller should take next."
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "insight": "Developer teams at 10–50 employees convert 2.4x better than enterprise prospects on the current funnel.",
  "confidence": "high",
  "power_mode": "revenue-vision",
  "recommended_move": "Shift 30% of the paid-acquisition budget to builder-focused onboarding campaigns this sprint."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-revenue-vision-insight-7a0e8c35/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from three.ws](https://www.zero.xyz/host/three.ws/llms.txt)