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