{"uid":"cap_ds-0zC_JesC2bJVxkm5UW","slug":"x402-wallet-ledger-accounting-report-72d62718","name":"x402 Wallet Ledger & Accounting Report","description":"Your AI agent's books in one call: structured USDC accounting for any wallet on Base (the x402 settlement asset) — revenue (incoming) vs expenses (outgoing), net, transaction count, top paying counterparties and payees, and a weekly breakdown over a 7d/30d/90d window. Turnkey bookkeeping / expense and revenue report an agent can drop straight into its accounting. The value is the structuring, not raw data access.","url":"https://x402-endpoints.onrender.com/agent/ledger?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["wallet"],"properties":{"period":{"type":"string","description":"Reporting window: 7d | 30d | 90d | all (default 30d)"},"wallet":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"EVM wallet address (0x + 40 hex) to report on"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"notes":["Revenue = incoming USDC (x402 settlements received); expenses = outgoing USDC.","Ledger reflects USDC transfers on Base only; not every USDC transfer is an x402 payment."],"query":{"period":"30d","wallet":"0x1D1B81247C407521E2A01F3E21514870dcf1620f"},"cached":false,"source":"Base Blockscout USDC transfers (base.blockscout.com), settlement asset for x402","summary":{"currency":"USDC","net_usdc":17.32,"tx_count":221,"revenue_usdc":19.42,"expenses_usdc":2.1,"last_activity":"2026-07-01T18:30:00Z","unique_payees":3,"unique_payers":47,"first_activity":"2026-06-02T09:00:00Z","avg_expense_usdc":0.26,"avg_revenue_usdc":0.09,"expense_tx_count":8,"revenue_tx_count":213,"largest_expense_usdc":1,"largest_revenue_usdc":0.5},"timestamp":"2026-07-02T12:00:00Z","disclaimer":"Automated bookkeeping of on-chain USDC activity on Base; informational, not accounting/tax advice. Reconcile against your own records.","top_payees":[{"address":"0xdef...222","tx_count":4,"volume_usdc":1.5}],"top_payers":[{"address":"0xabc...111","tx_count":40,"volume_usdc":3.2}],"data_freshness":{"as_of":"2026-07-01T18:30:00Z","sources":["Base Blockscout USDC transfers"],"row_count":221,"age_seconds":51300,"period_days":30,"retrieved_at":"2026-07-02T12:00:00Z","deterministic":true},"weekly_breakdown":[{"week":"2026-W27","net_usdc":4.8,"tx_count":55,"revenue_usdc":5.1,"expenses_usdc":0.3}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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":{"p10Cents":"4.0000","medianCents":"4.0000","p90Cents":"4.0000","minCents":"4.0000","maxCents":"4.0000","p95Cents":"4.0000","sampleCount":1,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yjytKe7HNF_o1ORSmCiNQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns structured USDC accounting for any Base wallet — revenue vs expenses, net position, transaction count, top counterparties, and weekly breakdown over a configurable time window","exampleAgentPrompt":"Can you pull a 30-day bookkeeping report for my Base wallet 0xAbC1234567890abcdef1234567890abcdef123456 — I want to see revenue vs expenses, net, and who my top paying counterparties are?","exampleUseCases":null,"resultDescription":"A structured JSON object containing: total incoming USDC (revenue), total outgoing USDC (expenses), net balance, transaction count, ranked list of top paying counterparties, ranked list of top payees, and a week-by-week breakdown — all scoped to the requested wallet and time window (7d, 30d, 90d, or all-time).","failureModes":["Invalid or malformed wallet address (not matching ^0x[a-fA-F0-9]{40}$) returns a validation error","Wallet has no on-chain USDC activity on Base returns empty or zero-value report","Unrecognized period value returns an error or falls back to default 30d","Payment not included or insufficient USDC payment returns 402 Payment Required","Render cold start may cause occasional slow response or timeout"],"whenToPreferThis":"Choose this endpoint when you need a structured, human-readable accounting summary — revenue vs expenses, net, counterparty rankings, weekly cadence — for a single Base wallet address, without having to parse raw transaction data yourself. Prefer it over raw blockchain RPC calls or block explorers when the goal is bookkeeping or financial reporting rather than low-level transaction inspection.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:34:14.068Z","isFirstParty":false,"canonicalSlug":"x402-wallet-ledger-accounting-report-72d62718"}