{"uid":"cap_6F--nxzzjZUbS7DtwKcom","slug":"three-ws-billboard-slot-purchase-23d7fc02","name":"three.ws Billboard Slot Purchase","description":"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.","url":"https://three.ws/api/x402/billboard?utm_source=zero.xyz","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","$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"]}}}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AEpG572vmibZcT5qpcNNf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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'.","exampleUseCases":[{"title":"NFT project launch promotion","prompt":"Put my project's launch banner at https://myproject.com/launch.png on the three.ws billboard for coin world FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump with the caption 'Mint is live — grab yours now'."},{"title":"Community announcement in coin world","prompt":"Post an announcement on the three.ws billboard for coin world 9xTkMnRp2QsLzYbKfJwCvGhNpAeBdXoUiSyWqZmVcPr with the caption 'Community vote starts today — check Discord' and no image."},{"title":"Brand awareness with image-only ad","prompt":"Display my logo image https://mybrand.io/logo-billboard.png on the three.ws coin world billboard for Hk3mPqRzXnBcLwYvAeSdJoUiTyGfNpKbMqZxCvWdEs without any caption."}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T00:48:49.737Z","isFirstParty":false,"canonicalSlug":"three-ws-billboard-slot-purchase-23d7fc02"}