{"uid":"cap_3NYlVBWpqnqY8DRCpGEpg","slug":"signalbound-portfolio-endpoint-c937fea0","name":"Signalbound Portfolio Endpoint","description":"Signalbound API for agent metadata, reveal-aware token reads, ERC-8004 registration files, and holder-gated tool routes.","url":"https://api.signalbound.art/portfolio","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"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"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0IgGG6VJ7HWjPeiC8UZKv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns an NFT portfolio summary for a wallet, gated by Signalbound token ownership, including holdings, offers received, and estimated USD value.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Holder-gated NFT portfolio audit","prompt":"I own Signalbound token 17 — use it to pull up the full NFT portfolio for my wallet 0xDead...Beef on Ethereum, including any offers I've received and the estimated USD value of everything."},{"title":"Check offers on a watched wallet","prompt":"With my Signalbound token 99 as clearance, scan wallet 0x1234...5678 on Ethereum and tell me what offers have come in on their NFTs and how many they hold total."},{"title":"Quick NFT count and brief for a wallet","prompt":"Using Signalbound token 5, give me a quick summary of wallet 0xABCD...EF01 on Ethereum — just the top 20 NFTs, the count, and a one-line brief of the portfolio."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:33:02.005Z","isFirstParty":false}