{"slug":"audio-halowerk-com-ad-slot-auction-a76ed3","title":"Four actions on one endpoint","host":"audio.halowerk.com","method":"POST","resource":"https://audio.halowerk.com/ad-slot-auction","category":"image","description":"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 ","price_listed":0.004,"price_asked":0.004,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":1189,"reported_calls_30d":2,"reported_payers_30d":2,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"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"},"output_schema":{"$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"},"history":[{"day":"2026-10-18","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.004,"price_match":true,"latency_ms":1189,"error":null}],"description_full":"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.","last_updated":"2026-10-15T00:55:05.527Z","schemes":["exact"]}