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

# Ticker updates

> Best bid/ask, spread, mid, and spot price updates for an instrument.



## AsyncAPI

````yaml _generated/asyncapi.yaml tickersChannel
id: tickersChannel
title: Ticker updates
description: Best bid/ask, spread, mid, and spot price updates for an instrument.
servers:
  - id: production
    protocol: wss
    host: joyride.exchange
    bindings: []
    variables: []
address: tickers.{instrument_id}
parameters:
  - id: instrument_id
    jsonSchema:
      type: string
      description: Instrument identifier.
      examples:
        - SOL_USDC-28FEB26-150-C
    description: Instrument identifier.
    type: string
    required: true
    deprecated: false
bindings: []
operations:
  - &ref_0
    id: receiveTickerUpdate
    title: Receive ticker update
    description: >-
      Receive ticker updates (best bid/ask, spread, mid, spot) for a subscribed
      instrument.
    type: receive
    messages:
      - &ref_1
        id: TickerUpdate
        contentType: application/json
        payload:
          - name: Instrument ticker
            description: >
              Best bid/ask, spread, mid price, spot price, and per-unit greeks
              for a

              single instrument. Fires on BBO change and on spot updates
              (debounced

              per instrument), so subscribers stay current as spot drifts
              between

              order book changes.
            type: object
            properties:
              - name: instrument_id
                type: string
                required: true
              - name: best_bid
                type: integer
                description: Best bid price (USDC micros)
                required: false
              - name: best_ask
                type: integer
                description: Best ask price (USDC micros)
                required: false
              - name: spread
                type: integer
                description: Spread (USDC micros)
                required: false
              - name: mid_price
                type: integer
                description: Mid price (USDC micros, two-sided only)
                required: false
              - name: spot_price
                type: number
                description: Underlying spot price (dollars)
                required: false
              - name: greeks
                type: object
                description: >
                  Per-unit greeks recomputed from the current spot and mid.
                  `pop`

                  is `null` when the book is empty (no honest mid → no honest

                  probability).
                required: false
                properties:
                  - name: delta
                    type: number
                    required: true
                  - name: gamma
                    type: number
                    required: true
                  - name: theta
                    type: number
                    required: true
                  - name: vega
                    type: number
                    required: true
                  - name: rho
                    type: number
                    required: true
                  - name: iv
                    type: number
                    description: Implied volatility (annualized, decimal — 0.80 = 80%)
                    required: true
                  - name: lambda
                    type: number
                    description: >-
                      Leverage proxy (spot / mark, or |delta| · spot / mark when
                      LEVERAGE_MODE=lambda)
                    required: true
                  - name: pop
                    type: number
                    description: >-
                      Probability of profit (long side, 0.0–1.0). Null when the
                      book is empty.
                    required: true
        headers: []
        jsonPayloadSchema:
          type: object
          properties:
            instrument_id:
              type: string
              x-parser-schema-id: <anonymous-schema-196>
            best_bid:
              type: integer
              nullable: true
              description: Best bid price (USDC micros)
              x-parser-schema-id: <anonymous-schema-197>
            best_ask:
              type: integer
              nullable: true
              description: Best ask price (USDC micros)
              x-parser-schema-id: <anonymous-schema-198>
            spread:
              type: integer
              nullable: true
              description: Spread (USDC micros)
              x-parser-schema-id: <anonymous-schema-199>
            mid_price:
              type: integer
              nullable: true
              description: Mid price (USDC micros, two-sided only)
              x-parser-schema-id: <anonymous-schema-200>
            spot_price:
              type: number
              nullable: true
              description: Underlying spot price (dollars)
              x-parser-schema-id: <anonymous-schema-201>
            greeks:
              type: object
              description: |
                Per-unit greeks recomputed from the current spot and mid. `pop`
                is `null` when the book is empty (no honest mid → no honest
                probability).
              properties:
                delta:
                  type: number
                  x-parser-schema-id: <anonymous-schema-203>
                gamma:
                  type: number
                  x-parser-schema-id: <anonymous-schema-204>
                theta:
                  type: number
                  x-parser-schema-id: <anonymous-schema-205>
                vega:
                  type: number
                  x-parser-schema-id: <anonymous-schema-206>
                rho:
                  type: number
                  x-parser-schema-id: <anonymous-schema-207>
                iv:
                  type: number
                  description: Implied volatility (annualized, decimal — 0.80 = 80%)
                  x-parser-schema-id: <anonymous-schema-208>
                lambda:
                  type: number
                  description: >-
                    Leverage proxy (spot / mark, or |delta| · spot / mark when
                    LEVERAGE_MODE=lambda)
                  x-parser-schema-id: <anonymous-schema-209>
                pop:
                  type: number
                  nullable: true
                  description: >-
                    Probability of profit (long side, 0.0–1.0). Null when the
                    book is empty.
                  x-parser-schema-id: <anonymous-schema-210>
              required:
                - delta
                - gamma
                - theta
                - vega
                - rho
                - iv
                - lambda
                - pop
              x-parser-schema-id: <anonymous-schema-202>
          required:
            - instrument_id
          x-parser-schema-id: <anonymous-schema-195>
        title: Instrument ticker
        description: |
          Best bid/ask, spread, mid price, spot price, and per-unit greeks for a
          single instrument. Fires on BBO change and on spot updates (debounced
          per instrument), so subscribers stay current as spot drifts between
          order book changes.
        example: |-
          {
            "instrument_id": "<string>",
            "best_bid": 123,
            "best_ask": 123,
            "spread": 123,
            "mid_price": 123,
            "spot_price": 123,
            "greeks": {
              "delta": 123,
              "gamma": 123,
              "theta": 123,
              "vega": 123,
              "rho": 123,
              "iv": 123,
              "lambda": 123,
              "pop": 123
            }
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: TickerUpdate
    bindings: []
    extensions:
      - id: x-parser-unique-object-id
        value: tickersChannel
sendOperations:
  - *ref_0
receiveOperations: []
sendMessages:
  - *ref_1
receiveMessages: []
extensions:
  - id: x-parser-unique-object-id
    value: tickersChannel
securitySchemes: []

````