{"uid":"cap_cUH-IJf0NBuzo0sbDf027","slug":"x402ads-io-bd62f812","name":"x402ads.io Agent Analytics","description":"Provides paid analytics for agent activity and performance.","url":"https://x402ads.io/v1/agent/analytics","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","properties":{"period":{"enum":["7d","30d","lifetime"],"type":"string","default":"lifetime","description":"Time window for impression and conversion counts. Stocks (total_deposited, total_remaining) are always lifetime."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"period":"30d"}}},"response":{"_hint":"Across 0 campaigns: 0 impressions, 0 conversions (0.0% rate) over the last 30d.","stats":{"period":"30d","conversions":0,"impressions":0,"total_spend":"0","conversion_rate":0},"_actions":[{"rel":"campaigns","path":"/v1/agent/campaigns","method":"GET"},{"rel":"create","path":"/v1/agent/campaigns","method":"POST"}],"advertiser":{"wallet":"0x9CC42f3d9245B867ACccd630B43f906c1665b176","total_campaigns":0,"total_deposited":"0","total_remaining":"0","active_campaigns":0},"by_campaign":[]}},"exampleRequest":{"period":"30d"},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8lBqLDCf9rNfNg_3AWPH-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns analytics on x402 agent activity and ad performance metrics (impressions, conversions, deposits) over a configurable time window.","exampleAgentPrompt":"Pull my x402ads agent analytics for the last 30 days — I want to see impressions, conversions, and any lifetime deposit or remaining balance stats.","exampleUseCases":[{"title":"Weekly agent performance review","prompt":"Give me a quick summary of how my x402 agent performed this week — impressions, conversions, and let me know my current account balance."},{"title":"Lifetime ROI analysis for agent","prompt":"Show me everything — my total lifetime deposits, remaining balance, and all conversion data for my x402 agent so I can calculate ROI."},{"title":"7-day conversion spike investigation","prompt":"I noticed a spike in conversions last week. Pull my x402ads analytics for the past 7 days and show me impressions and conversions to understand what happened."}],"resultDescription":"Returns structured analytics data including impression counts, conversion counts, total deposited, and total remaining balance for the specified period (7d, 30d, or lifetime). Stock figures like total_deposited and total_remaining are always lifetime values regardless of period.","failureModes":["Invalid period enum value returns a validation error","Missing required input fields returns a 400 error","Insufficient USDC balance or payment failure blocks the request","No data available for the requested time window may return empty metric values","Authentication or facilitator issues may cause 402 or 403 responses"],"whenToPreferThis":"Use this endpoint when you need performance analytics specifically tied to x402 agent ad activity — impressions, conversions, and deposit balances. Prefer this over generic ad analytics tools when working within the x402 payment and agent ecosystem on x402ads.io.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:31:17.314Z","isFirstParty":false}