# three.ws Billboard Slot Purchase

> three.ws Billboard Slot Purchase is a paid API for AI agents from three.ws, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-23).

Books a paid advertising slot on a 3D coin-world billboard by supplying an image URL and/or caption, returning the slot start/end times and booking confirmation.

## Facts

- Endpoint: GET https://three.ws/api/x402/billboard?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/three-ws-billboard-slot-purchase-23d7fc02
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6F--nxzzjZUbS7DtwKcom

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability three-ws-billboard-slot-purchase-23d7fc02
```

Example prompt: Book a billboard ad slot on the three.ws coin world FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump — show the image https://myproject.com/banner.png with the caption 'gm from the gallery'.

## When to prefer this

Use this endpoint when you need to programmatically purchase and display an advertisement on a three.ws 3D coin-world billboard using micropayments. It is ideal for crypto-native promotion, NFT launches, or community announcements where the target audience inhabits Solana-based virtual worlds and payment is handled via x402/USDC.

## Known failure modes

- Invalid or non-base58 coin mint address returns a validation error
- Neither image nor caption provided — at least one is required
- Caption exceeds 80 characters — truncation or rejection
- Image URL is unreachable or not a valid http/https URI
- Payment of $0.05 USDC not fulfilled — 402 payment required response
- Coin world does not exist or billboard slot unavailable

## How this service works

Make a 3D AI agent from a selfie in 60 seconds. Drop one HTML tag to embed it on any website. Agents think on IBM watsonx.ai (Granite); optionally charge per chat with built-in micropayments.

## Output

A JSON object confirming the booking with: ok (true), the coin mint address, the payer's wallet, the payment asset and amount in atomics, the network (e.g. solana), the slot start and end timestamps in ISO 8601, and the slot duration in hours (1–24).

## Request schema (JSON Schema)

```json
{
 "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",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "coin"
     ],
     "properties": {
      "coin": {
       "type": "string",
       "pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
       "description": "The coin-world mint — which world’s billboard to set."
      },
      "image": {
       "type": "string",
       "format": "uri",
       "description": "http/https image URL, cover-fit onto the panel. Optional if a caption is given."
      },
      "caption": {
       "type": "string",
       "maxLength": 80,
       "description": "Short caption shown in a strip under the image. Optional if an image is given."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "ok",
      "coin",
      "slotHours",
      "startsAt",
      "endsAt"
     ],
     "properties": {
      "ok": {
       "type": "boolean",
       "const": true
      },
      "coin": {
       "type": "string"
      },
      "asset": {
       "type": [
        "string",
        "null"
       ]
      },
      "image": {
       "type": [
        "string",
        "null"
       ]
      },
      "payer": {
       "type": [
        "string",
        "null"
       ]
      },
      "endsAt": {
       "type": "string",
       "format": "date-time"
      },
      "caption": {
       "type": [
        "string",
        "null"
       ]
      },
      "network": {
       "type": [
        "string",
        "null"
       ]
      },
      "startsAt": {
       "type": "string",
       "format": "date-time"
      },
      "slotHours": {
       "type": "integer",
       "maximum": 24,
       "minimum": 1
      },
      "amountAtomics": {
       "type": [
        "string",
        "null"
       ]
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "coin": "FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump",
  "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "image": "https://three.ws/og-image.png",
  "payer": "wwwPqsM4N7T9J69tB82nLyzxqsH159j4orftLTQfUGV",
  "endsAt": "2026-06-29T00:42:09.000Z",
  "caption": "gm from the gallery",
  "network": "solana",
  "startsAt": "2026-06-28T18:42:09.000Z",
  "slotHours": 6,
  "amountAtomics": "50000"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-billboard-slot-purchase-23d7fc02/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from three.ws](https://www.zero.xyz/host/three.ws/llms.txt)