# Alchemy Portfolio NFT Balances

> Alchemy Portfolio NFT Balances is a paid API for AI agents from stablecrypto.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Fetches all NFT token balances held by one or more wallet addresses on a specified blockchain network via Alchemy

## Facts

- Endpoint: POST https://stablecrypto.dev/api/alchemy/portfolio/nfts
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/alchemy-portfolio-nft-balances-4eca50b4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EV_dXpm-ZR0bEZos7tQYp

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 alchemy-portfolio-nft-balances-4eca50b4 -d '<json body>'
```

Example prompt: What NFTs are currently held by these wallets 0xABC123 and 0xDEF456 on eth-mainnet? Include the full metadata for each token.

## When to prefer this

Use this endpoint when you need to enumerate all NFT holdings for one or more wallet addresses on a specific EVM-compatible network. Prefer this over the NFT collections endpoint when you want individual token-level balance data rather than collection-level aggregates. It is backed by Alchemy's indexed data making it reliable for mainnet and L2 queries.

## Known failure modes

- Invalid or unsupported network slug returns an error
- Malformed wallet addresses cause validation failures
- Missing required fields (network or addresses) returns a 400-style error
- Empty addresses array may return empty results
- Network congestion or Alchemy upstream issues may cause timeouts
- Payment not included or insufficient causes x402 payment required error

## How this service works

Pay-per-request access to CoinGecko, DefiLlama, Alchemy, and Etherscan APIs. No auth, no subscriptions.

## Output

Returns a mapping of wallet addresses to their NFT holdings on the specified network, optionally including rich token metadata such as name, image, and trait data for each NFT.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "network": {
   "type": "string",
   "description": "Alchemy network slug, e.g. eth-mainnet, base-mainnet"
  },
  "addresses": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Wallet addresses"
  },
  "withMetadata": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/alchemy-portfolio-nft-balances-4eca50b4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablecrypto.dev](https://www.zero.xyz/host/stablecrypto.dev/llms.txt)