{"uid":"cap_lLPRvrUF5pd7lGpyKfRFc","slug":"synapse-api-optimism-nft-lookup-by-owner-c5fb7649","name":"Synapse API — Optimism NFT Lookup by Owner","description":"High-speed API suite for AI processing, web scraping, and smart data utilities across 57+ blockchain networks. Pay-per-call via x402.","url":"https://synapse-api-brown.vercel.app/api/optimism/nft/by-owner","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"number"},"owner":{"type":"string"},"pageKey":{"type":"string"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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_HmyVi0OZ1yEkrZyoXXEmy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves all NFTs owned by a given wallet address on the Optimism blockchain network.","exampleAgentPrompt":"Look up all the NFTs owned by the Optimism wallet address 0xAbC1234...5678 and show me up to 20 results.","exampleUseCases":[{"title":"NFT portfolio audit for a wallet","prompt":"Can you pull up all the NFTs held by the Optimism wallet 0xDEADBEEF...1234? I want to see everything in that portfolio, up to 50 items."},{"title":"Paginating through a large NFT collection","prompt":"I already fetched the first page of NFTs for Optimism address 0xABCD...5678 — can you get me the next page using the page key 'abc123xyz'?"},{"title":"Verifying NFT ownership before gating access","prompt":"Does the Optimism wallet 0x9876...CAFE hold any NFTs? Check and list what it owns so I can verify if they qualify for our token-gated community."}],"resultDescription":"Returns a list of NFT assets owned by the specified wallet on Optimism, including token metadata such as contract address, token ID, name, image, and collection details. Supports pagination via a page key for wallets with large holdings.","failureModes":["Invalid or malformed wallet address returns an error or empty result","Unsupported address format (non-EVM) causes a bad request","Expired or invalid pageKey causes pagination failure","Rate limiting or payment failure (x402) blocks the request","Empty result set if the wallet holds no NFTs on Optimism"],"whenToPreferThis":"Use this endpoint when you specifically need to enumerate NFTs held by a wallet on the Optimism L2 network. Prefer this over generic Ethereum NFT lookups when the user is working within the Optimism ecosystem. Ideal for portfolio viewers, NFT-gated access checks, and wallet analytics on Optimism.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:45:06.894Z","isFirstParty":false}