# Alchemy Portfolio Token Balances

> Alchemy Portfolio Token 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-13).

Fetches token balances and USD values for one or more wallet addresses on a specified blockchain network using Alchemy's portfolio API

## Facts

- Endpoint: POST https://stablecrypto.dev/api/alchemy/portfolio/tokens
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/alchemy-portfolio-token-balances-a73a4419
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ADXzHLtwgKrT8mUr8ots0

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-token-balances-a73a4419 -d '<json body>'
```

Example prompt: Can you pull all the token balances and their current USD values for my wallet 0xAbc123... on eth-mainnet, including token metadata?

## When to prefer this

Use this endpoint when you need to enumerate all token holdings (ERC-20 and similar) across one or more wallet addresses on a specific EVM-compatible network, especially when you also want current USD valuations and token metadata in a single call. Prefer this over a raw RPC passthrough when you want pre-aggregated portfolio-style data rather than raw contract calls.

## Known failure modes

- Invalid or unsupported network slug returns an error or empty result
- Malformed wallet address causes a validation failure
- Payment of 0.01 USDC not received results in 402 Payment Required
- Network timeout from Alchemy upstream results in 504 or partial data
- Empty addresses array returns no data
- withPrices flag may return stale or unavailable price data for obscure tokens

## How this service works

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

## Output

Returns a map of token balances and associated USD values for the specified wallet addresses on the given network, optionally enriched with price data and token metadata such as name, symbol, and decimals

## 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"
  },
  "withPrices": {
   "type": "boolean"
  },
  "withMetadata": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/alchemy-portfolio-token-balances-a73a4419/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)