SNHP

SNHP Auctions API

Tier 2: single-unit auctions

GitHub OpenAPI

Operations 4

POST /v1/auction/bidder/optimal_bid Optimal bid for first-price/Vickrey/English auction #
POST /v1/auction/seller/optimal_reserve Myerson optimal reserve price #
POST /v1/auction/seller/format_recommendation Recommend an auction format given seller weights #
POST /v1/auction/simulate Monte Carlo auction simulation #

Documentation

📖
Documentation
https://snhp.dev/docs
📖
APIReference
https://snhp.dev/redoc
📖
GettingStarted
https://snhp.dev/llms.txt
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/snhp-dev/refs/heads/main/authentication/snhp-dev-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/snhp-dev/refs/heads/main/rate-limits/snhp-dev-rate-limits.yml
📖
Documentation
https://arena.snhp.dev/docs

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/snhp-dev/refs/heads/main/openapi/snhp-dev-auctions-api-openapi.yml

Other Resources

🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/snhp-dev/refs/heads/main/conventions/snhp-dev-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/snhp-dev/refs/heads/main/errors/snhp-dev-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/snhp-dev/refs/heads/main/data-model/snhp-dev-data-model.yml
🔗
Sandbox
https://raw.githubusercontent.com/api-evangelist/snhp-dev/refs/heads/main/sandbox/snhp-dev-sandbox.yml
🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/snhp-dev/refs/heads/main/llms/snhp-dev-arena-llms.txt

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/snhp-dev-auctions-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

snhp-dev-auctions-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Game Theory Layer for AI Agents Auctions API
  description: 'Start with ONE tool: POST /v1/negotiate/turn — plain-dollar price negotiation (your walk-away + the other side''s offers in dollars -> the counter to send, a ready-to-send message, accept/walk advice).'
  version: 0.1.0
tags:
- name: auctions
  description: 'Tier 2: single-unit auctions'
paths:
  /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'
components:
  schemas:
    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
    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
    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
    PriorParams:
      properties:
        family:
          type: string
          title: Family
          description: lognorm | uniform
        params:
          additionalProperties: true
          type: object
          title: Params
      type: object
      required:
      - family
      - params
      title: PriorParams
    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
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    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
    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
    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
    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