# Vedetta Signal History

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

Returns cached timestamped history (up to 50 rows) of sentiment %, stance, divergence flags, and narratives for a single crypto asset — suitable for backtesting and trend analysis.

## Facts

- Endpoint: GET https://vedetta.dethboy.com/v1/history
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vedetta-signal-history-6e87a818
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_s809tiWzO0lEHOH5l4-B7

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-signal-history-6e87a818
```

Example prompt: Pull the last 50 rows of Vedetta's signal history for BTC — I want the timestamped sentiment percentages, stance, divergence flags, and narratives so I can run a backtest.

## When to prefer this

Choose this endpoint when you need a time-series of past sentiment readings, stances, divergence flags, and narratives for a single crypto asset — particularly for backtesting, pattern detection, or auditing how analyst views have evolved. Unlike real-time endpoints, this provides a structured historical record not available from raw data providers. Prefer it over the live/current endpoints when temporal depth and multiple historical snapshots are required.

## Known failure modes

- Missing or invalid asset ticker returns an error or empty result
- Limit value outside 1–50 range is rejected by schema validation
- Unknown asset symbol not covered by the desk returns no rows
- Payment failure (x402) prevents access if USDC payment is not processed
- Stale cache may mean very recent signals are not yet included

## How this service works

Cached signal history for one asset (?asset=BTC, up to 50 rows): timestamped sentiment %, stance, divergence flags and narratives — backtest-ready analyst history no raw data API sells. Descriptive research, not financial advice.

## Output

A list of up to 50 timestamped records, each containing: sentiment percentage (bullish/bearish score), stance label, divergence flags (boolean or categorical), and narrative text describing the analyst view at that point in time. Results are cached and returned quickly, ready for downstream backtesting or trend analysis.

## 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": [
      "asset"
     ],
     "properties": {
      "asset": {
       "type": "string",
       "description": "Ticker symbol, e.g. BTC, ETH, SOL, AI"
      },
      "limit": {
       "type": "integer",
       "maximum": 50,
       "minimum": 1
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asset": {
       "type": "string"
      },
      "count": {
       "type": "integer"
      },
      "signals": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "ts": {
          "type": "number"
         },
         "stance": {
          "type": "string"
         },
         "quality": {
          "type": "string"
         },
         "narrative": {
          "type": "string"
         },
         "sentiment_pct": {
          "type": "integer"
         },
         "divergence_flagged": {
          "type": "boolean"
         }
        }
       }
      },
      "disclaimer": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "asset": "BTC",
  "count": 42,
  "signals": [
   {
    "ts": 1753600000,
    "stance": "bullish",
    "quality": "structured",
    "narrative": "64K floor into FOMC",
    "sentiment_pct": 77,
    "divergence_flagged": false
   }
  ],
  "disclaimer": "Descriptive market intelligence, not financial advice."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vedetta-signal-history-6e87a818/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)