# Beggar Bot HL Token Endpoint (Base Mainnet)

> Beggar Bot HL Token Endpoint (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).

Returns HL token data or high-level token information for Base mainnet USDC analysis, paid via x402 micropayment protocol

## Facts

- Endpoint: GET https://beggar-bot-demand.beggarbot.workers.dev/v1/hltoken?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-hl-token-endpoint-base-mainnet-af3d9bae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cm2dAAAbUzzyg9RdwRRcl

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-hl-token-endpoint-base-mainnet-af3d9bae
```

Example prompt: Can you grab the HL token info for USDC on Base mainnet from Beggar Bot? I want to see the high-level token properties for contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.

## When to prefer this

Choose this endpoint when you need high-level token data specifically on Base mainnet or Base Sepolia, and your agent supports x402 micropayment protocol. It is part of the Beggar Bot suite alongside /v1/verify, /v1/risk, and /v1/receipt, so prefer it when you are already operating in that ecosystem or need lightweight per-call token lookups at $0.02 USDC with no subscription required.

## Known failure modes

- 402 Payment Required if x402 micropayment of $0.02 USDC is not provided or fails
- Invalid or missing properties parameter returns malformed request error
- Network parameter unrecognized beyond base or base-sepolia
- Token contract address not found on the specified network
- Cloudflare Worker timeout or service unavailability

## 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 high-level token information and properties for the queried token on Base mainnet (or base-sepolia if specified), including token metadata and characteristics relevant to on-chain analysis.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/beggar-bot-hl-token-endpoint-base-mainnet-af3d9bae/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)
