{"openapi":"3.1.0","info":{"title":"Game Theory Layer for AI Agents","description":"Equilibrium-aware primitives for AI agents. Tier 1: negotiation (sell-side + buy-side, with cryptographic first-strike). Tier 2: auctions (Myerson, Vickrey, English). Tier 3: mechanism design (Gale-Shapley, optimal auction, posted-price). All endpoints free today; LLM drafting is BYOK (you bring your own LLM key).\n\nEmpirical: SNHP rank #1/21 in NegMAS round-robin tournament; p<0.014 vs Aspiration / Split-the-Diff / Fair Demand.\n\nDiscovery: GET /v1/catalog for tool list, /llms.txt for LLM-readable agent guide.","version":"0.1.0"},"paths":{"/v1/negotiation/sell/next_offer":{"post":{"tags":["negotiation"],"summary":"Sell-side next-offer recommendation","description":"Recommends the next utility level to offer given the current state. The `pareto_knob` interpolates between empirically-mapped extremes: 0=max deal rate, 1=max head-to-head margin. Free endpoint (math only).","operationId":"negotiation_sell_next_offer_v1_negotiation_sell_next_offer_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SellNextOfferRequest"}}},"required":true},"responses":{"200":{"description":"Recommendation produced","headers":{"X-GT-Cost-USD":{"description":"Cost of this call (always 0 for free tier)","schema":{"type":"string"}},"X-GT-Latency-Ms":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SellNextOfferResponse"}}}},"400":{"description":"Invalid input"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auction/bidder/optimal_bid":{"post":{"tags":["auctions"],"summary":"Optimal bid for first-price/Vickrey/English auction","operationId":"auction_bidder_optimal_bid_v1_auction_bidder_optimal_bid_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OptimalBidRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OptimalBidResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auction/seller/optimal_reserve":{"post":{"tags":["auctions"],"summary":"Myerson optimal reserve price","operationId":"auction_seller_optimal_reserve_v1_auction_seller_optimal_reserve_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OptimalReserveRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OptimalReserveResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auction/seller/format_recommendation":{"post":{"tags":["auctions"],"summary":"Recommend an auction format given seller weights","operationId":"auction_seller_format_recommendation_v1_auction_seller_format_recommendation_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormatRecRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormatRecResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auction/simulate":{"post":{"tags":["auctions"],"summary":"Monte Carlo auction simulation","operationId":"auction_simulate_v1_auction_simulate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimulateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimulateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/catalog":{"get":{"tags":["discovery"],"summary":"Tool catalog for agent discovery","description":"Machine-readable list of all tools with cost class and stability. Cacheable, no auth required. Agents read this first.","operationId":"catalog_v1_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/llms.txt":{"get":{"tags":["discovery"],"summary":"Agent-readable guide to the toolkit","operationId":"llms_txt_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/v1/keys":{"post":{"tags":["discovery"],"summary":"Programmatic API key issuance (no human approval)","description":"Self-serve key issuance for AI agents. No human approval gate. Idempotent on agent_id within 24h. All endpoints currently free; rate-limited to 600 requests/minute per key.","operationId":"issue_key_v1_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssueKeyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssueKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/telemetry/report_outcome":{"post":{"tags":["telemetry"],"summary":"Attach an outcome to a previously-recorded recommendation","description":"Must be called within the same ISO week as the recommendation. Per-week agent-hash bounding caps outcome reporting at ~7 days (by design — eliminates long-horizon behavioral fingerprinting).","operationId":"telemetry_report_outcome_v1_telemetry_report_outcome_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportOutcomeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportOutcomeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/telemetry/delete":{"delete":{"tags":["telemetry"],"summary":"GDPR Article 17 — delete all telemetry rows for this key","description":"Deletes all rows whose week-hash matches any of this key's possible week hashes within an 18-month retention window. Returns the row count deleted. Note: SQLite/Postgres tombstone reclaim is deferred (full storage reclaim within 30 days).","operationId":"telemetry_delete_v1_telemetry_delete_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TelemetryDeleteResponse"}}}}}}},"/v1/telemetry/export":{"get":{"tags":["telemetry"],"summary":"GDPR Article 15 — export all telemetry rows for this key","operationId":"telemetry_export_v1_telemetry_export_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TelemetryExportResponse"}}}}}}},"/v1/negotiation/buy/next_offer":{"post":{"tags":["negotiation"],"summary":"Buy-side next-offer recommendation with defense bundle","operationId":"negotiation_buy_next_offer_v1_negotiation_buy_next_offer_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BuyNextOfferRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BuyNextOfferResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/negotiation/detect_anchor_attack":{"post":{"tags":["negotiation"],"summary":"Z-score anchor-attack detection","operationId":"negotiation_detect_anchor_attack_v1_negotiation_detect_anchor_attack_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DetectAnchorAttackRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DetectAnchorAttackResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/negotiation/declare_first_strike":{"post":{"tags":["negotiation"],"summary":"Cryptographic commit to a buyer reservation (signed attestation)","description":"The buyer-side answer to the structural disadvantage of going second. Buyer commits to a reservation hash; server returns an EdDSA-signed attestation JWT that the buyer can show to the seller. Seller can verify via /v1/keys/trust_anchor. Buyer reveals at acceptance.","operationId":"negotiation_declare_first_strike_v1_negotiation_declare_first_strike_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeclareFirstStrikeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeclareFirstStrikeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/negotiation/reveal_first_strike":{"post":{"tags":["negotiation"],"summary":"Reveal a first-strike commitment to obtain the binding offer","operationId":"negotiation_reveal_first_strike_v1_negotiation_reveal_first_strike_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RevealFirstStrikeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RevealFirstStrikeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/keys/trust_anchor":{"get":{"tags":["discovery"],"summary":"Public key for verifying first-strike attestations","operationId":"keys_trust_anchor_v1_keys_trust_anchor_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/v1/mechanism/gale_shapley":{"post":{"tags":["mechanism"],"summary":"Stable matching via deferred acceptance","description":"Classic Gale-Shapley. Proposers iterate through their preference lists; each receiver tentatively holds the best offer it has seen. Returns a proposer-optimal stable matching plus a (should-be-empty) list of blocking pairs as a sanity check. Capacities supported for school-choice variants.","operationId":"mechanism_gale_shapley_v1_mechanism_gale_shapley_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GaleShapleyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GaleShapleyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mechanism/optimal_auction_design":{"post":{"tags":["mechanism"],"summary":"Myerson revenue-optimal auction (asymmetric IPV)","description":"Per-bidder Myerson reserves. Allocation rule: argmax virtual value, subject to clearing the seller's valuation. Under symmetric IPV this collapses to second-price-with-reserve and matches the Tier 2 `optimal_reserve` answer.","operationId":"mechanism_optimal_auction_design_v1_mechanism_optimal_auction_design_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OptimalAuctionDesignRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OptimalAuctionDesignResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mechanism/posted_price_optimal":{"post":{"tags":["mechanism"],"summary":"Gallego-van Ryzin posted-price (static + dynamic schedule)","description":"Single-product dynamic pricing. Returns the static-price upper bound, a Monte Carlo revenue estimate, and a dynamic price schedule from the backward DP.","operationId":"mechanism_posted_price_optimal_v1_mechanism_posted_price_optimal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostedPriceRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostedPriceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/health":{"get":{"tags":["discovery"],"summary":"Liveness check","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"BuyNextOfferRequest":{"properties":{"share_outcome":{"type":"boolean","title":"Share Outcome","description":"Opt-in: contribute this (anonymized) call to the prior corpus. Default False. Requires account-level consent set at /v1/keys issuance.","default":false},"vertical":{"anyOf":[{"type":"string","enum":["ad_inventory","saas_procurement","cloud_compute","freight_logistics","media_licensing","m_and_a_buyside","m_and_a_sellside","real_estate","energy_trading","professional_services","marketplace_b2b","other"]},{"type":"null"}],"title":"Vertical","description":"Self-declared vertical (allowlisted enum). Required when share_outcome=True. Use 'other' if none fit."},"my_reservation":{"type":"number","maximum":1.0,"minimum":0.0,"title":"My Reservation"},"seller_offer_history":{"items":{"type":"number"},"type":"array","maxItems":128,"title":"Seller Offer History","description":"Seller's offers evaluated in our (buyer's) utility space, in [0, 1]"},"my_offer_history":{"items":{"type":"number"},"type":"array","maxItems":128,"title":"My Offer History"},"deadline_rounds":{"type":"integer","maximum":64.0,"minimum":1.0,"title":"Deadline Rounds"},"pareto_knob":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Pareto Knob","description":"Buyer-side Pareto knob (0=max deal rate, 1=max margin)","default":0.5},"defenses":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Defenses","description":"Defense bundle; default ['schelling_commitment', 'anchor_attack_detection']"},"market_prior":{"anyOf":[{"$ref":"#/components/schemas/MarketPrior"},{"type":"null"}],"description":"Required when anchor_attack_detection is in defenses"}},"type":"object","required":["my_reservation","deadline_rounds"],"title":"BuyNextOfferRequest"},"BuyNextOfferResponse":{"properties":{"recommended_offer":{"type":"number","title":"Recommended Offer"},"acceptance_probability":{"type":"number","title":"Acceptance Probability"},"expected_payoff":{"type":"number","title":"Expected Payoff"},"warnings":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Warnings"},"defense_actions":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Defense Actions"},"rationale":{"type":"string","title":"Rationale"},"posterior":{"additionalProperties":true,"type":"object","title":"Posterior"},"rubinstein_share":{"type":"number","title":"Rubinstein Share"},"schelling_floor":{"type":"number","title":"Schelling Floor"}},"type":"object","required":["recommended_offer","acceptance_probability","expected_payoff","warnings","defense_actions","rationale","posterior","rubinstein_share","schelling_floor"],"title":"BuyNextOfferResponse"},"DeclareFirstStrikeRequest":{"properties":{"buyer_id":{"type":"string","maxLength":128,"minLength":1,"title":"Buyer Id"},"seller_id":{"type":"string","maxLength":128,"minLength":1,"title":"Seller Id"},"reservation_hash":{"type":"string","maxLength":43,"minLength":43,"pattern":"^[A-Za-z0-9_\\-]{43}$","title":"Reservation Hash","description":"SHA-256 base64url of (reservation || nonce || salt || ids)"},"deadline_iso":{"type":"string","maxLength":64,"minLength":15,"title":"Deadline Iso","description":"ISO 8601 deadline, e.g. 2026-04-29T14:00:00Z"},"binding_ttl_seconds":{"type":"integer","maximum":86400.0,"minimum":60.0,"title":"Binding Ttl Seconds"}},"type":"object","required":["buyer_id","seller_id","reservation_hash","deadline_iso","binding_ttl_seconds"],"title":"DeclareFirstStrikeRequest"},"DeclareFirstStrikeResponse":{"properties":{"commitment_id":{"type":"string","title":"Commitment Id"},"attestation_jwt":{"type":"string","title":"Attestation Jwt"},"expires_at_unix":{"type":"integer","title":"Expires At Unix"},"expires_at_iso":{"type":"string","title":"Expires At Iso"},"trust_anchor_public_key_pem":{"type":"string","title":"Trust Anchor Public Key Pem"}},"type":"object","required":["commitment_id","attestation_jwt","expires_at_unix","expires_at_iso","trust_anchor_public_key_pem"],"title":"DeclareFirstStrikeResponse"},"DetectAnchorAttackRequest":{"properties":{"opponent_offer_history":{"items":{"type":"number"},"type":"array","maxItems":128,"minItems":0,"title":"Opponent Offer History"},"market_prior":{"$ref":"#/components/schemas/MarketPrior"}},"type":"object","required":["opponent_offer_history","market_prior"],"title":"DetectAnchorAttackRequest"},"DetectAnchorAttackResponse":{"properties":{"is_anchor_attack":{"type":"boolean","title":"Is Anchor Attack"},"z_score":{"type":"number","title":"Z Score"},"severity":{"type":"number","title":"Severity"},"recommended_response":{"type":"string","title":"Recommended Response"},"rationale":{"type":"string","title":"Rationale"}},"type":"object","required":["is_anchor_attack","z_score","severity","recommended_response","rationale"],"title":"DetectAnchorAttackResponse"},"FormatRecRequest":{"properties":{"bidder_value_prior":{"$ref":"#/components/schemas/PriorParams"},"n_bidders":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"N Bidders"},"seller_valuation":{"type":"number","minimum":0.0,"title":"Seller Valuation"},"weights":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Weights"}},"type":"object","required":["bidder_value_prior","n_bidders","seller_valuation"],"title":"FormatRecRequest"},"FormatRecResponse":{"properties":{"recommended_format":{"type":"string","title":"Recommended Format"},"scores":{"additionalProperties":true,"type":"object","title":"Scores"},"expected_revenue_by_format":{"additionalProperties":true,"type":"object","title":"Expected Revenue By Format"},"rationale":{"type":"string","title":"Rationale"}},"type":"object","required":["recommended_format","scores","expected_revenue_by_format","rationale"],"title":"FormatRecResponse"},"GaleShapleyRequest":{"properties":{"proposers":{"items":{"$ref":"#/components/schemas/Proposer"},"type":"array","maxItems":1024,"minItems":1,"title":"Proposers"},"receivers":{"items":{"$ref":"#/components/schemas/Receiver"},"type":"array","maxItems":1024,"minItems":1,"title":"Receivers"}},"type":"object","required":["proposers","receivers"],"title":"GaleShapleyRequest"},"GaleShapleyResponse":{"properties":{"matching":{"additionalProperties":true,"type":"object","title":"Matching"},"unmatched_proposers":{"items":{"type":"string"},"type":"array","title":"Unmatched Proposers"},"blocking_pairs":{"items":{"items":{"type":"string"},"type":"array"},"type":"array","title":"Blocking Pairs"},"n_proposals":{"type":"integer","title":"N Proposals"}},"type":"object","required":["matching","unmatched_proposers","blocking_pairs","n_proposals"],"title":"GaleShapleyResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"IssueKeyRequest":{"properties":{"agent_id":{"type":"string","maxLength":128,"minLength":3,"title":"Agent Id","description":"Stable identifier for the calling agent"},"contact_email":{"type":"string","title":"Contact Email","description":"Contact email for issues / overage notifications"},"intended_use_summary":{"type":"string","maxLength":1024,"minLength":8,"title":"Intended Use Summary","description":"One-sentence description of the intended use case"},"telemetry_consent":{"type":"boolean","title":"Telemetry Consent","description":"Opt-in to contribute anonymized recommendation→outcome pairs to the prior corpus. Default False. Set at issuance and immutable afterwards (revocation = /v1/telemetry/delete + don't pass share_outcome=True). See /llms.txt for the privacy contract.","default":false}},"type":"object","required":["agent_id","contact_email","intended_use_summary"],"title":"IssueKeyRequest"},"IssueKeyResponse":{"properties":{"api_key":{"type":"string","title":"Api Key"},"tier":{"type":"string","title":"Tier"},"rate_limit_per_minute":{"type":"integer","title":"Rate Limit Per Minute"},"created_at":{"type":"integer","title":"Created At"},"balance_usd_cents":{"type":"integer","title":"Balance Usd Cents","description":"Remaining credit balance in cents"},"telemetry_consent":{"type":"boolean","title":"Telemetry Consent","description":"True if opted into telemetry at issuance"},"reused":{"type":"boolean","title":"Reused","description":"True if an existing key for this agent_id was returned"}},"type":"object","required":["api_key","tier","rate_limit_per_minute","created_at","balance_usd_cents","telemetry_consent","reused"],"title":"IssueKeyResponse"},"MarketPrior":{"properties":{"mu":{"type":"number","title":"Mu","description":"Mean utility-to-buyer of typical seller openings, in [0, 1]"},"sigma":{"type":"number","exclusiveMinimum":0.0,"title":"Sigma","description":"Std of typical seller openings"}},"type":"object","required":["mu","sigma"],"title":"MarketPrior"},"OptimalAuctionDesignRequest":{"properties":{"share_outcome":{"type":"boolean","title":"Share Outcome","description":"Opt-in: contribute this (anonymized) call to the prior corpus. Default False. Requires account-level consent set at /v1/keys issuance.","default":false},"vertical":{"anyOf":[{"type":"string","enum":["ad_inventory","saas_procurement","cloud_compute","freight_logistics","media_licensing","m_and_a_buyside","m_and_a_sellside","real_estate","energy_trading","professional_services","marketplace_b2b","other"]},{"type":"null"}],"title":"Vertical","description":"Self-declared vertical (allowlisted enum). Required when share_outcome=True. Use 'other' if none fit."},"bidder_priors":{"items":{"$ref":"#/components/schemas/PriorParams"},"type":"array","maxItems":50,"minItems":1,"title":"Bidder Priors"},"seller_valuation":{"type":"number","minimum":0.0,"title":"Seller Valuation"},"objective":{"type":"string","enum":["revenue","welfare"],"title":"Objective","default":"revenue"},"n_simulations":{"type":"integer","maximum":50000.0,"minimum":500.0,"title":"N Simulations","default":5000},"seed":{"type":"integer","title":"Seed","default":42}},"type":"object","required":["bidder_priors","seller_valuation"],"title":"OptimalAuctionDesignRequest"},"OptimalAuctionDesignResponse":{"properties":{"mechanism":{"type":"string","title":"Mechanism"},"reserve_prices":{"additionalProperties":true,"type":"object","title":"Reserve Prices"},"expected_revenue":{"type":"number","title":"Expected Revenue"},"expected_welfare":{"type":"number","title":"Expected Welfare"},"ironing_required":{"type":"boolean","title":"Ironing Required"},"rationale":{"type":"string","title":"Rationale"}},"type":"object","required":["mechanism","reserve_prices","expected_revenue","expected_welfare","ironing_required","rationale"],"title":"OptimalAuctionDesignResponse"},"OptimalBidRequest":{"properties":{"share_outcome":{"type":"boolean","title":"Share Outcome","description":"Opt-in: contribute this (anonymized) call to the prior corpus. Default False. Requires account-level consent set at /v1/keys issuance.","default":false},"vertical":{"anyOf":[{"type":"string","enum":["ad_inventory","saas_procurement","cloud_compute","freight_logistics","media_licensing","m_and_a_buyside","m_and_a_sellside","real_estate","energy_trading","professional_services","marketplace_b2b","other"]},{"type":"null"}],"title":"Vertical","description":"Self-declared vertical (allowlisted enum). Required when share_outcome=True. Use 'other' if none fit."},"auction_format":{"type":"string","title":"Auction Format","description":"first_price | second_price_vickrey | english_ascending"},"my_valuation":{"type":"number","exclusiveMinimum":0.0,"title":"My Valuation"},"n_competing_bidders":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"N Competing Bidders"},"competitor_value_prior":{"$ref":"#/components/schemas/PriorParams"},"reserve_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reserve Price"},"risk_aversion":{"type":"number","maximum":1.0,"minimum":0.1,"title":"Risk Aversion","default":1.0}},"type":"object","required":["auction_format","my_valuation","n_competing_bidders","competitor_value_prior"],"title":"OptimalBidRequest"},"OptimalBidResponse":{"properties":{"optimal_bid":{"type":"number","title":"Optimal Bid"},"expected_surplus":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Expected Surplus"},"win_probability":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Win Probability"},"dominant_strategy":{"type":"boolean","title":"Dominant Strategy"},"rationale":{"type":"string","title":"Rationale"}},"type":"object","required":["optimal_bid","expected_surplus","win_probability","dominant_strategy","rationale"],"title":"OptimalBidResponse"},"OptimalReserveRequest":{"properties":{"bidder_value_prior":{"$ref":"#/components/schemas/PriorParams"},"n_bidders":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"N Bidders"},"seller_valuation":{"type":"number","minimum":0.0,"title":"Seller Valuation"}},"type":"object","required":["bidder_value_prior","n_bidders","seller_valuation"],"title":"OptimalReserveRequest"},"OptimalReserveResponse":{"properties":{"reserve_price":{"type":"number","title":"Reserve Price"},"expected_revenue":{"type":"number","title":"Expected Revenue"},"expected_revenue_no_reserve":{"type":"number","title":"Expected Revenue No Reserve"},"expected_efficiency_loss":{"type":"number","title":"Expected Efficiency Loss"},"rationale":{"type":"string","title":"Rationale"}},"type":"object","required":["reserve_price","expected_revenue","expected_revenue_no_reserve","expected_efficiency_loss","rationale"],"title":"OptimalReserveResponse"},"PostedPriceRequest":{"properties":{"share_outcome":{"type":"boolean","title":"Share Outcome","description":"Opt-in: contribute this (anonymized) call to the prior corpus. Default False. Requires account-level consent set at /v1/keys issuance.","default":false},"vertical":{"anyOf":[{"type":"string","enum":["ad_inventory","saas_procurement","cloud_compute","freight_logistics","media_licensing","m_and_a_buyside","m_and_a_sellside","real_estate","energy_trading","professional_services","marketplace_b2b","other"]},{"type":"null"}],"title":"Vertical","description":"Self-declared vertical (allowlisted enum). Required when share_outcome=True. Use 'other' if none fit."},"buyer_arrival_prior":{"$ref":"#/components/schemas/PriorParams"},"arrival_rate_per_second":{"type":"number","maximum":100.0,"exclusiveMinimum":0.0,"title":"Arrival Rate Per Second"},"inventory":{"type":"integer","maximum":10000.0,"minimum":1.0,"title":"Inventory"},"horizon_seconds":{"type":"number","maximum":604800.0,"exclusiveMinimum":0.0,"title":"Horizon Seconds"},"n_simulations":{"type":"integer","maximum":20000.0,"minimum":100.0,"title":"N Simulations","default":2000},"seed":{"type":"integer","title":"Seed","default":42}},"type":"object","required":["buyer_arrival_prior","arrival_rate_per_second","inventory","horizon_seconds"],"title":"PostedPriceRequest"},"PostedPriceResponse":{"properties":{"static_price":{"type":"number","title":"Static Price"},"static_expected_revenue":{"type":"number","title":"Static Expected Revenue"},"static_simulated_revenue":{"type":"number","title":"Static Simulated Revenue"},"dynamic_schedule":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Dynamic Schedule"},"dynamic_value_estimate":{"type":"number","title":"Dynamic Value Estimate"},"sellthrough_rate":{"type":"number","title":"Sellthrough Rate"},"rationale":{"type":"string","title":"Rationale"}},"type":"object","required":["static_price","static_expected_revenue","static_simulated_revenue","dynamic_schedule","dynamic_value_estimate","sellthrough_rate","rationale"],"title":"PostedPriceResponse"},"PriorParams":{"properties":{"family":{"type":"string","title":"Family","description":"lognorm | uniform"},"params":{"additionalProperties":true,"type":"object","title":"Params"}},"type":"object","required":["family","params"],"title":"PriorParams"},"Proposer":{"properties":{"id":{"type":"string","maxLength":128,"minLength":1,"title":"Id"},"preferences":{"items":{"type":"string"},"type":"array","maxItems":1024,"title":"Preferences","description":"Receiver ids ranked most-preferred first"}},"type":"object","required":["id"],"title":"Proposer"},"Receiver":{"properties":{"id":{"type":"string","maxLength":128,"minLength":1,"title":"Id"},"preferences":{"items":{"type":"string"},"type":"array","maxItems":1024,"title":"Preferences","description":"Proposer ids ranked most-preferred first"},"capacity":{"type":"integer","maximum":1024.0,"minimum":1.0,"title":"Capacity","default":1}},"type":"object","required":["id"],"title":"Receiver"},"ReportOutcomeRequest":{"properties":{"recommendation_id":{"type":"string","maxLength":128,"minLength":1,"title":"Recommendation Id","description":"The X-GT-Recommendation-Id returned when share_outcome=True"},"deal_closed":{"type":"boolean","title":"Deal Closed","description":"True if a deal was reached"},"my_utility":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"My Utility","description":"Realized utility-to-self in [0, 1] (quantized at write)"},"opponent_utility":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Opponent Utility","description":"Realized utility-to-opponent if known, in [0, 1]"}},"type":"object","required":["recommendation_id","deal_closed"],"title":"ReportOutcomeRequest"},"ReportOutcomeResponse":{"properties":{"accepted":{"type":"boolean","title":"Accepted","description":"False if the recommendation_id doesn't exist, doesn't belong to this key, is in a different ISO week (too late), or has already been reported. Idempotent re-report = no-op."}},"type":"object","required":["accepted"],"title":"ReportOutcomeResponse"},"RevealFirstStrikeRequest":{"properties":{"commitment_id":{"type":"string","title":"Commitment Id"},"reservation":{"type":"number","title":"Reservation"},"nonce":{"type":"string","minLength":1,"title":"Nonce"},"salt":{"type":"string","minLength":1,"title":"Salt"}},"type":"object","required":["commitment_id","reservation","nonce","salt"],"title":"RevealFirstStrikeRequest"},"RevealFirstStrikeResponse":{"properties":{"verified":{"type":"boolean","title":"Verified"},"binding_offer":{"type":"number","title":"Binding Offer"},"buyer_id":{"type":"string","title":"Buyer Id"},"seller_id":{"type":"string","title":"Seller Id"},"revealed_at_unix":{"type":"integer","title":"Revealed At Unix"},"reused":{"type":"boolean","title":"Reused"}},"type":"object","required":["verified","binding_offer","buyer_id","seller_id","revealed_at_unix","reused"],"title":"RevealFirstStrikeResponse"},"SellNextOfferRequest":{"properties":{"share_outcome":{"type":"boolean","title":"Share Outcome","description":"Opt-in: contribute this (anonymized) call to the prior corpus. Default False. Requires account-level consent set at /v1/keys issuance.","default":false},"vertical":{"anyOf":[{"type":"string","enum":["ad_inventory","saas_procurement","cloud_compute","freight_logistics","media_licensing","m_and_a_buyside","m_and_a_sellside","real_estate","energy_trading","professional_services","marketplace_b2b","other"]},{"type":"null"}],"title":"Vertical","description":"Self-declared vertical (allowlisted enum). Required when share_outcome=True. Use 'other' if none fit."},"my_reservation":{"type":"number","maximum":1.0,"minimum":0.0,"title":"My Reservation","description":"Our walk-away utility, normalized to [0, 1]"},"opponent_offer_history":{"items":{"type":"number"},"type":"array","maxItems":128,"title":"Opponent Offer History","description":"Opponent's offers evaluated in our utility space, in [0, 1]"},"my_offer_history":{"items":{"type":"number"},"type":"array","maxItems":128,"title":"My Offer History"},"deadline_rounds":{"type":"integer","maximum":64.0,"minimum":1.0,"title":"Deadline Rounds","description":"Total rounds before the negotiation times out"},"pareto_knob":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Pareto Knob","description":"0=max deal rate, 1=max H2H margin (empirical Pareto frontier)","default":0.5},"buyer_wtp_prior":{"anyOf":[{"$ref":"#/components/schemas/WTPPrior"},{"type":"null"}]}},"type":"object","required":["my_reservation","deadline_rounds"],"title":"SellNextOfferRequest"},"SellNextOfferResponse":{"properties":{"recommended_offer":{"type":"number","title":"Recommended Offer"},"acceptance_probability":{"type":"number","title":"Acceptance Probability"},"expected_payoff":{"type":"number","title":"Expected Payoff"},"rationale":{"type":"string","title":"Rationale"},"posterior":{"additionalProperties":true,"type":"object","title":"Posterior"},"rubinstein_share":{"type":"number","title":"Rubinstein Share"},"schelling_floor":{"type":"number","title":"Schelling Floor"}},"type":"object","required":["recommended_offer","acceptance_probability","expected_payoff","rationale","posterior","rubinstein_share","schelling_floor"],"title":"SellNextOfferResponse"},"SimulateRequest":{"properties":{"auction_format":{"type":"string","title":"Auction Format"},"bidder_priors":{"items":{"$ref":"#/components/schemas/PriorParams"},"type":"array","title":"Bidder Priors"},"reserve_price":{"type":"number","minimum":0.0,"title":"Reserve Price"},"n_simulations":{"type":"integer","maximum":100000.0,"minimum":100.0,"title":"N Simulations","default":10000},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Seed"}},"type":"object","required":["auction_format","bidder_priors","reserve_price"],"title":"SimulateRequest"},"SimulateResponse":{"properties":{"mean_revenue":{"type":"number","title":"Mean Revenue"},"ci_95":{"items":{"type":"number"},"type":"array","title":"Ci 95"},"efficiency":{"type":"number","title":"Efficiency"},"winner_index_distribution":{"items":{"type":"number"},"type":"array","title":"Winner Index Distribution"},"n_simulations":{"type":"integer","title":"N Simulations"}},"type":"object","required":["mean_revenue","ci_95","efficiency","winner_index_distribution","n_simulations"],"title":"SimulateResponse"},"TelemetryDeleteResponse":{"properties":{"rows_deleted":{"type":"integer","title":"Rows Deleted"}},"type":"object","required":["rows_deleted"],"title":"TelemetryDeleteResponse"},"TelemetryExportResponse":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/TelemetryRecordOut"},"type":"array","title":"Rows"}},"type":"object","required":["rows"],"title":"TelemetryExportResponse"},"TelemetryRecordOut":{"properties":{"recommendation_id":{"type":"string","title":"Recommendation Id"},"vertical":{"type":"string","title":"Vertical"},"endpoint":{"type":"string","title":"Endpoint"},"request_features":{"additionalProperties":true,"type":"object","title":"Request Features"},"recommendation":{"additionalProperties":true,"type":"object","title":"Recommendation"},"created_at_hour":{"type":"integer","title":"Created At Hour"},"outcome":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Outcome"}},"type":"object","required":["recommendation_id","vertical","endpoint","request_features","recommendation","created_at_hour","outcome"],"title":"TelemetryRecordOut"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WTPPrior":{"properties":{"mu":{"type":"number","title":"Mu","description":"Lognormal μ of buyer WTP"},"sigma":{"type":"number","title":"Sigma","description":"Lognormal σ of buyer WTP"}},"type":"object","required":["mu","sigma"],"title":"WTPPrior"}}},"tags":[{"name":"negotiation","description":"Tier 1: multi-round bargaining"},{"name":"auctions","description":"Tier 2: single-unit auctions"},{"name":"mechanism","description":"Tier 3: marketplace operator primitives"},{"name":"discovery","description":"Catalog + agent onboarding"},{"name":"telemetry","description":"Opt-in data sharing + GDPR (export/delete)"}]}