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

# Real Time Trades

> Enable users to interact with realtime trades



## AsyncAPI

````yaml asyncapi/realtime-trades-quotes.yaml trades
id: trades
title: Trades
description: Send subscription commands; receive status & market data
servers:
  - id: production
    protocol: wss
    host: api.finvera.news/stocks
    bindings: []
    variables: []
address: realtime
parameters: []
bindings: []
operations:
  - &ref_1
    id: trades.publish
    title: Trades.publish
    description: Send commands to the server
    type: receive
    messages:
      - &ref_3
        id: publish
        contentType: application/json
        payload:
          - name: publish
            description: Subscribe/unsubscribe to streams.
            type: object
            properties:
              - name: action
                type: string
                enumValues:
                  - subscribe
                  - unsubscribe
                required: true
              - name: params
                type: string
                description: e.g. "T.TSLA", "Q.*"
                required: true
        headers: []
        jsonPayloadSchema:
          type: object
          required:
            - action
            - params
          properties:
            action:
              type: string
              enum:
                - subscribe
                - unsubscribe
              x-parser-schema-id: <anonymous-schema-2>
            params:
              type: string
              description: e.g. "T.TSLA", "Q.*"
              x-parser-schema-id: <anonymous-schema-3>
          x-parser-schema-id: <anonymous-schema-1>
        title: Publish
        description: Subscribe/unsubscribe to streams.
        example: |-
          {
            "action": "<string>",
            "params": "<string>"
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: publish
          - id: x-parser-message-name
            value: SubscriptionRequest
    bindings: []
    extensions: &ref_0
      - id: x-parser-unique-object-id
        value: trades
  - &ref_2
    id: trades.subscribe
    title: Trades.subscribe
    description: Receive real-time trades data
    type: send
    messages:
      - &ref_4
        id: subscribe
        contentType: application/json
        payload:
          - name: subscribe
            description: Trade event.
            type: object
            properties:
              - name: ev
                type: string
                enumValues:
                  - T
                required: true
              - name: sym
                type: string
                required: true
              - name: x
                type: integer
                required: true
              - name: i
                type: string
                required: true
              - name: z
                type: integer
                required: true
              - name: p
                type: number
                required: true
              - name: s
                type: integer
                required: true
              - name: c
                type: array
                required: false
                properties:
                  - name: item
                    type: integer
                    required: false
              - name: t
                type: integer
                required: true
              - name: q
                type: integer
                required: true
              - name: trfi
                type: integer
                required: false
              - name: trft
                type: integer
                required: false
        headers: []
        jsonPayloadSchema:
          type: object
          required:
            - ev
            - sym
            - x
            - i
            - z
            - p
            - s
            - t
            - q
          properties:
            ev:
              type: string
              enum:
                - T
              x-parser-schema-id: <anonymous-schema-5>
            sym:
              type: string
              x-parser-schema-id: <anonymous-schema-6>
            x:
              type: integer
              x-parser-schema-id: <anonymous-schema-7>
            i:
              type: string
              x-parser-schema-id: <anonymous-schema-8>
            z:
              type: integer
              x-parser-schema-id: <anonymous-schema-9>
            p:
              type: number
              x-parser-schema-id: <anonymous-schema-10>
            s:
              type: integer
              x-parser-schema-id: <anonymous-schema-11>
            c:
              type: array
              items:
                type: integer
                x-parser-schema-id: <anonymous-schema-13>
              x-parser-schema-id: <anonymous-schema-12>
            t:
              type: integer
              x-parser-schema-id: <anonymous-schema-14>
            q:
              type: integer
              x-parser-schema-id: <anonymous-schema-15>
            trfi:
              type: integer
              x-parser-schema-id: <anonymous-schema-16>
            trft:
              type: integer
              x-parser-schema-id: <anonymous-schema-17>
          x-parser-schema-id: <anonymous-schema-4>
        title: Subscribe
        description: Trade event.
        example: |-
          {
            "ev": "<string>",
            "sym": "<string>",
            "x": 123,
            "i": "<string>",
            "z": 123,
            "p": 123,
            "s": 123,
            "c": {
              "item": 123
            },
            "t": 123,
            "q": 123,
            "trfi": 123,
            "trft": 123
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: subscribe
          - id: x-parser-message-name
            value: TradeMessage
    bindings: []
    extensions: *ref_0
sendOperations:
  - *ref_1
receiveOperations:
  - *ref_2
sendMessages:
  - *ref_3
receiveMessages:
  - *ref_4
extensions:
  - id: x-parser-unique-object-id
    value: trades
securitySchemes:
  - id: apiKey
    name: apikey
    type: httpApiKey
    description: Finvera API key.
    in: query
    extensions: []

````