# TBS Crypto & DeFi Bundle API

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

Returns a unified bundle of real-time token prices, market data, DeFi TVL by chain, and top yield/APY pools in a single sub-cent call

## Facts

- Endpoint: GET https://crypto-x402.tbs-digital.com/crypto/bundle?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tbs-crypto-defi-bundle-api-51ca0572
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9b84OOsoBQs-gqx6Vkptv

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-51ca0572
```

Example prompt: Pull me the latest prices for BTC and ETH along with DeFi TVL rankings and top yield pools on Ethereum — I want the full market snapshot in one shot.

## When to prefer this

Choose this endpoint when you need a comprehensive crypto + DeFi data snapshot in a single call rather than stitching together multiple APIs. Ideal for AI agents that need prices, market cap, DeFi TVL, and yield data simultaneously at sub-cent cost. Prefer over DefiLlama or Coinpaprika directly when you want a unified schema, keyless access, and USDC micropayment billing via x402 on Base with no API key management.

## Known failure modes

- Missing or invalid payment via x402 returns 402 Payment Required
- Invalid token symbol returns empty prices array or partial results
- Unsupported chain name falls back to Ethereum default
- Rate limiting or upstream DefiLlama/Coinpaprika outage may return stale or partial data
- Malformed query parameters may result in default values being used silently

## How this service works

Crypto & DeFi data for AI agents in one sub-cent call: real-time token prices, market data (market cap, volume, supply), DeFi TVL by protocol or chain, yield/APY pools, and a flagship bundle combining all of it. DefiLlama + Coinpaprika, keyless, unified schema, USDC-payable via x402 on Base.

## Output

A JSON object containing: real-time prices array with USD price and confidence per token, full market data for the primary coin (rank, market cap, volume, supply, 24h change), top DeFi chains ranked by TVL in USD, top yield pools with APY, base APY, TVL, chain, project, symbol, and stablecoin flag, plus metadata including source attribution, request ID, payer address, 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"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "payer": {
   "address": "0x0000000000000000000000000000000000000000",
   "network": "base"
  },
  "market": {
   "id": "btc-bitcoin",
   "name": "Bitcoin",
   "rank": 1,
   "symbol": "BTC",
   "price_usd": 64980.12,
   "observed_at": "2026-08-11T12:00:00.000Z",
   "total_supply": 21000000,
   "market_cap_usd": 1281000000000,
   "volume_24h_usd": 25400000000,
   "circulating_supply": 19720000,
   "percent_change_24h": 1.24
  },
  "prices": [
   {
    "coin": "coingecko:ethereum",
    "symbol": "ETH",
    "price_usd": 3542.18,
    "confidence": 0.99,
    "observed_at": "2026-08-11T12:00:00.000Z"
   }
  ],
  "source": "defillama+coinpaprika",
  "request_id": "0b21c0e6-6a3f-4e2a-8b1e-2f9d4c7a1e55",
  "top_chains": [
   {
    "name": "Ethereum",
    "tvl_usd": 52100000000
   }
  ],
  "top_yields": [
   {
    "apy": 5.21,
    "chain": "Ethereum",
    "symbol": "USDC",
    "project": "aave-v3",
    "tvl_usd": 452000000,
    "apy_base": 5.02,
    "stablecoin": true
   }
  ],
  "generated_at": "2026-08-11T12:00:00.000Z"
 }
}
```

## More

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