Activision Blizzard Auction House API

The Auction House API API from Activision Blizzard — 4 operation(s) for auction house api.

Operations 4

GET /data/wow/connected-realm/{connectedRealmId}/auctions Auctions #
GET /data/wow/auctions/commodities Commodities #
GET /data/wow/connected-realm/{connectedRealmId}/auctions/index Auction House Index #
GET /data/wow/connected-realm/{connectedRealmId}/auctions/{auctionHouseId} Auctions #

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/activision-blizzard:activision-blizzard-auction-house-api-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

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

OpenAPI Specification

activision-blizzard-auction-house-api-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Activision Blizzard Auction House API
  version: 1.0.0
  contact:
    name: Battle.net Community Developer Portal
    url: https://community.developer.battle.net/
  termsOfService: https://www.blizzard.com/en-us/legal/a2aefd3f-87e1-4a35-a38d-e0f7a8f42a00/blizzard-developer-api-terms-of-use
  x-derived: '2026-11-04'
  x-refined-note:
  - x-derived-from differs across the merged source definitions and was not carried
  x-generated-from: provider-reference-json
  description: 'Operations tagged Auction House API across 2 of this provider''s published API definitions: activision-blizzard-world-of-warcraft-api-openapi.yml, activision-blizzard-world-of-warcraft-classic-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://{region}.api.blizzard.com
  description: Global regions (documented host format {region}.api.blizzard.com)
  variables:
    region:
      enum:
      - us
      - eu
      - kr
      - tw
      default: us
- url: https://gateway.battlenet.com.cn
  description: China region host (documented in Regionality and APIs / game data host names)
security:
- oauth2: []
tags:
- name: Auction House API
paths:
  /data/wow/connected-realm/{connectedRealmId}/auctions:
    get:
      operationId: auctions
      summary: Auctions
      description: 'Returns all active auctions for a connected realm.


        See the Connected Realm API for information about retrieving a list of connected realm IDs.


        Auction house data updates at a set interval. The value was initially set at 1 hour; however, it might change over time without notice.


        Depending on the number of active auctions on the specified connected realm, the response from this endpoint may be rather large, sometimes exceeding 10 MB.'
      tags:
      - Auction House API
      x-source: https://community.developer.battle.net/documentation/world-of-warcraft/game-data-apis
      parameters:
      - name: connectedRealmId
        in: path
        required: true
        description: The ID of the connected realm.
        schema:
          type: integer
          default: 1146
      - name: namespace
        in: query
        required: true
        description: The namespace to use to locate this document.
        schema:
          type: string
          default: dynamic-us
      - name: locale
        in: query
        required: false
        description: The locale to reflect in localized data.
        schema:
          type: string
          default: en_US
      responses:
        '200':
          description: Successful response (response schema not published in the reference).
    servers:
    - url: https://{region}.api.blizzard.com
      description: Global regions (documented host format {region}.api.blizzard.com)
      variables:
        region:
          enum:
          - us
          - eu
          - kr
          - tw
          default: us
    - url: https://gateway.battlenet.com.cn
      description: China region host (documented in Regionality and APIs / game data host names)
  /data/wow/auctions/commodities:
    get:
      operationId: commodities
      summary: Commodities
      description: 'Returns all active auctions for commodity items for the entire game region.


        Auction house data updates at a set interval. The value was initially set at 1 hour; however, it might change over time without notice.


        Depending on the number of active auctions on the specified connected realm, the response from this endpoint may be rather large, sometimes exceeding 10 MB.'
      tags:
      - Auction House API
      x-source: https://community.developer.battle.net/documentation/world-of-warcraft/game-data-apis
      parameters:
      - name: namespace
        in: query
        required: true
        description: The namespace to use to locate this document.
        schema:
          type: string
          default: dynamic-us
      - name: locale
        in: query
        required: false
        description: The locale to reflect in localized data.
        schema:
          type: string
          default: en_US
      responses:
        '200':
          description: Successful response (response schema not published in the reference).
    servers:
    - url: https://{region}.api.blizzard.com
      description: Global regions (documented host format {region}.api.blizzard.com)
      variables:
        region:
          enum:
          - us
          - eu
          - kr
          - tw
          default: us
    - url: https://gateway.battlenet.com.cn
      description: China region host (documented in Regionality and APIs / game data host names)
  /data/wow/connected-realm/{connectedRealmId}/auctions/index:
    get:
      operationId: auctionHouseIndex
      summary: Auction House Index
      description: 'Returns an index of auction houses for a connected realm.


        See the Connected Realm API for information about retrieving a list of connected realm IDs.'
      tags:
      - Auction House API
      x-source: https://community.developer.battle.net/documentation/world-of-warcraft-classic/game-data-apis
      parameters:
      - name: connectedRealmId
        in: path
        required: true
        description: The ID of the connected realm.
        schema:
          type: integer
          default: 4372
      - name: namespace
        in: query
        required: true
        description: The namespace to use to locate this document.
        schema:
          type: string
          default: dynamic-classic-us
      - name: locale
        in: query
        required: false
        description: The locale to reflect in localized data.
        schema:
          type: string
          default: en_US
      responses:
        '200':
          description: Successful response (response schema not published in the reference).
    servers:
    - url: https://{region}.api.blizzard.com
      description: Global regions (documented host format {region}.api.blizzard.com)
      variables:
        region:
          enum:
          - us
          - eu
          - kr
          - tw
          default: us
    - url: https://gateway.battlenet.com.cn
      description: China region host (documented in Regionality and APIs / game data host names)
  /data/wow/connected-realm/{connectedRealmId}/auctions/{auctionHouseId}:
    get:
      operationId: getDataWowConnectedRealmByConnectedRealmIdAuctionsByAuctionHouseId
      summary: Auctions
      description: 'Returns all active auctions for a specific auction house on a connected realm.


        See the Connected Realm API for information about retrieving a list of connected realm IDs.


        Auction house data updates at a set interval. The value was initially set at 1 hour; however, it might change over time without notice.


        Depending on the number of active auctions on the specified connected realm, the response from this endpoint may be rather large, sometimes exceeding 10 MB.'
      tags:
      - Auction House API
      x-source: https://community.developer.battle.net/documentation/world-of-warcraft-classic/game-data-apis
      parameters:
      - name: connectedRealmId
        in: path
        required: true
        description: The ID of the connected realm.
        schema:
          type: integer
          default: 4372
      - name: auctionHouseId
        in: path
        required: true
        description: The ID of the auction house.
        schema:
          type: integer
          default: 2
      - name: namespace
        in: query
        required: true
        description: The namespace to use to locate this document.
        schema:
          type: string
          default: dynamic-classic-us
      - name: locale
        in: query
        required: false
        description: The locale to reflect in localized data.
        schema:
          type: string
          default: en_US
      responses:
        '200':
          description: Successful response (response schema not published in the reference).
      x-operation-id-source: normalized
      x-operation-id-original: auctions
    servers:
    - url: https://{region}.api.blizzard.com
      description: Global regions (documented host format {region}.api.blizzard.com)
      variables:
        region:
          enum:
          - us
          - eu
          - kr
          - tw
          default: us
    - url: https://gateway.battlenet.com.cn
      description: China region host (documented in Regionality and APIs / game data host names)
components:
  securitySchemes:
    oauth2:
      type: oauth2
      description: Documented at https://community.developer.battle.net/documentation/guides/using-oauth
      flows:
        clientCredentials:
          tokenUrl: https://oauth.battle.net/token
          scopes: {}
        authorizationCode:
          authorizationUrl: https://oauth.battle.net/authorize
          tokenUrl: https://oauth.battle.net/token
          scopes:
            openid: OpenID Connect
            wow.profile: World of Warcraft profile
            sc2.profile: StarCraft II profile
            d3.profile: Diablo III profile
x-refined-from:
- activision-blizzard-world-of-warcraft-api-openapi.yml
- activision-blizzard-world-of-warcraft-classic-api-openapi.yml