Deutsche Börse

A7 Analytics Platform - Auction Simulation API

Simulate Xetra auctions against historical order book data on the A7 Analytics Platform.

GitHub OpenAPI

Operations 4

GET /auction/{exchange}/{date}/{marketSegmentID}/{securityID}/ retrieves list of auction types #
GET /auction/{exchange}/{date}/{symbol}/ retrieves list of auction types #
GET /auction/{exchange}/{date}/{marketSegmentID}/{securityID}/{auctionType} retrieves auction's historical data and optionally simulated outcome of an… #
GET /auction/{exchange}/{date}/{symbol}/{auctionType} retrieves auction's historical data and optionally simulated outcome of an… #

Documentation

📖
Documentation
https://github.com/Deutsche-Boerse/a7

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/deutsche-boerse/refs/heads/main/openapi/deutsche-boerse-auctions-api-openapi.yml
⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/deutsche-boerse/refs/heads/main/openapi/deutsche-boerse-exchanges-symbols-securities-api-openapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/deutsche-boerse/refs/heads/main/overlays/deutsche-boerse-auctions-api-overlay.yaml
🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/deutsche-boerse/refs/heads/main/overlays/deutsche-boerse-exchanges-symbols-securities-api-overlay.yaml

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/a7-auction-simulation-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

deutsche-boerse-auctions-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: A7 Analytics Platform - Auction simulation Auctions API
  description: A7 Analytics Platform for the main T7 trading venues of Deutsche Börse Group.
  contact:
    name: Deutsche Börse Data & Analytics
    url: https://www.mds.deutsche-boerse.com
    email: analytics@deutsche-boerse.com
  version: 1.0.0
servers:
- url: /api/v1/simulation
  description: A7 production environment
security:
- bearerAuth: []
tags:
- name: Auctions
paths:
  /auction/{exchange}/{date}/{marketSegmentID}/{securityID}/:
    get:
      tags:
      - Auctions
      summary: retrieves list of auction types
      description: The request delivers all available auction types for the selected security that is identified by market, trading day, market segment ID and security ID.
      operationId: getAuctions
      parameters:
      - $ref: '#/components/parameters/exchange'
      - $ref: '#/components/parameters/date'
      - $ref: '#/components/parameters/marketSegmentID'
      - $ref: '#/components/parameters/securityID'
      responses:
        200:
          description: successful operation
          content:
            application/json:
              schema:
                description: array of auction types
                type: array
                items:
                  $ref: '#/components/schemas/auctionType'
                example:
                - opening
                - intraday
                - closing
            application/gzip:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/auctionType'
                format: binary
                example:
                - opening
                - intraday
                - closing
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        403:
          $ref: '#/components/responses/403'
        404:
          $ref: '#/components/responses/404'
  /auction/{exchange}/{date}/{symbol}/:
    get:
      tags:
      - Auctions
      summary: retrieves list of auction types
      description: The request delivers all available auction types for the selected security that is identified by market, trading day and trading symbol.
      operationId: getAuctionsBySymbol
      parameters:
      - $ref: '#/components/parameters/exchange'
      - $ref: '#/components/parameters/date'
      - $ref: '#/components/parameters/symbol'
      responses:
        200:
          description: successful operation
          content:
            application/json:
              schema:
                description: array of auction types
                type: array
                items:
                  $ref: '#/components/schemas/auctionType'
                example:
                - opening
                - intraday
                - closing
            application/gzip:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/auctionType'
                format: binary
                example:
                - opening
                - intraday
                - closing
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        403:
          $ref: '#/components/responses/403'
        404:
          $ref: '#/components/responses/404'
  /auction/{exchange}/{date}/{marketSegmentID}/{securityID}/{auctionType}:
    get:
      tags:
      - Auctions
      summary: retrieves auction's historical data and optionally simulated outcome of an…
      description: The request delivers historical data for the selected auction that is identified by market, trading day, market segment ID and security ID, and optionally a simulated outcome of an auction, if complete information of an additional order (side {side}, limit price {px}, quantity {qty}) and optionally order priority {prio} and is provided.
      operationId: getAuction
      parameters:
      - $ref: '#/components/parameters/exchange'
      - $ref: '#/components/parameters/date'
      - $ref: '#/components/parameters/marketSegmentID'
      - $ref: '#/components/parameters/securityID'
      - $ref: '#/components/parameters/auctionType'
      - $ref: '#/components/parameters/side'
      - $ref: '#/components/parameters/px'
      - $ref: '#/components/parameters/prio'
      - $ref: '#/components/parameters/qty'
      responses:
        200:
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/auction'
            application/gzip:
              schema:
                $ref: '#/components/schemas/auction'
                format: binary
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        403:
          $ref: '#/components/responses/403'
        404:
          $ref: '#/components/responses/404'
  /auction/{exchange}/{date}/{symbol}/{auctionType}:
    get:
      tags:
      - Auctions
      summary: retrieves auction's historical data and optionally simulated outcome of an…
      description: The request delivers historical data for the selected auction that is identified by market, trading day and trading symbol, and optionally a simulated outcome of an auction, if complete information of an additional order (side {side}, limit price {px}, quantity {qty}) and optionally order priority {prio} and is provided.
      operationId: getAuctionBySymbol
      parameters:
      - $ref: '#/components/parameters/exchange'
      - $ref: '#/components/parameters/date'
      - $ref: '#/components/parameters/symbol'
      - $ref: '#/components/parameters/auctionType'
      - $ref: '#/components/parameters/side'
      - $ref: '#/components/parameters/px'
      - $ref: '#/components/parameters/prio'
      - $ref: '#/components/parameters/qty'
      responses:
        200:
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/auction'
            application/gzip:
              schema:
                $ref: '#/components/schemas/auction'
                format: binary
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        403:
          $ref: '#/components/responses/403'
        404:
          $ref: '#/components/responses/404'
components:
  responses:
    '404':
      description: not found
    '403':
      description: access denied
      content:
        text/plain:
          schema:
            type: string
          example: specific error message
    '400':
      description: bad request
      content:
        text/plain:
          schema:
            type: string
          example: specific error message
    '401':
      description: authorization failed
      content:
        text/plain:
          schema:
            type: string
          example: specific error message
  schemas:
    side:
      description: side of an order
      type: string
      enum:
      - bid
      - ask
      example: bid
    auction:
      description: auction's historical data and optionally simulated outcome of an auction
      type: object
      properties:
        Exchange:
          $ref: '#/components/schemas/exchange'
        Date:
          $ref: '#/components/schemas/date'
        MarketSegmentID:
          $ref: '#/components/schemas/marketSegmentID'
        SecurityID:
          $ref: '#/components/schemas/securityID'
        AuctionType:
          $ref: '#/components/schemas/auctionType'
        AuctionStartTimestamp:
          $ref: '#/components/schemas/timestamp'
        AuctionEndTimestamp:
          $ref: '#/components/schemas/timestamp'
        AuctionReferencePrice:
          $ref: '#/components/schemas/px'
        UncrossingPrice:
          oneOf:
          - $ref: '#/components/schemas/px'
          - $ref: '#/components/schemas/null_string'
        MatchedVolume:
          $ref: '#/components/schemas/qty'
        SimulatedUncrossingPrice:
          $ref: '#/components/schemas/px'
        SimulatedMatchedVolume:
          $ref: '#/components/schemas/qty'
        SimulatedOrders:
          description: simulated orders
          type: array
          items:
            type: object
            properties:
              Side:
                $ref: '#/components/schemas/side'
              Px:
                oneOf:
                - $ref: '#/components/schemas/px'
                - $ref: '#/components/schemas/null_string'
              Prio:
                $ref: '#/components/schemas/timestamp'
              Qty:
                $ref: '#/components/schemas/qty'
              TradedQty:
                $ref: '#/components/schemas/qty'
            required:
            - Side
            - Px
            - Prio
            - Qty
            - TradedQty
      required:
      - Exchange
      - Date
      - MarketSegmentID
      - SecurityID
      - AuctionType
      - AuctionStartTimestamp
      - AuctionEndTimestamp
      - AuctionReferencePrice
      - UncrossingPrice
      - MatchedVolume
    marketSegmentID:
      description: market segment ID
      type: integer
      format: int32
      example: 52885
    auctionType:
      description: auction type
      type: string
      enum:
      - opening
      - intraday
      - closing
      example: opening
    exchange:
      description: exchange mic
      type: string
      minLength: 4
      maxLength: 4
      example: XETR
    securityID:
      description: security ID
      type: integer
      format: int64
      minimum: -9223372036854775808
      maximum: 9223372036854775807
      example: 2504978
    timestamp:
      description: timestamp as number of nanoseconds since Unix epoch
      type: integer
      format: int64
      minimum: 0
      maximum: 18446744073709551615
      default: 0
      example: 1652962104095620563
    px:
      description: limit price of an order
      type: number
      format: double
      example: 178.25
    null_string:
      description: a null string that corresponds to a market order
      type: string
      enum:
      - 'null'
      example: 'null'
    qty:
      description: quantity of an order
      type: integer
      format: int64
      minimum: -9223372036854775808
      maximum: 9223372036854775807
      example: 125
    date:
      description: date representation
      type: integer
      format: int32
      example: 20230111
    symbol:
      description: trading symbol
      type: string
      example: DB1
  parameters:
    exchange:
      name: exchange
      in: path
      description: exhange identifier code
      required: true
      schema:
        $ref: '#/components/schemas/exchange'
    securityID:
      name: securityID
      in: path
      description: unique security identifier
      required: true
      schema:
        $ref: '#/components/schemas/securityID'
    prio:
      name: prio
      in: query
      description: order priority (default 0)
      required: false
      schema:
        type: array
        items:
          $ref: '#/components/schemas/timestamp'
      style: form
      explode: true
    date:
      name: date
      in: path
      required: true
      description: trading day in the format YYYYMMDD
      schema:
        $ref: '#/components/schemas/date'
    symbol:
      name: symbol
      in: path
      description: unique trading symbol identifier
      required: true
      schema:
        $ref: '#/components/schemas/symbol'
    side:
      name: side
      in: query
      description: side of an order
      required: false
      schema:
        type: array
        items:
          $ref: '#/components/schemas/side'
      style: form
      explode: true
    qty:
      name: qty
      in: query
      description: quantity of an order
      required: false
      schema:
        type: array
        items:
          $ref: '#/components/schemas/qty'
      style: form
      explode: true
    marketSegmentID:
      name: marketSegmentID
      in: path
      description: unique market segment identifier
      required: true
      schema:
        $ref: '#/components/schemas/marketSegmentID'
    auctionType:
      name: auctionType
      in: path
      description: auction type
      required: true
      schema:
        $ref: '#/components/schemas/auctionType'
    px:
      name: px
      in: query
      description: limit price of an order, a null value corresponds to a market order
      required: false
      schema:
        type: array
        items:
          oneOf:
          - $ref: '#/components/schemas/px'
          - $ref: '#/components/schemas/null_string'
      style: form
      explode: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT