{"uid":"cap_T-pLg-aiireG64-17viJo","slug":"nostr-zap-radar-zap-receipt-aggregator-a69ac9f3","name":"Nostr Zap Radar – Zap Receipt Aggregator","description":"Collects kind 9735 zap receipts addressed to one public key over up to twelve relays, merges them by event id and reports who sent how much over the requested window. Every amount comes from decoding the BOLT-11 invoice carried in the receipt, not from the amount tag of the zap request, because the two can disagree and only the invoice was payable.","url":"https://nostr.halowerk.com/zap-radar","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"days":{"type":"integer","default":30,"maximum":365,"minimum":1,"description":"Length of the window in days, counted back from now."},"pubkey":{"type":"string","description":"Recipient public key as 64 hex characters, npub or nprofile."},"relays":{"type":"array","items":{"type":"string"},"maxItems":12,"description":"wss relay addresses. Left empty, ten measured default relays are used."},"top_senders":{"type":"integer","default":10,"maximum":50,"minimum":1,"description":"How many senders the ranking lists."},"max_receipts":{"type":"integer","default":200,"maximum":400,"minimum":10,"description":"Upper bound on receipts fetched per relay. Reaching it sets truncated."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wzR6DGD89caqJBw6vZ4BP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Collects kind 9735 zap receipts for a given Nostr public key across up to 12 relays, deduplicates by event ID, decodes BOLT-11 invoices to extract actual amounts, and reports who zapped how much within a requested time window.","exampleAgentPrompt":"Pull all the zap receipts sent to Nostr pubkey npub1abc123... across the last 7 days using up to 12 relays and tell me who zapped the most and what the total sats received were, using the actual BOLT-11 invoice amounts.","exampleUseCases":[{"title":"Creator earnings dashboard for Nostr","prompt":"Can you check how many sats in zaps the Nostr creator with pubkey npub1xyz789... received over the past 30 days, broken down by sender, using all available relays?"},{"title":"Top zapper leaderboard for a profile","prompt":"For the Nostr account npub1def456..., give me a ranked list of who sent the most sats in zaps over the last week — I want to know my biggest supporters."},{"title":"Zap activity audit for a specific time window","prompt":"Fetch all kind 9735 zap receipts addressed to npub1ghi012... from yesterday and tell me the total amount received, making sure the amounts come from the actual Lightning invoices and not the zap request tags."}],"resultDescription":"A deduplicated list of zap receipts for the requested public key, each with the sender's identity, the amount in satoshis decoded from the BOLT-11 invoice, the event ID, and a summary of who sent how much over the requested time window.","failureModes":["Public key not found on any of the specified relays — returns empty results","Relay connection timeouts causing incomplete data collection","Invalid or unparseable BOLT-11 invoice in a zap receipt — that receipt may be skipped","Malformed or non-hex/non-bech32 public key input causing a 400-style error","No zap receipts found in the requested time window — returns zero results"],"whenToPreferThis":"Use this endpoint when you need accurate Lightning satoshi amounts received by a specific Nostr account from zap receipts, especially when you need cross-relay deduplication and BOLT-11 invoice decoding (not the potentially mismatched amount tag). Prefer this over manual relay queries when aggregating across many relays or analyzing zapper identity and volume trends.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:50:28.073Z","isFirstParty":false}