> ## Documentation Index
> Fetch the complete documentation index at: https://docs.55-tech.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trading status

> Current engine state for your client.



## OpenAPI

````yaml /zh/mm-api/openapi.json get /api/v1/trading/status
openapi: 3.1.0
info:
  title: MM-V2 Trading API
  description: >

    ## MM API


    The MM engine places orders, hedges positions, and tracks P&L automatically.

    This API lets you monitor trading activity, control your engine, and
    configure

    which market types and tournaments to trade.


    ### Authentication

    All endpoints require the `X-API-Key` header with your client UUID.


    ### Rate limits

    - REST API: 2,000 requests/minute per client

    - WebSocket: 5 concurrent connections per API key
  version: 1.0.0
servers: []
security: []
tags:
  - name: Trading Controls
    description: Pause, resume, stop, and start your trading engine.
  - name: Orders & Bets
    description: Inspect and cancel exchange orders, view hedge bets placed on bookmakers.
  - name: Performance
    description: Hedged positions, P&L and turnover, exchange account balances.
  - name: Configuration
    description: Choose which market types and tournaments your engine trades.
paths:
  /api/v1/trading/status:
    get:
      tags:
        - Trading Controls
      summary: Trading status
      description: Current engine state for your client.
      operationId: get_trading_status_api_v1_trading_status_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TradingStatusResponse'
        '401':
          description: Invalid or missing API key
        '404':
          description: Resource not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    TradingStatusResponse:
      properties:
        client:
          type: string
          title: Client
          description: Client identifier
        clientName:
          type: string
          title: Clientname
          description: Client display name
        oddsFormat:
          type: string
          enum:
            - american
            - decimal
            - hong_kong
            - fractional
          title: Oddsformat
          description: Preferred odds display format for the client UI
        status:
          type: string
          title: Status
          description: >-
            Overall trading status: live, manual_paused, manual_stopped,
            soft_paused, system_stopped, or emergency
        tradingActive:
          type: boolean
          title: Tradingactive
          description: >-
            True only when this client is not manually paused/stopped and the
            system is not globally blocked
        manualPaused:
          type: boolean
          title: Manualpaused
          description: Whether this client is manually paused
        manualPausedAt:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Manualpausedat
          description: When manual pause was activated
        manualPauseReason:
          anyOf:
            - type: string
            - type: 'null'
          title: Manualpausereason
          description: Reason recorded for the manual pause
        manualStopped:
          type: boolean
          title: Manualstopped
          description: Whether this client is manually stopped
        manualStoppedAt:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Manualstoppedat
          description: When manual stop was activated
        manualStopReason:
          anyOf:
            - type: string
            - type: 'null'
          title: Manualstopreason
          description: Reason recorded for the manual stop
        systemTradingBlocked:
          type: boolean
          title: Systemtradingblocked
          description: Whether global emergency or soft pause is blocking all clients
        emergencyActive:
          type: boolean
          title: Emergencyactive
          description: Whether full emergency mode is active
        systemStopped:
          type: boolean
          title: Systemstopped
          description: Whether a manual system-wide stop is active
        softPaused:
          type: boolean
          title: Softpaused
          description: Whether global soft pause is active
        systemReason:
          anyOf:
            - type: string
            - type: 'null'
          title: Systemreason
          description: Global emergency/pause reason, if any
        systemDurationSeconds:
          type: number
          title: Systemdurationseconds
          description: How long the global emergency/pause has been active
      type: object
      required:
        - client
        - clientName
        - oddsFormat
        - status
        - tradingActive
        - manualPaused
        - manualPausedAt
        - manualPauseReason
        - manualStopped
        - manualStoppedAt
        - manualStopReason
        - systemTradingBlocked
        - emergencyActive
        - systemStopped
        - softPaused
        - systemReason
        - systemDurationSeconds
      title: TradingStatusResponse
      description: Client trading status including manual pause and global safety state.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Client API key (UUID format). Get your key from the admin dashboard.

````