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

# Get order events

> ### Parameters

| Parameter | Required | Type | Description |
| --------- | -------- | ---- | ----------- |
| account | yes | string (hex) | Ethereum-style account address for the sub-account context. |
| pagination_data | yes | object | Pagination segment containing `pageNumber` and `pageSize` (serialized per gateway contract). |

### Response fields

| Parameter | Required | Type | Description |
| --------- | -------- | ---- | ----------- |
| `orderEvents` | no | array \| null | — |
| `orderEvents[].account` | yes | string (hex) | An Ethereum-style account address (20 bytes). |
| `orderEvents[].eventData` | yes | object \| object \| string \| object \| object | — |
| `orderEvents[].instrument` | yes | integer (int64) | An instrument identifier (8-byte hash). |
| `orderEvents[].orderId` | yes | integer (int64) | — |
| `pageNumber` | yes | integer | — |
| `pageSize` | yes | integer | — |

### Response example

A sample **`200`** JSON body is attached to this operation as an OpenAPI **example** (Mintlify shows it in the example panel, similar to other exchange API docs).



## OpenAPI

````yaml /specs/openapi.json get /order-events
openapi: 3.1.0
info:
  title: RocketFi REST API
  description: REST API for Rocket Chain / RocketFi integrations.
  license:
    name: ''
  version: 0.1.0
servers:
  - url: https://beta.rocketfi.io
    description: Beta
  - url: https://testnet.rocket-cluster-1.com
    description: Testnet
  - url: https://devnet.rocket-cluster-1.com
    description: Devnet
security: []
tags:
  - name: Service
    description: Health and availability.
  - name: Market data
    description: Instruments, candles, fees, leverage, and funding data.
  - name: Account
    description: Account nonce, fees, collateral, positions, and orders.
  - name: Trading
    description: Transactions and order activity.
  - name: Vault and bridge
    description: Vaults, history, and bridge events.
  - name: Faucet (testnet)
    description: Testnet faucet for development.
paths:
  /order-events:
    get:
      tags:
        - Trading
      summary: Get order events
      description: >-
        ### Parameters


        | Parameter | Required | Type | Description |

        | --------- | -------- | ---- | ----------- |

        | account | yes | string (hex) | Ethereum-style account address for the
        sub-account context. |

        | pagination_data | yes | object | Pagination segment containing
        `pageNumber` and `pageSize` (serialized per gateway contract). |


        ### Response fields


        | Parameter | Required | Type | Description |

        | --------- | -------- | ---- | ----------- |

        | `orderEvents` | no | array \| null | — |

        | `orderEvents[].account` | yes | string (hex) | An Ethereum-style
        account address (20 bytes). |

        | `orderEvents[].eventData` | yes | object \| object \| string \| object
        \| object | — |

        | `orderEvents[].instrument` | yes | integer (int64) | An instrument
        identifier (8-byte hash). |

        | `orderEvents[].orderId` | yes | integer (int64) | — |

        | `pageNumber` | yes | integer | — |

        | `pageSize` | yes | integer | — |


        ### Response example


        A sample **`200`** JSON body is attached to this operation as an OpenAPI
        **example** (Mintlify shows it in the example panel, similar to other
        exchange API docs).
      operationId: get_order_events
      parameters:
        - name: account
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/AccountAddress'
          description: Ethereum-style account address for the sub-account context.
        - name: pagination_data
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/PaginationData'
          description: >-
            Pagination segment containing `pageNumber` and `pageSize`
            (serialized per gateway contract).
      responses:
        '200':
          description: All trades for an account
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetOrderEventsResponse'
              example:
                orderEvents: []
                pageNumber: 0
                pageSize: 25
components:
  schemas:
    AccountAddress:
      type: string
      format: hex
      description: An Ethereum-style account address (20 bytes).
    PaginationData:
      type: object
      properties:
        pageNumber:
          $ref: '#/components/schemas/usize'
        pageSize:
          $ref: '#/components/schemas/usize'
    GetOrderEventsResponse:
      type: object
      required:
        - pageNumber
        - pageSize
      properties:
        orderEvents:
          type:
            - array
            - 'null'
          items:
            $ref: '#/components/schemas/OrderEventClientView'
        pageNumber:
          $ref: '#/components/schemas/usize'
        pageSize:
          $ref: '#/components/schemas/usize'
    usize:
      type: integer
      minimum: 0
    OrderEventClientView:
      type: object
      required:
        - orderId
        - account
        - instrument
        - eventData
      properties:
        account:
          $ref: '#/components/schemas/AccountAddress'
        eventData:
          $ref: '#/components/schemas/OrderEventDataClientView'
        instrument:
          $ref: '#/components/schemas/InstrumentId'
        orderId:
          $ref: '#/components/schemas/u64'
    OrderEventDataClientView:
      oneOf:
        - type: object
          required:
            - fill
          properties:
            fill:
              type: object
              required:
                - price
                - size
                - remaining_size
                - original_size
                - settlement_asset
                - timestamp
                - is_passive
                - is_filled
                - fee_rate
                - fee_amount
                - is_liquidation
                - is_adl
              properties:
                fee_amount:
                  type: string
                fee_rate:
                  type: string
                is_adl:
                  type: boolean
                is_filled:
                  type: boolean
                is_liquidation:
                  type: boolean
                is_passive:
                  type: boolean
                original_size:
                  type: string
                pnl:
                  type:
                    - string
                    - 'null'
                price:
                  type: string
                remaining_size:
                  type: string
                settlement_asset:
                  $ref: '#/components/schemas/usize'
                size:
                  type: string
                timestamp:
                  $ref: '#/components/schemas/u64'
        - type: object
          required:
            - placed
          properties:
            placed:
              type: object
              required:
                - price
                - size
                - remaining_size
                - original_size
                - settlement_asset
                - timestamp
                - is_passive
                - is_filled
              properties:
                is_filled:
                  type: boolean
                is_passive:
                  type: boolean
                original_size:
                  type: string
                price:
                  type: string
                remaining_size:
                  type: string
                settlement_asset:
                  $ref: '#/components/schemas/usize'
                size:
                  type: string
                timestamp:
                  $ref: '#/components/schemas/u64'
        - type: string
          enum:
            - canceled
        - type: object
          required:
            - modified
          properties:
            modified:
              type: object
              required:
                - price
                - size
                - timestamp
              properties:
                price:
                  type: string
                size:
                  type: string
                timestamp:
                  $ref: '#/components/schemas/u64'
        - type: object
          required:
            - rejected
          properties:
            rejected:
              type: object
              required:
                - reason
              properties:
                reason:
                  $ref: '#/components/schemas/RejectionReason'
    InstrumentId:
      type: integer
      format: int64
      description: An instrument identifier (8-byte hash).
      minimum: 0
    u64:
      type: integer
      format: int64
      minimum: 0
    RejectionReason:
      type: string
      enum:
        - marginViolated
        - notEnoughLiquidity
        - tooMuchSlippage
        - selfTradePrevention

````