# Signalbound Portfolio Endpoint

> Signalbound Portfolio Endpoint is a paid API for AI agents from api.signalbound.art, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns an NFT portfolio summary for a wallet, gated by Signalbound token ownership, including holdings, offers received, and estimated USD value.

## Facts

- Endpoint: POST https://api.signalbound.art/portfolio
- 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/signalbound-portfolio-endpoint-c937fea0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3NYlVBWpqnqY8DRCpGEpg

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 signalbound-portfolio-endpoint-c937fea0 -d '<json body>'
```

Example prompt: Using my Signalbound token ID 42, scan wallet 0xAbC123... on Ethereum and give me a full portfolio summary — NFTs held, any offers I've received, and the estimated total value.

## When to prefer this

Choose this endpoint when you need holder-gated, clearance-aware NFT portfolio data for a specific wallet, particularly when the caller possesses a Signalbound token that unlocks reveal-aware or restricted metadata. Prefer over generic NFT APIs when Signalbound ERC-7496 clearance levels and offer data are required alongside holdings.

## Known failure modes

- Missing or invalid tokenId causes authentication failure — caller must own the specified Signalbound token
- Wallet address not found or has no NFTs returns empty nfts array with nftCount 0
- Unsupported chain identifier results in an error response
- Insufficient clearance level on the Signalbound token may restrict or block data access
- Rate limits or payment failure (x402 underpayment) result in 402 Payment Required response

## How this service works

Signalbound API for agent metadata, reveal-aware token reads, ERC-8004 registration files, and holder-gated tool routes.

## Output

Returns a JSON object containing the scanned wallet address, chain, total NFT count, array of NFT details, array of offers received on those NFTs, a natural-language brief summarizing the portfolio, the caller's address, the clearance level granted by the Signalbound token, and an estimated total USD value of the holdings.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "tokenId"
 ],
 "properties": {
  "chain": {
   "type": "string",
   "description": "Chain identifier (default ethereum)."
  },
  "tokenId": {
   "type": "integer",
   "description": "Signalbound token ID used for ERC-7496 clearance-gated access. The authenticated caller must own it."
  },
  "nftLimit": {
   "type": "integer",
   "description": "Max NFTs to return (default 50)."
  },
  "walletAddress": {
   "type": "string",
   "description": "Wallet to scan. Defaults to the authenticated caller."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "wallet",
  "chain",
  "nftCount",
  "nfts",
  "offersReceived",
  "brief"
 ],
 "properties": {
  "nfts": {
   "type": "array"
  },
  "brief": {
   "type": "string"
  },
  "chain": {
   "type": "string"
  },
  "caller": {
   "type": "string"
  },
  "wallet": {
   "type": "string"
  },
  "nftCount": {
   "type": "integer"
  },
  "clearance": {
   "type": "string"
  },
  "offersReceived": {
   "type": "array"
  },
  "estimatedValueUsd": {
   "type": "number"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/signalbound-portfolio-endpoint-c937fea0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.signalbound.art](https://www.zero.xyz/host/api.signalbound.art/llms.txt)