# SpendTheBits Yield Safety Scorer

> SpendTheBits Yield Safety Scorer is a paid API for AI agents from x402.spendthebits.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-11).

Returns a 0–100 safety score with sub-components, observed and risk-adjusted APY, and Auto-Defense exit signal for vetted stablecoin vaults

## Facts

- Endpoint: GET https://x402.spendthebits.com/@stbclaudeprod/yield-safety/?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/spendthebits-yield-safety-scorer-b3607d39
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_x1OiWMQMU4FfMmdIkAWQz

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 spendthebits-yield-safety-scorer-b3607d39
```

Example prompt: What's the safety score and risk-adjusted APR for the Aave USDC vault — and would SpendTheBits Auto-Defense exit it right now?

## When to prefer this

Use this endpoint when you need a structured, multi-component DeFi safety assessment specifically for stablecoin vaults — including protocol trust, TVL, audit history, and a live Auto-Defense exit signal — rather than generic token risk scores or broad portfolio analytics. It is especially valuable when making yield-farming decisions where risk-adjusted APR matters as much as headline yield.

## Known failure modes

- Invalid or unrecognized venue ID or contract address returns an error or empty result
- Network not supported (e.g. testnet address on mainnet scope) may yield no match
- Payment not received or insufficient USDC causes 402 rejection
- Vault not in the vetted list returns no data rather than a score
- Rate limiting or stale data if vault was recently added

## How this service works

0-100 safety score with components (protocol trust, TVL depth, audits, track record), observed and risk-adjusted APR, and whether STB's Auto-Defense would exit — for every vetted stablecoin vault, or one by ?venue=<id|pool address>.

## Output

A JSON object per vault containing: a composite safety score (0–100) with component breakdowns (protocol trust, TVL depth, audits, track record), observed APR, risk-adjusted APR, and a boolean or signal indicating whether SpendTheBits Auto-Defense would exit the position. When no venue filter is applied, results cover all vetted mainnet stablecoin vaults.

## 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": [],
     "properties": {
      "venue": {
       "type": "string",
       "maxLength": 96,
       "description": "Venue id (UUID) or vault/pool contract address; omit it to get every vetted mainnet vault"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "as_of",
      "network",
      "count",
      "venues",
      "methodology"
     ],
     "properties": {
      "as_of": {
       "type": "string",
       "description": "When this answer was computed (ISO 8601)"
      },
      "count": {
       "type": "integer"
      },
      "venues": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "id",
         "name",
         "protocol",
         "asset",
         "pool_address",
         "enabled",
         "safety_score",
         "factors",
         "observed_apr",
         "risk_adjusted_apr",
         "tvl_usd",
         "auto_defense"
        ],
        "properties": {
         "id": {
          "type": "string"
         },
         "name": {
          "type": "string"
         },
         "asset": {
          "type": "string"
         },
         "chain": {
          "type": "string"
         },
         "audited": {
          "type": "boolean"
         },
         "enabled": {
          "type": "boolean"
         },
         "factors": {
          "type": "array",
          "items": {
           "type": "object"
          },
          "description": "The components the score is the sum of"
         },
         "tvl_usd": {
          "type": "string"
         },
         "chain_id": {
          "type": [
           "integer",
           "null"
          ]
         },
         "protocol": {
          "type": "string"
         },
         "incidents": {
          "type": "integer"
         },
         "scored_at
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/spendthebits-yield-safety-scorer-b3607d39/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.spendthebits.com](https://www.zero.xyz/host/x402.spendthebits.com/llms.txt)
