# BCS Wallet Overview via x402 Preflight

> BCS Wallet Overview via x402 Preflight is a paid API for AI agents from base-agent-preflight.bytoken2023.workers.dev, paid per call via x402, $0.08/call, status unknown (last checked 2026-09-14).

Fetches a blockchain wallet summary (balances, assets, valuations) for a given address and chain, proxied through an x402-gated preflight service.

## Facts

- Endpoint: GET https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/bcs/wallet-overview
- Price: $0.08/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bcs-wallet-overview-via-x402-preflight-9f0f11a1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_35XrL9rD6qyP5KsMgFrm7

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 bcs-wallet-overview-via-x402-preflight-9f0f11a1
```

Example prompt: Give me a wallet overview for address 0xABC123... on the ethereum chain, and include valuations in USDC so I can see the full balance breakdown.

## When to prefer this

Choose this endpoint when you need a structured, aggregated wallet overview for a specific blockchain address, especially within an x402 agent-commerce context where you need to verify buyer wallet composition before a purchase. Prefer it over raw RPC calls when you want normalized asset summaries with optional valuation in a target asset, and when operating within the BlockchainSecurity Atlantis data ecosystem.

## Known failure modes

- Missing required 'blockchain' or 'address' query parameters returns a validation error
- Invalid address format (not matching pattern ^[A-Za-z0-9:_-]{3,128}$) causes a 400 rejection
- Unsupported or misspelled chain slug causes upstream lookup failure
- Upstream BlockchainSecurity Atlantis service unavailability yields a 502 or timeout
- Payment not provided or insufficient USDC balance results in x402 payment-required response
- Invalid token contract format in 'contracts' parameter causes a parse error

## How this service works

Machine-payable service intelligence for discovering, verifying, and monitoring identity, risk, authorization, execution-preflight, and evidence APIs before autonomous agents spend.

## Output

Returns a JSON object with the product identifier ('bcs-wallet-overview'), upstream service name, request metadata (request_id, credit_cost, credit_remaining), and the upstream response containing a 'data' object with wallet holdings and a 'meta' block with the request ID. The data block includes asset balances, token compositions, and optional valuations for the queried address on the specified blockchain.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "blockchain",
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "pattern": "^[A-Za-z0-9:_-]{3,128}$",
       "description": "Address to summarize."
      },
      "symbols": {
       "type": "string",
       "pattern": "^[A-Za-z0-9,._-]{1,240}$",
       "description": "Optional comma-separated asset symbols to include."
      },
      "contracts": {
       "type": "string",
       "pattern": "^[A-Za-z0-9,:._-]{1,1000}$",
       "description": "Optional comma-separated token contracts to include."
      },
      "blockchain": {
       "type": "string",
       "pattern": "^[a-z0-9_-]{2,32}$",
       "description": "BlockchainSecurity chain slug."
      },
      "output_asset": {
       "type": "string",
       "pattern": "^[A-Za-z0-9._-]{1,40}$",
       "description": "Optional output asset for valuation where supported."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "product",
      "upstream_service",
      "upstream_response"
     ],
     "properties": {
      "product": {
       "type": "string"
      },
      "request": {
       "type": "object"
      },
      "provenance": {
       "type": "object"
      },
      "upstream_headers": {
       "type": "object"
      },
      "upstream_service": {
       "type": "string"
      },
      "upstream_response": {
       "type": "object"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "product": "bcs-wallet-overview",
  "upstream_headers": {
   "request_id": "example-request-id",
   "credit_cost": null,
   "credit_remaining": null
  },
  "upstream_service": "blockchainsecurity-atlantis",
  "upstream_response": {
   "data": {},
   "meta": {
    "request_id": "example-request-id"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bcs-wallet-overview-via-x402-preflight-9f0f11a1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from base-agent-preflight.bytoken2023.workers.dev](https://www.zero.xyz/host/base-agent-preflight.bytoken2023.workers.dev/llms.txt)