---
name: x402ads.io
description: x402ads.io is an advertising platform for autonomous agents, providing read access to advertiser analytics and campaign listings associated with a calling wallet. It exposes two read-only endpoints: one for aggregate account-level performance metrics and one for a paginated list of owned campaigns.
host: x402ads.io
---

# x402ads.io

x402ads.io serves agents that operate as advertisers within the x402ads ecosystem. It provides self-service visibility into advertising account state — spend balances, impression and conversion totals, and campaign inventory — without requiring manual dashboard access. It does not support campaign creation, modification, or deletion through these skills.

## When to use this host

Use x402ads.io when an agent needs to read its own advertiser account state — spend totals, impression and conversion metrics, or a list of owned campaigns. Do not use it to create, update, or delete campaigns; those operations require POST/PUT/DELETE endpoints not exposed here. Do not use it for real-time or streaming metrics — both skills return point-in-time snapshots. For details on a specific campaign by ID, neither skill is appropriate; a dedicated campaign-detail endpoint outside this host is needed.

## Capabilities

### Advertiser Account Intelligence

Provides a complete picture of an agent's advertising account: aggregate spend, impressions, conversions, and campaign counts alongside the enumerated list of active campaigns.

- **`fetch-agent-analytics`** — Returns advertiser analytics for an x402ads agent account, including campaign counts, total spend, impressions, conversions, and conversion rate.
- **`list-agent-campaigns`** — Returns a paginated list of ad campaigns owned by the calling wallet, with total count and actionable next-step hints.

## Workflows

### Account Health Check

*Use when an agent needs to assess its overall advertising performance and then enumerate its campaigns to identify which ones are active or require attention.*

1. **`fetch-agent-analytics`** — Retrieve aggregate account metrics including total spend, remaining balance, impressions, conversions, and active campaign count.
2. **`list-agent-campaigns`** — Fetch the paginated campaign list to cross-reference individual campaigns against the aggregate stats and discover available next-step actions.

## Skill reference

### `fetch-agent-analytics`

**Agent Analytics** — Returns advertiser analytics for an x402ads agent account, including campaign counts, total spend, impressions, conversions, and conversion rate.

*Use when:* Use when an agent needs to retrieve its own advertising performance data, including active campaign counts, spend totals, impression and conversion metrics, and links to related campaign actions.

*Not for:* Do not use for retrieving individual campaign details; use the /v1/agent/campaigns endpoint instead. Not suitable for real-time streaming metrics — this is a single-shot analytics snapshot.

**Returns:** Returns an advertiser object with wallet, campaign counts, and spend totals; a stats object with impressions, conversions, and conversion rate; a per-campaign array; a hint string; and action links for campaign management.

**Example:** `GET https://x402ads.io/v1/agent/analytics`

---

### `list-agent-campaigns`

**Agent Campaigns List** — Returns a paginated list of ad campaigns owned by the calling wallet, with total count and actionable next-step hints.

*Use when:* Use when an agent needs to retrieve the current set of ad campaigns associated with its wallet, check campaign count, or discover available actions like creating a new campaign or viewing analytics.

*Not for:* Do not use to create a new campaign; use POST /v1/agent/campaigns instead. Not suitable for fetching details of a specific campaign; use GET /v1/agent/campaigns/{id} for that.

**Returns:** Returns a campaigns array (empty if none exist), total count, pagination limit and offset, a _hint string with next-step guidance, and a _actions array of available follow-on API calls.

**Example:** `GET https://x402ads.io/v1/agent/campaigns`

---