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

> Fetch detailed, tick-by-tick trade data for a chosen stock symbol over a specified time interval. Each entry records the trade price, size, executing exchange, trade conditions, and exact timestamp. This granular dataset underpins the construction of aggregated bars and comprehensive analyses by logging every eligible transaction used to calculate open, high, low, and close values. Leveraging these trades lets users deepen their insight into intraday price behavior, rigorously test and optimize algorithmic strategies, and maintain a fully auditable record of market activity.




## OpenAPI

````yaml get /v3/trades/{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/trades/{symbol}:
    get:
      tags:
        - Trades
      description: >
        Fetch detailed, tick-by-tick trade data for a chosen stock symbol over a
        specified time interval. Each entry records the trade price, size,
        executing exchange, trade conditions, and exact timestamp. This granular
        dataset underpins the construction of aggregated bars and comprehensive
        analyses by logging every eligible transaction used to calculate open,
        high, low, and close values. Leveraging these trades lets users deepen
        their insight into intraday price behavior, rigorously test and optimize
        algorithmic strategies, and maintain a fully auditable record of market
        activity.
      parameters:
        - name: symbol
          in: path
          description: Stock ticker symbol (e.g., AAPL).
          required: true
          schema:
            type: string
        - name: apikey
          in: query
          description: Your Finvera API key.
          required: true
          schema:
            type: string
        - name: order
          in: query
          description: Sort order (asc or desc on timestamp).
          schema:
            type: string
            enum:
              - asc
              - desc
            default: desc
        - name: limit
          in: query
          description: Max results to return (max 5000).
          schema:
            type: integer
            default: 10
            maximum: 5000
        - name: sort
          in: query
          description: Sort field (timestamp).
          schema:
            type: string
            default: timestamp
      responses:
        '200':
          description: Success response with trades
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TradesResponse'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    TradesResponse:
      type: object
      properties:
        next_url:
          type: string
          description: Cursor for next page.
        request_id:
          type: string
        results:
          type: array
          items:
            $ref: '#/components/schemas/Trade'
        status:
          type: string
          example: OK
    ErrorResponse:
      type: object
      properties:
        status:
          type: integer
          example: 400
        error:
          type: string
        details:
          oneOf:
            - type: string
            - type: object
            - type: array
              items:
                type: object
    Trade:
      type: object
      properties:
        conditions:
          type: array
          items:
            type: integer
        exchange:
          type: integer
        id:
          type: string
        price:
          type: number
        sequence_number:
          type: integer
        sip_timestamp:
          type: integer
        size:
          type: integer
        tape:
          type: integer

````