# TBS Crypto & DeFi Bundle API

> TBS Crypto & DeFi Bundle API is a paid API for AI agents from x402.tbs-digital.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns a single-call snapshot combining spot prices, full market data, top-10 chains by TVL, and best yield pools by APY for specified tokens and chain

## Facts

- Endpoint: GET https://x402.tbs-digital.com/crypto/bundle
- 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/tbs-crypto-defi-bundle-api-480437f0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Uci8OL8c38849ufDBgaZk

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 tbs-crypto-defi-bundle-api-480437f0
```

Example prompt: Give me a full crypto and DeFi snapshot — spot prices and market data for BTC and ETH, top 10 chains by TVL, and the best yield pools by APY on Ethereum.

## When to prefer this

Choose this endpoint when you need crypto prices, market data, TVL rankings, and yield pool data simultaneously in a single API call — ideal for AI agents building dashboards, portfolio summaries, or DeFi opportunity scanners that would otherwise require 3-4 separate API calls to different providers. Prefer this over individual data endpoints when latency and request cost efficiency matter and you need the combined snapshot in one shot.

## Known failure modes

- Invalid or unsupported token symbols return empty price array or error
- Unsupported chain name for yield slice may return empty top_yields array
- Network/upstream data provider outage may return stale or null market data
- Missing required query params fall back to defaults (btc,eth for symbols; Ethereum for chain) — no explicit error
- Payment failure via x402 results in 402 response before data is returned

## How this service works

Complete crypto and DeFi snapshot in ONE call for AI agents: spot prices for your tokens, full market data (market cap, 24h volume, supply, 24h change) for the lead token, top-10 chains by TVL, and the best yield pools by APY. Prices, market, TVL and yields together — the most complete crypto+DeFi call per request.

## Output

A JSON object containing: an array of spot prices for requested token symbols, full market data for the lead token (market cap, 24h volume, circulating supply, 24h price change), an array of the top 10 blockchains ranked by TVL, an array of top yield pools sorted by APY for the specified chain, plus metadata including request ID, data source, and generation timestamp.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "chain": {
       "type": "string",
       "description": "Chain for the yield slice (default Ethereum)"
      },
      "symbols": {
       "type": "string",
       "description": "Comma-separated tickers (default btc,eth)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "payer": {
       "type": "object",
       "properties": {
        "address": {
         "type": "string",
         "nullable": true
        },
        "network": {
         "type": "string"
        }
       }
      },
      "market": {
       "type": "object",
       "nullable": true
      },
      "prices": {
       "type": "array"
      },
      "source": {
       "type": "string"
      },
      "request_id": {
       "type": "string"
      },
      "top_chains": {
       "type": "array"
      },
      "top_yields": {
       "type": "array"
      },
      "generated_at": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tbs-crypto-defi-bundle-api-480437f0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.tbs-digital.com](https://www.zero.xyz/host/x402.tbs-digital.com/llms.txt)