# Beggar Bot Fee Categories Lookup (Base mainnet)

> Beggar Bot Fee Categories Lookup (Base mainnet) 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-04).

Fetches DeFi protocol fee and revenue data by category (dailyFees, dailyRevenue, dailyHoldersRevenue) for a specified chain via the Beggar Bot agent utilities service

## Facts

- Endpoint: GET https://beggar-bot-demand.beggarbot.workers.dev/v1/feecats?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-04
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/beggar-bot-fee-categories-lookup-base-mainnet-f2b89e10
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_t0vf3PljcZ_wIcv_clCKo

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-fee-categories-lookup-base-mainnet-f2b89e10
```

Example prompt: Can you fetch the daily fees data for all chains using the Beggar Bot fee categories endpoint, using the dailyFees type?

## When to prefer this

Use this endpoint when you need on-chain DeFi fee and revenue metrics specifically scoped to Base mainnet (or base-sepolia for testing), and you want structured data broken down by fee category (fees, protocol revenue, or holder revenue). Prefer this over generic blockchain explorers when you need pre-aggregated daily financial metrics for DeFi protocols accessible via a pay-per-call x402 micropayment model.

## Known failure modes

- Invalid 'type' enum value returns an error or empty result
- Unsupported chain name returns no data
- Payment failure via x402 (insufficient USDC balance) results in 402 response
- Network timeout from Cloudflare Workers edge
- Missing required query parameters may return a generic error

## 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

Returns a JSON object containing fee and revenue metrics for the requested category (dailyFees, dailyRevenue, or dailyHoldersRevenue) scoped to the specified chain or all chains. Exact fields depend on the category type but typically include numeric fee/revenue values, timestamps, and protocol breakdowns.

## 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": {
      "type": {
       "type": "string",
       "description": "dailyFees|dailyRevenue|dailyHoldersRevenue"
      },
      "chain": {
       "type": "string",
       "description": "chain name (all)"
      }
     }
    }
   },
   "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-fee-categories-lookup-base-mainnet-f2b89e10/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)