v1

latestOpenAPI 3.1.0Public2026-07-1316041.2 KB
Advertising

Submit an ad (quote-first flow, step 1)

Submit ad details and an image to get a payment quote. Returns a quote_id and an unsigned USDC transfer transaction. The caller signs and broadcasts the transaction from their Web3 wallet, then calls POST /api/ads/submit/pay to finalise. Rate limit: 10 requests/min/IP.

post/api/ads/submit

Response

Quote generated - sign and broadcast the transaction, then call /api/ads/submit/pay

quote_idstring

Use this in the /api/ads/submit/pay call

statusstring
expires_atstring date-time
paymentobject

Unsigned USDC transfer transaction and payment metadata

next_stepstring

Example response

{
  "quote_id": "sq_abc123",
  "status": "awaiting_payment"
}