# Beggar Bot Fluid Positions Endpoint (Base Mainnet)

> Beggar Bot Fluid Positions 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).

Retrieves fluid liquidity position data on Base mainnet, paid via x402 at $0.02 USDC per call

## Facts

- Endpoint: GET https://beggar-bot-demand.beggarbot.workers.dev/v1/fluidpositions?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-fluid-positions-endpoint-base-mainnet-226630fa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hrrbMeT4SAObVl3CwIh35

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-fluid-positions-endpoint-base-mainnet-226630fa
```

Example prompt: Can you fetch the current fluid positions on Base mainnet and show me what liquidity positions are active right now?

## When to prefer this

Use this endpoint when you need real-time fluid liquidity position data specifically on Base mainnet and are set up to pay via x402 micropayments in USDC. Prefer this over generic blockchain RPC calls when you want pre-processed, structured position data without building your own indexer.

## Known failure modes

- Payment not provided or insufficient — returns 402 Payment Required
- Invalid network parameter — returns error or defaults to base mainnet
- Malformed properties filter — returns 400 Bad Request
- Cloudflare Worker timeout or unavailability — returns 5xx error
- Rate limiting or quota exceeded — returns 429

## 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 JSON data describing fluid liquidity positions on Base mainnet (or Base Sepolia if specified), including position details and associated USDC liquidity state. Costs $0.02 USDC per call paid via x402 to the operator's wallet.

## 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-fluid-positions-endpoint-base-mainnet-226630fa/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)