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

# Market price

> Real-time price updates for a specific market (oracle, mark, mid prices)



## AsyncAPI

````yaml api-reference/asyncapi.json marketPrice
id: marketPrice
title: Market price
description: Real-time price updates for a specific market (oracle, mark, mid prices)
servers:
  - id: testnet
    protocol: wss
    host: api.testnet.aptoslabs.com/decibel/ws
    bindings: []
    variables: []
address: market_price:{marketAddr}
parameters:
  - id: marketAddr
    jsonSchema:
      type: string
      description: Market address (Aptos address format, e.g. 0x456...)
    description: Market address (Aptos address format, e.g. 0x456...)
    type: string
    required: true
    deprecated: false
bindings: []
operations:
  - &ref_0
    id: receivemarketPrice
    title: Receivemarket price
    description: >-
      Receive updates for real-time price updates for a specific market (oracle,
      mark, mid prices)
    type: receive
    messages:
      - &ref_1
        id: MarketPriceMessage
        payload:
          - name: MarketPriceMessage
            description: >-
              Real-time price updates for a specific market (oracle, mark, mid
              prices)
            type: object
            properties:
              - name: price
                type: object
                required: true
                properties:
                  - name: funding_rate_bps
                    type: integer
                    required: false
                  - name: is_funding_positive
                    type: boolean
                    required: false
                  - name: mark_px
                    type: number
                    required: false
                  - name: market
                    type: string
                    required: false
                  - name: mid_px
                    type: number
                    required: false
                  - name: open_interest
                    type: number
                    required: false
                  - name: oracle_px
                    type: number
                    required: false
                  - name: transaction_unix_ms
                    type: integer
                    required: false
              - name: topic
                type: string
                required: true
        headers: []
        jsonPayloadSchema:
          type: object
          required:
            - topic
            - price
          properties:
            price:
              type: object
              required:
                - market
                - oracle_px
                - mark_px
                - mid_px
                - funding_rate_bps
                - is_funding_positive
                - transaction_unix_ms
                - open_interest
              properties:
                funding_rate_bps:
                  type: integer
                  format: int64
                  minimum: 0
                  x-parser-schema-id: <anonymous-schema-120>
                is_funding_positive:
                  type: boolean
                  x-parser-schema-id: <anonymous-schema-121>
                mark_px:
                  type: number
                  format: double
                  x-parser-schema-id: <anonymous-schema-122>
                market:
                  type: string
                  example: 0xmarket123...
                  x-parser-schema-id: <anonymous-schema-123>
                mid_px:
                  type: number
                  format: double
                  x-parser-schema-id: <anonymous-schema-124>
                open_interest:
                  type: number
                  format: double
                  x-parser-schema-id: <anonymous-schema-125>
                oracle_px:
                  type: number
                  format: double
                  x-parser-schema-id: <anonymous-schema-126>
                transaction_unix_ms:
                  type: integer
                  format: int64
                  x-parser-schema-id: <anonymous-schema-127>
              x-parser-schema-id: PriceDto
            topic:
              type: string
              x-parser-schema-id: <anonymous-schema-139>
          x-parser-schema-id: MarketPriceResponse
        title: Market price message
        description: >-
          Real-time price updates for a specific market (oracle, mark, mid
          prices)
        example: |-
          {
            "topic": "market_price:0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
            "price": {
              "market": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
              "oracle_px": 50125.75,
              "mark_px": 50120.5,
              "mid_px": 50122.25,
              "funding_rate_bps": 5,
              "is_funding_positive": true,
              "transaction_unix_ms": 1699564800000,
              "open_interest": 125000.5
            }
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: MarketPriceMessage
          - id: x-parser-message-name
            value: MarketPriceMessage
    bindings: []
    extensions:
      - id: x-parser-unique-object-id
        value: marketPrice
sendOperations:
  - *ref_0
receiveOperations: []
sendMessages:
  - *ref_1
receiveMessages: []
extensions:
  - id: x-parser-unique-object-id
    value: marketPrice
securitySchemes: []

````