> ## 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.

# Get the current implied volatility for an instrument

> Returns the latest validated BlockScholes mark IV for an open instrument. Quotes at least two minutes old are unavailable. This display-data window does not change the five-second trading risk gate.



## OpenAPI

````yaml /_generated/openapi.yaml get /v1/market/quotes/{symbol}
openapi: 3.1.0
info:
  title: Joyride Core HTTP API
  version: 0.1.0
  description: |
    HTTP endpoints served by joyride-core v8 components. Decimal money,
    price, and quantity fields are strings with up to 8 decimal places unless
    noted otherwise.
servers:
  - url: https://joyride.exchange/api
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Public
  - name: Query
  - name: Withdrawals
  - name: Market Data
    description: Publicly accessible market data. No authentication required.
  - name: Account
    description: Account-scoped history and provisioning. Requires a bearer JWT.
  - name: Referrals
    description: Referral-code validation and attribution surfaces.
  - name: AI Chat
    description: >
      AI-powered trading assistant. Uses SIWS (Sign In With Solana)
      authentication

      and JWT sessions. Returns responses as Server-Sent Events (SSE).
paths:
  /v1/market/quotes/{symbol}:
    get:
      tags:
        - Public
      summary: Get the current implied volatility for an instrument
      description: >-
        Returns the latest validated BlockScholes mark IV for an open
        instrument. Quotes at least two minutes old are unavailable. This
        display-data window does not change the five-second trading risk gate.
      operationId: getPublicInstrumentQuote
      parameters:
        - name: symbol
          in: path
          required: true
          schema:
            type: string
          example: BTC_USDC-2MAY26-77000-C
      responses:
        '200':
          description: Current instrument implied volatility
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicQuoteResponse'
        '404':
          description: Symbol is unknown or not open
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: IV has not arrived or is stale
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security: []
components:
  schemas:
    PublicQuoteResponse:
      type: object
      required:
        - symbol
        - mark_iv
        - as_of_ms
      properties:
        symbol:
          type: string
          example: BTC_USDC-2MAY26-77000-C
        mark_iv:
          allOf:
            - $ref: '#/components/schemas/DecimalString'
          description: Current mark implied volatility as a ratio, not a percentage.
          example: '0.81234567'
        as_of_ms:
          type: integer
          format: int64
          description: Gateway receive time in Unix milliseconds.
    ErrorResponse:
      type: object
      required:
        - ok
        - error
      properties:
        ok:
          const: false
        error:
          type: string
    DecimalString:
      type: string
      pattern: ^-?[0-9]+(\.[0-9]{1,8})?$
      examples:
        - '100.00000000'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        SIWS-issued JWT. Admin commands require the `admin` role, `admin:*`, or
        the exact `admin:<type>` scope; admin reads use their documented read
        scope.

````