# Beggar Bot JUP Holdings Lookup (Base Mainnet)

> Beggar Bot JUP Holdings 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 Jupiter (JUP) token holdings for a given Base58 wallet address on Base mainnet, returning up to a configurable number of rows

## Facts

- Endpoint: GET https://beggar-bot-demand.beggarbot.workers.dev/v1/jupholdings?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-jup-holdings-lookup-base-mainnet-d4f15539
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6C28JNNUjBa6CXJavT86Q

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-jup-holdings-lookup-base-mainnet-d4f15539
```

Example prompt: Can you check the JUP token holdings for Base wallet 0xAbc123... and show me the top 50 results?

## When to prefer this

Use this endpoint when you need to look up JUP (Jupiter) token holdings specifically on Base mainnet for a given wallet address. It is part of the Beggar Bot suite and uses x402 micropayment protocol at $0.02 USDC per call, making it suitable for on-demand agent queries rather than bulk analytics pipelines.

## Known failure modes

- Invalid or malformed Base58 wallet address returns an error
- Missing required wallet query parameter returns a 400-level error
- Payment not provided or insufficient USDC results in a 402 Payment Required response
- Network connectivity issues to Base mainnet data sources may cause timeouts
- Wallet with no JUP holdings returns an empty result set

## 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 array of JUP (Jupiter) token holding records for the specified Base58 wallet address on Base mainnet, with up to the specified number of rows (default 50). Each record likely includes token amounts, positions, or related holding metadata.

## 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": {
      "limit": {
       "type": "string",
       "description": "rows (50)"
      },
      "wallet": {
       "type": "string",
       "description": "base58 address"
      }
     }
    }
   },
   "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-jup-holdings-lookup-base-mainnet-d4f15539/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)