# Vedetta Task Router

> Vedetta Task Router is a paid API for AI agents from vedetta.dethboy.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Routes a plain-English task description to the exact Vedetta endpoint, parameters, and price needed — plus cheaper cached alternatives — without firing a live analyst read.

## Facts

- Endpoint: GET https://vedetta.dethboy.com/v1/route
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vedetta-task-router-29d8a5ac
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4VzAIiAg9jXrPRmAzFBoG

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 vedetta-task-router-29d8a5ac
```

Example prompt: I want to check social sentiment for ETH on Vedetta but I'm not sure which endpoint to call — can you figure out the right one, the exact parameters, the price, and whether there's a cheaper cached version?

## When to prefer this

Use this endpoint when an agent doesn't know which Vedetta endpoint to call for a given research need, wants to avoid overpaying by accidentally triggering a live analyst read, or needs to dynamically discover the cheapest cached path for a task at runtime. Prefer it over guessing directly at sibling endpoints when the task type is uncertain or cost optimization matters.

## Known failure modes

- task description too vague or ambiguous — no confident endpoint match returned
- asset ticker not recognized — may return generic routing without asset-specific refinement
- task maps to a capability outside Vedetta's endpoint catalog — no match found
- task string exceeds 300-character limit — request rejected
- network or payment failure at the x402 layer — no response

## How this service works

Task router: describe what you need in plain text (?task=...) and get the exact Vedetta endpoint, parameters and price to call — plus cheaper cached alternates. Stops agents guessing or overpaying. Half a cent, instant, never fires a live analyst read. Descriptive research, not financial advice.

## Output

Returns the exact Vedetta endpoint URL to call, required and optional query parameters, the price in USDC, and any cheaper cached alternative endpoints that answer the same question — all without triggering a live analyst computation.

## 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",
     "required": [
      "task"
     ],
     "properties": {
      "task": {
       "type": "string",
       "maxLength": 300,
       "description": "Plain-English description of what you need to know"
      },
      "asset": {
       "type": "string",
       "description": "Ticker symbol, e.g. BTC, ETH, SOL, AI"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "note": {
       "type": "string"
      },
      "task": {
       "type": "string"
      },
      "alternates": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "why": {
          "type": "string"
         },
         "route": {
          "type": "string"
         },
         "price_usd": {
          "type": "number"
         }
        }
       }
      },
      "recommendation": {
       "type": "object",
       "properties": {
        "url": {
         "type": "string"
        },
        "why": {
         "type": "string"
        },
        "call": {
         "type": "string"
        },
        "route": {
         "type": "string"
        },
        "params": {
         "type": "object",
         "properties": {
          "asset": {
           "type": "string"
          }
         }
        },
        "price_usd": {
         "type": "number"
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Routing is local logic — this call never fires a live analyst read.",
  "task": "is something happening on SOL right now or should I look elsewhere?",
  "spend_tip": "Cached routes never fire the live desk. Escalate to a $0.09 live read only when the cached answer is stale or a trigger fires.",
  "alternates": [
   {
    "why": "Cached cross-asset scan if you want the cheapest look-elsewhere answer first.",
    "route": "GET /v1/screener",
    "price_usd": 0.03
   },
   {
    "why": "Cheapest single-asset cached entry.",
    "route": "GET /v1/snapshot",
    "price_usd": 0.02
   }
  ],
  "recommendation": {
   "url": "https://vedetta.dethboy.com/v1/event",
   "why": "Task asks whether something is happening right now — the live trigger probe answers exactly that.",
   "call": "https://vedetta.dethboy.com/v1/event?asset=SOL",
   "route": "GET /v1/event",
   "params": {
    "asset": "SOL"
   },
   "price_usd": 0.09
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vedetta-task-router-29d8a5ac/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vedetta.dethboy.com](https://www.zero.xyz/host/vedetta.dethboy.com/llms.txt)