# Beggar Bot Stablecoin Supply Lookup

> Beggar Bot Stablecoin Supply Lookup is a paid API for AI agents from beggar-bot-demand.beggarbot.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-20).

Returns stablecoin circulating supply data for Base mainnet (or Base Sepolia), filterable by symbol and chain, via a paid x402 API call.

## Facts

- Endpoint: GET https://beggar-bot-demand.beggarbot.workers.dev/v1/stablesupply?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/beggar-bot-stablecoin-supply-lookup-7a3703c4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_agEQ84YxHIz-rhBAzF7GT

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 beggar-bot-stablecoin-supply-lookup-7a3703c4
```

Example prompt: What's the current circulating supply of USDC on Base mainnet? Show me the top 15 stablecoins by supply.

## When to prefer this

Use this endpoint when you need on-chain stablecoin supply data specifically for the Base network (mainnet or Sepolia testnet), and you're operating in an x402-capable agent environment that can pay $0.02 USDC per call. Prefer this over generic DeFi APIs when you need Base-native, real-time stablecoin supply figures with pay-per-call pricing and no subscription required.

## Known failure modes

- Payment not completed — x402 payment of $0.02 USDC on Base mainnet not sent or rejected
- Invalid chain name provided — unrecognized chain parameter returns error
- Limit out of range — values outside 1-50 may be rejected or clamped
- Upstream on-chain data unavailable — node or indexer issues causing timeouts
- Malformed query parameters — incorrect types or missing required fields

## How this service works

Paid: /v1/verify, /v1/risk, /v1/receipt cost $0.01 USDC per call on Base mainnet via x402 (payTo 0x719227f384b66BFEF00093D6d8d32fA9dC2B40e7); utilities analyze Base mainnet (USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) by default, network=base-sepolia optional; /v1/receipt/verify and discovery files are free. Operator: Beggar Bot.

## Output

A JSON response containing a list of stablecoins (up to the requested limit) with their circulating supply figures on the specified chain (defaulting to Base mainnet). Each entry likely includes token symbol, contract address, and supply amount.

## 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",
     "properties": {
      "chain": {
       "type": "string",
       "description": "optional chain name e.g. Base"
      },
      "limit": {
       "type": "string",
       "description": "1-50 (default 15)"
      },
      "symbol": {
       "type": "string",
       "description": "optional e.g. USDC"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/beggar-bot-stablecoin-supply-lookup-7a3703c4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from beggar-bot-demand.beggarbot.workers.dev](https://www.zero.xyz/host/beggar-bot-demand.beggarbot.workers.dev/llms.txt)
