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

# Get Quotes

> Fetch National Best Bid and Offer (NBBO) quotes for a given stock symbol across a specified time window. Each entry captures the top‐of‐book bid and ask prices, sizes, corresponding exchanges, and precise timestamps. This historical NBBO snapshot empowers users to track price dynamics, assess liquidity at the best bid and ask, and refine trading strategies or support research analyses.




## OpenAPI

````yaml get /v3/quotes/{symbol}
openapi: 3.0.3
info:
  title: Finvera Stock Market API
  description: >
    The Finvera Stock Market API provides comprehensive, real-time, and
    historical market data for equities. It offers three primary categories of
    information:


    - **Trades:** Access tick-level executed trade data including price, size,
    timestamp, trade conditions, and exchange information. This granular data
    enables detailed analysis of trading activity and volume at specific points
    in time.


    - **Quotes:** Retrieve National Best Bid and Offer (NBBO) data featuring bid
    and ask prices, sizes, exchanges, trade conditions, and precise timestamps.
    This data is essential for understanding market depth, liquidity, and price
    discovery dynamics.


    - **Aggregates (Bars):** Obtain historical summary bars (OHLCV - open, high,
    low, close, volume, and volume-weighted average price) aggregated over
    customizable time intervals (e.g., daily, weekly). These aggregates provide
    a consolidated view of market performance over a given period for trend
    analysis and backtesting.


    This API enables developers and analysts to build robust trading, analytics,
    and financial applications by delivering accurate, timely, and
    well-structured market data tailored for diverse use cases, including
    real-time monitoring and historical research.
  version: 1.0.0
  contact:
    name: API Support
    email: support@finvera.news
  license:
    name: Proprietary
    url: https://finvera.news/terms
servers:
  - url: https://api.finvera.news/stocks
    description: Production server
security: []
tags:
  - name: Trades
    description: Retrieve comprehensive, tick-level trade data for a specified stock
  - name: Quotes
    description: Retrieve NBBO quotes for a specified stock
  - name: Custom Bars (OHLC)
    description: Retrieve aggregated historical OHLC data for a specified stock
paths:
  /v3/quotes/{symbol}:
    get:
      tags:
        - Quotes
      description: >
        Fetch National Best Bid and Offer (NBBO) quotes for a given stock symbol
        across a specified time window. Each entry captures the top‐of‐book bid
        and ask prices, sizes, corresponding exchanges, and precise timestamps.
        This historical NBBO snapshot empowers users to track price dynamics,
        assess liquidity at the best bid and ask, and refine trading strategies
        or support research analyses.
      parameters:
        - name: symbol
          in: path
          required: true
          schema:
            type: string
        - name: apikey
          in: query
          required: true
          schema:
            type: string
        - name: order
          in: query
          schema:
            type: string
            enum:
              - asc
              - desc
            default: desc
        - name: limit
          in: query
          schema:
            type: integer
            default: 10
            maximum: 5000
        - name: sort
          in: query
          schema:
            type: string
            default: timestamp
      responses:
        '200':
          description: Success response with quotes
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuotesResponse'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    QuotesResponse:
      type: object
      properties:
        next_url:
          type: string
        request_id:
          type: string
        results:
          type: array
          items:
            $ref: '#/components/schemas/Quote'
        status:
          type: string
    ErrorResponse:
      type: object
      properties:
        status:
          type: integer
          example: 400
        error:
          type: string
        details:
          oneOf:
            - type: string
            - type: object
            - type: array
              items:
                type: object
    Quote:
      type: object
      properties:
        ask_exchange:
          type: integer
        ask_price:
          type: number
        ask_size:
          type: integer
        bid_exchange:
          type: integer
        bid_price:
          type: number
        bid_size:
          type: integer
        conditions:
          type: array
          items:
            type: integer
        sequence_number:
          type: integer
        sip_timestamp:
          type: integer
        tape:
          type: integer

````