x402 Crypto Ads

Check out the x402 Ad Marketplace (UI)

Buy advertising space on 100+ crypto content sites using USDC with zero gas fees thanks to x402 gasless payments.

Quick Start

Ad Formats & Pricing

970×250 pixels - Wide banner format

Price: 1 USDC/hour

Best for cost-effective campaigns with good visibility

300×600 pixels - Vertical side placement

Price: 2 USDC/hour

Best for persistent visibility as users scroll

728×90 pixels - Top banner position

Price: 3 USDC/hour

Best for maximum visibility and brand awareness

Duration: 1 hour minimum, 7 days (168 hours) maximum

Article Submissions

Submit article ideas to crypto content sites. AI validates your topic and generates optimized titles and descriptions.

How It Works

Pricing

Prices vary by site, typically $3-50 USDC per article. Each site sets their own rate based on traffic and audience.

API Reference

Network & Payment Details

Purchase Ad Slot (x402 Payment)

bash
POST https://x402.anyspend.com/ads/buy

Programmatically purchase ad slots using x402 gasless payments. This endpoint requires x402 payment authorization.

Request Body:

{
  "productId": "slot_abc123",
  "buyerAddress": "0x742d35Cc6...",
  "startTime": "2025-01-15T14:00:00Z",
  "endTime": "2025-01-15T18:00:00Z",
  "adContent": {
    "imageUrl": "https://...",
    "linkUrl": "https://...",
    "altText": "Alt text",
    "title": "Ad title",
    "description": "Description"
  }
}

{
  "success": true,
  "data": {
    "purchaseId": "purch_123...",
    "bookingId": "booking_456...",
    "totalPrice": "5000000",
    "status": "confirmed"
  }
}

{
  "success": false,
  "error": "Slot already booked during this time"
}

Parameters:

• productId (required) - The ad slot ID from /ads/slots
• buyerAddress (required) - Your wallet address
• startTime (required) - Start time in ISO 8601 format
• endTime (required) - End time in ISO 8601 format
• adContent.imageUrl (required) - Direct URL to ad image
• adContent.linkUrl (required) - Landing page URL
• adContent.altText (required) - Image alt text
• adContent.title (optional) - Ad title
• adContent.description (optional) - Ad description

JavaScript/TypeScript Example:

typescript
import { wrapFetchWithPayment } from '@b3dotfun/anyspend-x402-fetch';
import { createWalletClient, custom, publicActions } from 'viem';
import { base } from 'viem/chains';

// Create wallet client
const walletClient = createWalletClient({
  account: '0x742d35Cc6...',
  chain: base,
  transport: custom(window.ethereum),
}).extend(publicActions);

// Wrap fetch with x402 payment
const fetchWithPayment = wrapFetchWithPayment(
  fetch,
  walletClient,
  BigInt(1000 * 10 ** 6) // Max 1000 USDC
);

// Purchase ad slot
const response = await fetchWithPayment(
  'https://x402.anyspend.com/ads/buy',
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      productId: 'slot_abc123',
      buyerAddress: '0x742d35Cc6...',
      startTime: '2025-01-15T14:00:00Z',
      endTime: '2025-01-15T18:00:00Z',
      adContent: {
        imageUrl: 'https://example.com/ad.jpg',
        linkUrl: 'https://example.com',
        altText: 'My ad',
        title: 'Check out our product!',
        description: 'Limited offer'
      }
    })
  }
);

const result = await response.json();
console.log('Booking ID:', result.data.bookingId);

Browse Sites (Free)

bash
GET https://x402.anyspend.com/ads/sites

List all available sites with pagination. This endpoint is free to call.

Query parameters:

• page - Page number (default: 1)
• limit - Results per page (default: 20, max: 100)
• search - Search by name/domain/keywords

curl "https://x402.anyspend.com/ads/sites?search=defi&limit=10"

const sites = await fetch('https://x402.anyspend.com/ads/sites?page=1&limit=20')
  .then(r => r.json());

{
  "success": true,
  "data": [
    {
      "siteId": "abc123",
      "siteName": "Crypto News Daily",
      "siteUrl": "https://cryptonews.example.com",
      "siteDomain": "cryptonews.com",
      "description": "Daily crypto news and analysis",
      "keywords": ["crypto", "bitcoin", "defi"],
      "availableSlots": ["leaderboard", "sidebar", "banner"],
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 156,
    "hasNext": true
  }
}

List All Slots (Free)

bash
GET https://x402.anyspend.com/ads/slots

List all available ad slots across all sites. This endpoint is free to call.

curl "https://x402.anyspend.com/ads/slots"

const slots = await fetch('https://x402.anyspend.com/ads/slots')
  .then(r => r.json());

{
  "success": true,
  "data": [
    {
      "slotId": "slot_abc123",
      "siteId": "site_123",
      "slotType": "leaderboard",
      "pricePerHour": "5000000"
    }
  ]
}

Get Slot Details (Free)

bash
GET https://x402.anyspend.com/ads/slots/:slotId

Returns static slot information including pricing, format, and associated site details. This endpoint is free to call.

curl "https://x402.anyspend.com/ads/slots/slot_banner_abc123"

{
  "success": true,
  "data": {
    "slot": {
      "slotId": "slot_banner_abc123",
      "siteId": "abc123",
      "slotType": "banner",
      "pricePerHour": "1000000",
      "available": true
    },
    "site": {
      "siteName": "Crypto News Daily",
      "siteUrl": "https://cryptonews.example.com"
    }
  }
}

Check Current Ad (Free)

bash
GET https://x402.anyspend.com/ads/slots/:slotId/current-ad

Returns the ad currently running in this slot, or indicates if the slot is available. This endpoint is free to call.

curl "https://x402.anyspend.com/ads/slots/slot_banner_abc123/current-ad"

{
  "success": true,
  "data": {
    "type": "paid",
    "ad": {
      "imageUrl": "https://example.com/ad.png",
      "linkUrl": "https://example.com/landing"
    },
    "booking": {
      "bookingId": "booking_xyz789",
      "startTime": "2024-02-01T10:00:00.000Z",
      "endTime": "2024-02-01T13:00:00.000Z"
    }
  }
}

{
  "success": true,
  "data": {
    "type": "empty"
  }
}

View Your Campaigns (Free)

bash
GET https://x402.anyspend.com/ads/bookings/buyer/:address

Track all your ad bookings - active, pending, and completed. This endpoint is free to call.

curl "https://x402.anyspend.com/ads/bookings/buyer/0xYourAddress"

{
  "success": true,
  "data": [
    {
      "bookingId": "booking_xyz789",
      "siteId": "abc123",
      "slotType": "banner",
      "startTime": "2024-02-01T10:00:00.000Z",
      "endTime": "2024-02-01T13:00:00.000Z",
      "adContent": {
        "imageUrl": "https://mysite.com/ad.png",
        "linkUrl": "https://mysite.com/landing"
      },
      "totalPrice": "3000000",
      "status": "active",
      "paymentTxHash": "0xabcdef...",
      "createdAt": "2024-01-22T16:30:00.000Z"
    }
  ]
}

Status values:

• active - Currently running
• pending - Scheduled for future
• completed - Campaign ended

Article Submission Endpoints

Validate Article Idea (Free)

bash
POST https://x402.anyspend.com/articles/validate

Validate an article idea and get AI-generated title and description. This endpoint is free to call - no payment required.

Request Body:

{
  "siteDomain": "baseradar.com",
  "userInput": "How to Use Base Pay for Creators in Your DApp"
}

{
  "success": true,
  "data": {
    "approved": true,
    "score": 92,
    "reasoning": "Excellent topic match for Base ecosystem content",
    "estimatedPrice": "15000000",
    "suggestedTitle": "How to Use Base Pay for Creators in Your DApp",
    "suggestedDescription": "Learn how to integrate Base Pay...",
    "userProvidedTitle": true,
    "message": "Your input is approved as-is"
  }
}

{
  "success": false,
  "data": {
    "approved": false,
    "score": 45,
    "reasoning": "Topic doesn't align with site's focus on Base ecosystem",
    "estimatedPrice": "15000000",
    "message": "Content doesn't fit the site's focus"
  }
}

Parameters:

• siteDomain (required) - Target site domain (e.g., "baseradar.com", "solanaecho.com")
• userInput (required) - Can be:
  • Complete article title (10-200 characters)
  • Tweet URL (e.g., "https://x.com/username/status/...")
  • Topic or idea (e.g., "base pay for creators")

AI Scoring:

• Score ≥80: Your input is perfect! Used as-is
• Score 70-79: Good content, AI provides improved suggestions
• Score <70: Rejected - topic doesn't fit the site

JavaScript Example:

javascript
const response = await fetch('https://x402.anyspend.com/articles/validate', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    siteDomain: 'baseradar.com',
    userInput: 'How to bridge assets to Base chain'
  })
});

const result = await response.json();
console.log('Approved:', result.data.approved);
console.log('Score:', result.data.score);
console.log('Title:', result.data.suggestedTitle);

Submit Article Request (x402 Payment)

bash
POST https://x402.anyspend.com/articles/buy

Submit an article request with x402 gasless payment. Requires prior validation approval.

Request Body:

{
  "buyerAddress": "0x742d35Cc6...",
  "siteDomain": "baseradar.com",
  "title": "How to Use Base Pay for Creators in Your DApp",
  "description": "Learn how to integrate Base Pay into your decentralized application..."
}

{
  "success": true,
  "data": {
    "requestId": "req_abc123...",
    "productSpecificId": "req_abc123...",
    "totalPrice": "15000000",
    "status": "pending"
  }
}

{
  "success": false,
  "error": "Title is required and must be 10-200 characters"
}

Parameters:

• buyerAddress (required) - Your wallet address
• siteDomain (required) - Target site domain
• title (required) - Article title (10-200 characters)
• description (required) - Article description/summary

JavaScript/TypeScript Example:

typescript
import { wrapFetchWithPayment } from '@b3dotfun/anyspend-x402-fetch';
import { createWalletClient, custom, publicActions } from 'viem';
import { base } from 'viem/chains';

// Create wallet client
const walletClient = createWalletClient({
  account: '0x742d35Cc6...',
  chain: base,
  transport: custom(window.ethereum),
}).extend(publicActions);

// Wrap fetch with x402 payment
const fetchWithPayment = wrapFetchWithPayment(
  fetch,
  walletClient,
  BigInt(1000 * 10 ** 6) // Max 1000 USDC
);

// Submit article request
const response = await fetchWithPayment(
  'https://x402.anyspend.com/articles/buy',
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      buyerAddress: '0x742d35Cc6...',
      siteDomain: 'baseradar.com',
      title: 'How to Use Base Pay for Creators in Your DApp',
      description: 'Learn how to integrate Base Pay into your decentralized application for seamless creator payments.'
    })
  }
);

const result = await response.json();
console.log('Request ID:', result.data.requestId);

View Your Article Requests (Free)

bash
GET https://x402.anyspend.com/articles/requests/buyer/:address

Track all your article requests - pending, in progress, and published. This endpoint is free to call.

curl "https://x402.anyspend.com/articles/requests/buyer/0xYourAddress"

{
  "success": true,
  "data": [
    {
      "requestId": "req_abc123",
      "siteName": "Base Radar",
      "siteDomain": "baseradar.com",
      "title": "How to Use Base Pay for Creators",
      "description": "Learn how to integrate Base Pay...",
      "totalPrice": "15000000",
      "status": "published",
      "publishedUrl": "https://baseradar.com/articles/base-pay-creators",
      "createdAt": "2025-01-15T10:00:00.000Z",
      "updatedAt": "2025-01-16T15:30:00.000Z"
    }
  ]
}

Status values:

• pending - Waiting for site to write article
• in_progress - Article is being written
• published - Article is live (includes publishedUrl)
• rejected - Article request was declined

Zero Gas with x402

x402 is the payment protocol that makes crypto payments feel like web2.

Traditional crypto payments:

• ❌ Multiple transactions (approve + transfer)
• ❌ $5-15 in gas fees
• ❌ 30-60 second wait times
• ❌ Complex multi-step flows

With x402:

• ✅ One signature - no transactions
• ✅ Zero gas fees
• ✅ Instant settlement
• ✅ Simple one-click purchase

How It Works

1. You sign a payment authorization message (not a transaction)
2. x402 facilitator submits the transaction for you
3. Facilitator pays the gas
4. You pay only the ad price

Security

• ✅ You control the signature
• ✅ Signatures expire (can't be replayed)
• ✅ One-time use with unique nonce
• ✅ Amount is locked (can't charge more)

Tips for Success

text
https://yoursite.com?utm_source=sitename&utm_medium=banner

Common Issues

Related: Article Submission Marketplace • x402 Overview • x402scan →