Skip to main content

All Available Slots

Get all ad slots across all sites.

API Endpoint

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

Try It

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

Example Response

{
  "success": true,
  "data": [
    {
      "slotId": "slot_banner_abc123",
      "siteId": "abc123",
      "slotType": "banner",
      "pricePerHour": "1000000",
      "available": true
    },
    {
      "slotId": "slot_sidebar_abc123",
      "siteId": "abc123",
      "slotType": "sidebar",
      "pricePerHour": "2000000",
      "available": true
    }
  ]
}
Prices are in USDC wei (6 decimals). Divide by 1,000,000 to get USDC amount.Example: "1000000" = 1 USDC per hour

Ad Slot Types

Check Specific Slot

Get details about a specific ad slot.

API Endpoint

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

Try It

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

Example Response

{
  "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",
      "description": "Daily crypto news and analysis"
    }
  }
}

See What’s Currently Running

Check what ad is currently displayed in a slot.

API Endpoint

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

Try It

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

Response

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

Calculate Your Cost

Formula: Hours × Price Per Hour = Total Cost

Examples

Banner - 24 hours

24 hours × 1 USDC = 24 USDC

Sidebar - 12 hours

12 hours × 2 USDC = 24 USDC

Leaderboard - 6 hours

6 hours × 3 USDC = 18 USDC

Banner - 1 week

168 hours × 1 USDC = 168 USDC
Minimum booking: 1 hour
Maximum booking: 7 days (168 hours)

Tips for Choosing Slots

Banner format offers the best value at 1 USDC/hour. Start here to test.
Leaderboard has highest visibility but costs 3x more. Worth it for major launches.
Instead of 24 hours on one site, try 6 hours on 4 different sites for better reach.
Book 1-2 hours first to test performance before committing to longer periods.

Next Steps