# Nightshift Labs Base Portfolio Lookup

> Nightshift Labs Base Portfolio 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 token holdings and USD valuations for a given wallet address on the Base blockchain

## Facts

- Endpoint: GET https://nightshift-x402.nightshift-labs.workers.dev/v1/base/portfolio?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-portfolio-lookup-407ec798
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3Bus1qRw3wDzYuS7vSIHW

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-portfolio-lookup-407ec798
```

Example prompt: What tokens does the Base wallet 0x1234567890abcdef1234567890abcdef12345678 hold, and what's the total USD value of the portfolio?

## When to prefer this

Use this endpoint when you need to look up on-chain token holdings and USD valuations specifically for a Base network wallet address. It is well-suited for AI agents that need to assess portfolio composition, net worth, or asset allocation for a given address without connecting directly to an RPC node. At $0.01 USDC per call via x402, it is cost-effective for single-address spot checks.

## Known failure modes

- Invalid or malformed wallet address (not matching 0x + 40 hex chars) returns a validation error
- Wallet address with no on-chain activity may return empty holdings array
- Tokens without available price feeds will return null for the USD value field
- Network or RPC issues with Base may cause lookup failures
- Payment failure via x402/USDC on Base will prevent the call from completing

## How this service works

Base wallet portfolio: ETH plus 12 major Base tokens (USDC, USDbC, DAI, EURC, WETH, cbETH, wstETH, cbBTC, AERO, DEGEN, VIRTUAL, BRETT) with non-zero balances, USD values from Chainlink ETH/USD and BTC/USD feeds, and a total.

## Output

A JSON object containing the chain identifier ('base'), current prices for BTC and ETH in USD, an array of token holdings (each with symbol, amount, and USD value where priced), and the total USD-priced portfolio value across all tokens.

## 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}$",
       "description": "wallet address on Base"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "base",
  "prices": {
   "BTC": 75826.24,
   "ETH": 2244.94
  },
  "holdings": [
   {
    "usd": 6734.6,
    "amount": "2.9999",
    "symbol": "ETH"
   },
   {
    "usd": 79709.11,
    "amount": "79709.10502",
    "symbol": "USDC"
   },
   {
    "usd": null,
    "amount": "3.0187",
    "symbol": "AERO"
   }
  ],
  "totalUsdPriced": 86463.08
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nightshift-labs-base-portfolio-lookup-407ec798/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)
