# Nightshift Labs Base Balance Lookup

> Nightshift Labs Base Balance Lookup is a paid API for AI agents from nightshift-x402.nightshift-labs.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-18).

Returns ETH and USDC balances for a given Base network wallet address at the current block

## Facts

- Endpoint: GET https://nightshift-x402.nightshift-labs.workers.dev/v1/base/balance?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nightshift-labs-base-balance-lookup-5c37da83
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ae0Zn6IgdjPAS3wcw2_np

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 nightshift-labs-base-balance-lookup-5c37da83
```

Example prompt: What's the current ETH and USDC balance of the wallet 0x4200000000000000000000000000000000000006 on Base?

## When to prefer this

Use this endpoint when you need a quick, pay-per-call lookup of both ETH and USDC balances for any address on the Base L2 network without setting up your own RPC node or indexer. It is ideal for AI agents that need lightweight, on-demand balance checks with no subscription overhead, paying only $0.005 USDC per call via the x402 protocol.

## Known failure modes

- Invalid or malformed address (not matching 0x + 40 hex chars) returns a validation error
- Address not found on Base returns zero balances
- Network or RPC node outage may cause timeout or 5xx error
- Payment failure (insufficient USDC for x402 fee) blocks the call
- Rate limiting if too many calls are made in rapid succession

## How this service works

Base wallet balances: native ETH and USDC for any address, with the block number they were read at.

## Output

Returns a JSON object containing the ETH balance (as a decimal string), USDC balance (as a decimal string), the current block number, the chain name ('base'), and the queried wallet address. Example: {eth: '283543.09', usdc: '179.137106', block: 53585397, chain: 'base', address: '0x4200…0006'}.

## 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": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "eth": "283543.09",
  "usdc": "179.137106",
  "block": 53585397,
  "chain": "base",
  "address": "0x4200…0006"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nightshift-labs-base-balance-lookup-5c37da83/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from nightshift-x402.nightshift-labs.workers.dev](https://www.zero.xyz/host/nightshift-x402.nightshift-labs.workers.dev/llms.txt)
