CryptoAd Network

Ends an ad for good (Banner, Native, Paid Visits). What it has not spent returns to the balance. It cannot be started again.

Buys prepaid ad credit at a fixed price: amount_usd in USDC, 1 USDC = $1.00 of credit (for example 5, 10, 25, 50, 100). The first call returns isError with the x402 PaymentRequired object; call again with the signed payment. Without an API key the paid result carries api_key: the key of a new account whose balance is the credit, shown once. With an API key the credit is added to that account. Orders placed with the key are then paid from the balance, with no further payment.

Creates an anonymous account with a zero balance and returns its API key, shown once. Only needed to upload an image before paying for anything (a Paid Visits ad needs one); otherwise use buy_ad_credit or create_ad, which create the account with the first payment.

Places an ad order. With an API key whose balance covers the price, it is paid from the balance. Otherwise the result is isError with the x402 PaymentRequired object for the exact price: sign it and call this tool again with the same order and the payment (in _meta["x402/payment"], or as payment_signature). Without an API key the paid result carries api_key, the key of the new account that owns the ad: store it, it is shown once. The ad goes to review; poll get_ad.

One ad of the account: status (in_review, active, paused, rejected, completed, archived), spend, what remains, and the reason if it was rejected.

Delivery of one ad: totals and a daily series (impressions, clicks, visits, spend).

The account's balance in USD: available, reserved by ads in review or live, and total.

What this service is, whether payments are available, and on which networks a payment can be made (USDC, x402), with the smallest and largest payment.

The catalog: every ad format (PTC, Sponsored Listing, Banner, Native, Paid Visits) with its fields, limits, pricing models, minimum bids, minimum order, image rules and an example order with its price. Read this before building an order.

The account's ads, newest first.

Pauses an active ad (Banner, Native, Paid Visits). Its budget stays reserved.

Validates an order and returns its exact price in USD with a breakdown. Creates nothing and costs nothing. An invalid order is answered with the code of the problem and the field it is in.

Resumes a paused ad: it serves again, within what is left of its budget.

Stores an image for a Paid Visits ad (required there) or a Banner ad (optional; PNG, JPEG or GIF of exactly one banner size, see list_ad_formats) and returns its id, to send as image_id in the order. Needs an API key.