Four actions on one endpoint

Four actions on one endpoint. create opens a slot with its position, length, reserve price and closing time, and returns an admin token that only the opener holds. bid places a sealed bid, checked against the reserve, the slot length and the publisher's excluded categories before it is accepted — a rejected bid is recorded with its reason rather than silently dropped, so a bidder can see why it never competed.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

POST https://audio.halowerk.com/ad-slot-auction

Our checks, last 30 days

Example input (from the provider)

{
  "body": {
    "action": "create",
    "closes_at_unix": 1793735685,
    "position": "mid_roll",
    "publisher": "HALOWERK example publisher",
    "reserve_usdc": 5,
    "slot_label": "episode 1, mid-roll 1",
    "slot_seconds": 30
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "additionalProperties": false,
          "properties": {
            "action": {
              "description": "create opens a slot, bid places a sealed bid, close settles it, status reads it.",
              "enum": [
                "create",
                "bid",
                "close",
                "status"
              ],
              "type": "string"
            },
            "admin_token": {
              "description": "Required for close. Returned once by create.",
              "maxLength": 128,
              "type": "string"
            },
            "amount_usdc": {
              "description": "Sealed bid amount. bid only.",
              "maximum": 100000,
              "minimum": 0,
              "type": "number"
            },
            "auction_id": {
              "description": "Required for bid, close and status.",
              "maxLength": 64,
              "type": "string"
            },
            "bidder": {
              "description": "Who is bidding. bid only.",
              "maxLength": 120,
              "type": "string"
            },
            "category": {
              "description": "Advertiser category, checked against the exclusions. bid only.",
              "maxLength": 40,
              "type": "string"
            },
            "closes_at_unix": {
              "description": "Closing time in Unix seconds. create only. At most 30 days out.",
              "minimum": 0,
              "type": "integer"
            },
            "creative_seconds": {
              "description": "Length of the advertisement, checked against the slot. bid only.",
              "maximum": 180,
              "minimum": 1,
              "type": "integer"
            },
            "excluded_categories": {
              "description": "Advertiser categories the publisher refuses. create only.",
              "items": {
                "maxLength": 40,
                "type": "string"
              },
              "maxItems": 20,
              "type": "array"
            },
            "expected_listeners": {
              "description": "Reach the publisher claims. Recorded as a claim, not verified. create only.",
              "maximum": 100000000,
              "minimum": 0,
              "type": "integer"
            },
            "position": {
              "description": "Where the slot sits in the content. create only.",
              "enum": [
                "pre_roll",
                "mid_roll",
                "post_roll"
              ],
              "type": "string"
            },
            "publisher": {
              "description": "Name of the publisher offering the slot. create only.",
              "maxLength": 120,
              "type": "string"
            },
            "reserve_usdc": {
              "description": "Price below which the slot is not sold. create only.",
              "maximum": 100000,
              "minimum": 0,
              "type": "number"
            },
            "slot_label": {
              "description": "What is being sold, for example \"episode 41, mid-roll 2\". create only.",
              "maxLength": 200,
              "type": "string"
            },
            "slot_seconds": {
              "description": "Length of the slot. create only.",
              "maximum": 180,
              "minimum": 5,
              "type": "integer"
            }
          },
          "required": [
            "action"
          ],
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST",
            "PUT",
            "PATCH"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON