{"uid":"cap_Ej8vCfkhzB8voOZhabRpV","slug":"radio-withzero-xyz-radio-withzero-earnings-balance-and-ledger-5b32efc6","name":"Radio.WithZero Earnings Balance and Ledger","description":"Your earnings balance and ledger (broadcast tips, airtime spend).","url":"https://radio.withzero.xyz/api/v1/earnings","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["buyerId","wallet","balanceUsdc","availableUsdc","entries"],"properties":{"wallet":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The wallet a withdrawal would pay out to, or null until you link one via POST /api/v1/buyer/links."},"buyerId":{"type":"string","description":"Your buyer account — the key these earnings are held under, whichever channel you called on."},"entries":{"type":"array","items":{"type":"object","required":["kind","amountUsdc","showId","createdAt"],"properties":{"kind":{"type":"string"},"showId":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"amountUsdc":{"type":"string"}},"additionalProperties":false}},"balanceUsdc":{"type":"string","description":"Settled earnings balance."},"availableUsdc":{"type":"string","description":"Balance minus in-flight withdrawals — what you can withdraw now."}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","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":"metered","summary":"metered — billed by usage","primary":{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_zSFztNKKDtRrh7G0Ka9wK","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"radio.earnings:1"}],"brandName":"radio.withzero.xyz","brandSlug":"radio-withzero-xyz-mpp","brandBaseUrl":"https://radio.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Returns the authenticated broadcaster's USDC earnings balance and a full ledger of tips received and airtime purchases on radio.withzero.xyz.","exampleAgentPrompt":"What's my current earnings balance on the radio station, and can you show me all the tips and airtime charges in my ledger?","exampleUseCases":[{"title":"Check balance before cashing out","prompt":"How much USDC do I have available to withdraw from my radio earnings right now, and what's my settled balance?"},{"title":"Review tip income by show","prompt":"Show me my full earnings ledger so I can see which of my radio shows earned tips and how much each one brought in."},{"title":"Audit airtime spending vs tips earned","prompt":"Can you pull up my radio earnings history so I can see all the airtime I've spent broadcasting versus the tips I've received from listeners?"}],"resultDescription":"Returns a JSON object containing: the broadcaster's wallet address, their settled USDC balance, their currently available (withdrawable) USDC balance, and an array of ledger entries — each with an entry type (e.g. 'tip' or 'airtime'), the USDC amount, the associated show ID (if any), and a creation timestamp.","failureModes":["Unauthenticated request returns 401 — valid wallet credentials required","No entries in ledger if broadcaster has never earned tips or spent airtime — returns empty entries array","Network timeout if the platform is under load","Balance may lag real-time if transactions are in-flight — availableUsdc accounts for pending withdrawals but not unconfirmed tips"],"whenToPreferThis":"Use this endpoint when the broadcaster needs to check their current financial position on radio.withzero.xyz — either to decide whether to withdraw, to audit their tip income per show, or to reconcile airtime spending. It is the only endpoint that provides a full USDC ledger combining both inflows (tips) and outflows (airtime) in one response. Prefer this over the withdrawal endpoint when you only need to inspect balances without initiating a transfer.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:32:21.943Z","isFirstParty":true}