# TBS Crypto & DeFi API – Market Data Endpoint

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

Returns real-time token market data (price, market cap, volume, supply, 24h change) for a given cryptocurrency by ID or symbol, powered by Coinpaprika.

## Facts

- Endpoint: GET https://crypto-x402.tbs-digital.com/crypto/market?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tbs-crypto-defi-api-market-data-endpoint-03e4ea7b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Md9kLBre_anX16GSleRt3

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-api-market-data-endpoint-03e4ea7b
```

Example prompt: What's the current price, market cap, 24h volume, and percent change for Bitcoin right now? Use its Coinpaprika ID btc-bitcoin.

## When to prefer this

Choose this endpoint when you need real-time spot price and core market metrics (market cap, volume, supply, rank, 24h change) for a single cryptocurrency, billed at sub-cent cost via USDC on Base with no API key required. Prefer it over aggregator APIs when operating in agentic or autonomous workflows that benefit from micropayment-native, keyless access. It is best suited for single-token lookups rather than bulk or historical queries.

## Known failure modes

- Invalid or unrecognized symbol/ID returns an error or empty market object
- Stale data if Coinpaprika upstream is delayed
- Missing optional query params (id or symbol) may result in a default or error response
- Rate limiting or payment failure if USDC balance is insufficient for x402 micropayment
- Network timeout if upstream data provider is unavailable

## 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 the token's Coinpaprika ID, name, symbol, rank, current USD price, market cap, 24h trading volume, circulating supply, total supply, 24h percent change, and observation timestamp, plus metadata (source, request ID, generated_at, payer address/network).

## 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": {
      "id": {
       "type": "string",
       "description": "Coinpaprika id, e.g. btc-bitcoin"
      },
      "symbol": {
       "type": "string",
       "description": "Common ticker, e.g. btc, eth, sol"
      }
     }
    }
   },
   "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"
      },
      "source": {
       "type": "string"
      },
      "request_id": {
       "type": "string"
      },
      "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
  },
  "source": "coinpaprika",
  "request_id": "0b21c0e6-6a3f-4e2a-8b1e-2f9d4c7a1e55",
  "generated_at": "2026-08-11T12:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tbs-crypto-defi-api-market-data-endpoint-03e4ea7b/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)