Request an On-Air Shoutout read on the GM Farcaster livestream

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0x8a99FEF40D17e0bd6d48Ce088Cc207847D1C0596",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "5000000",
    "maxTimeoutSeconds": 300
  }
]

{
  "bazaar": {
    "info": {
      "input": {
        "body": {
          "read_text": "Today's GM is brought to you by Acme Frames — the fastest way to ship a Farcaster mini app. acmeframes.xyz",
          "sponsor_name": "Acme Frames"
        },
        "bodyType": "json",
        "method": "POST",
        "type": "http"
      },
      "output": {
        "example": {
          "amount": "$5",
          "payer": "0x1234567890123456789012345678901234567890",
          "request_id": "sho_8f3c2a1b9d4e",
          "status": "pending_review",
          "status_url": "https://gateway.gmfarcaster.com/v1/shoutout/sho_8f3c2a1b9d4e",
          "submitted_at": "2026-09-16T12:00:00.000Z"
        },
        "type": "json"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "body": {
              "properties": {
                "contact": {
                  "description": "Optional contact details for follow-up about the read.",
                  "properties": {
                    "email": {
                      "type": "string"
                    },
                    "farcaster": {
                      "type": "string"
                    },
                    "x": {
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "notes": {
                  "description": "Optional internal notes for the GM Farcaster team. Never read on air.",
                  "type": "string"
                },
                "read_text": {
                  "description": "The script read live on air. Keep it tight — read aloud on the show.",
                  "maxLength": 280,
                  "type": "string"
                },
                "refund_to_wallet": {
                  "description": "Optional wallet override to receive a refund if the request is declined. Defaults to the verified on-chain payer.",
                  "type": "string"
                },
                "sponsor_name": {
                  "description": "The name of the sponsor or project to credit on air.",
                  "maxLength": 120,
                  "type": "string"
                },
                "url": {
                  "description": "Optional link to include or reference for the sponsor.",
                  "format": "uri",
                  "type": "string"
                }
              },
              "required": [
                "sponsor_name",
                "read_text"
              ],
              "type": "object"
            },
            "bodyType": {
              "enum": [
                "json",
                "form-data",
                "text"
              ],
              "type": "string"
            },
            "method": {
              "enum": [
                "POST"
              ],
              "type": "string"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method",
            "bodyType",
            "body"
          ],
          "type": "object"
        },
        "output": {
          "properties": {
            "example": {
              "type": "object"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  }
}

curl "https://gateway.gmfarcaster.com/v1/shoutout"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

const res = await fetch("https://gateway.gmfarcaster.com/v1/shoutout");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

import httpx
res = httpx.get("https://gateway.gmfarcaster.com/v1/shoutout")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header