> ## 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 position funding events

> Paginated position funding payment events for an account.

### Parameters

| Parameter | Required | Type | Description |
| --------- | -------- | ---- | ----------- |
| account | yes | string (hex) | Account address (hex-encoded, `0x...`). |
| pageNumber | yes | integer | Zero-based page number. Accepts either a number or a numeric string. |
| pageSize | yes | integer | Page size (number of items per page). Accepts either a number or a numeric string. |

### Response fields

| Parameter | Required | Type | Description |
| --------- | -------- | ---- | ----------- |
| `events` | no | object[] | — |
| `pageNumber` | yes | integer | — |
| `pageSize` | yes | integer | — |

### Response example

A sample **`200`** response body is attached to this operation as an OpenAPI **example** — see the **Example** panel on this page.



## OpenAPI

````yaml /specs/indexer-openapi.json get /position-funding-events
openapi: 3.1.0
info:
  title: Rocket Indexer API Documentation
  description: >-
    Welcome to the RocketChain Indexer API documentation!


    The indexer REST API serves historical and aggregated market data from
    ClickHouse. Endpoints cover candles, trades, order history, portfolio
    curves, funding events, bridge events, vault events, current/historical
    instruments, and live instrument details.
  license:
    name: MIT
    url: https://github.com/rocketfoundation/rocket-sdk-rust/blob/main/LICENSE
  version: '1.0'
  x-logo:
    altText: ROCKET
    backgroundColor: '#00000000'
    url: https://www.rocketfoundation.io/assets/rocket-logo.svg
servers:
  - url: https://beta.rocket-cluster-1.com/indexer
    description: Beta
  - url: https://testnet.rocket-cluster-1.com/indexer
    description: Testnet
  - url: https://devnet.rocket-cluster-1.com/indexer
    description: Devnet
security: []
tags:
  - name: Indexer REST-API
    description: >-
      Read-only REST endpoints backed by the RocketChain indexer. All routes are
      served over HTTP GET.
paths:
  /position-funding-events:
    get:
      tags:
        - Indexer REST-API
      summary: Get position funding events
      description: >-
        Paginated position funding payment events for an account.


        ### Parameters


        | Parameter | Required | Type | Description |

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

        | account | yes | string (hex) | Account address (hex-encoded, `0x...`).
        |

        | pageNumber | yes | integer | Zero-based page number. Accepts either a
        number or a numeric string. |

        | pageSize | yes | integer | Page size (number of items per page).
        Accepts either a number or a numeric string. |


        ### Response fields


        | Parameter | Required | Type | Description |

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

        | `events` | no | object[] | — |

        | `pageNumber` | yes | integer | — |

        | `pageSize` | yes | integer | — |


        ### Response example


        A sample **`200`** response body is attached to this operation as an
        OpenAPI **example** — see the **Example** panel on this page.
      operationId: getPositionFundingEvents
      parameters:
        - name: account
          in: path
          description: Account address (hex-encoded, `0x...`).
          required: true
          schema:
            type: string
            format: hex
          example: '0xf19e16fe3cf25c630f55f66d6c6cbf64f84fc86b'
        - name: pageNumber
          in: path
          description: |-
            Zero-based page number.
            Accepts either a number or a numeric string.
          required: true
          schema:
            oneOf:
              - $ref: '#/components/schemas/usize'
            default: 0
          example: 0
        - name: pageSize
          in: path
          description: |-
            Page size (number of items per page).
            Accepts either a number or a numeric string.
          required: true
          schema:
            oneOf:
              - $ref: '#/components/schemas/usize'
            default: 2000
          example: 100
      responses:
        '200':
          description: Position funding events
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPositionFundingEventsResponse'
              example:
                events:
                  - account: '0x6BC2179a284CB2A2857C379391E0158524de7cA0'
                    fundingRate: '0.000066'
                    instrumentId: '0xec37e578de46724d'
                    instrumentMarkPrice: '175.40'
                    pnl: '0'
                    positionQuantity: '-0.37'
                    round: 29119089
                    timestamp: 1774368000000
                pageNumber: 0
                pageSize: 100
        '500':
          description: Internal server error
          content:
            text/plain:
              schema:
                type: string
components:
  schemas:
    usize:
      type: integer
      minimum: 0
    GetPositionFundingEventsResponse:
      type: object
      required:
        - pageNumber
        - pageSize
      properties:
        events:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/PositionFundingEventsClientViewSet'
              description: Position funding events (may be `null` on error).
        pageNumber:
          $ref: '#/components/schemas/usize'
          description: Zero-based page number.
        pageSize:
          $ref: '#/components/schemas/usize'
          description: Page size (max items per page).
      examples:
        - events:
            - account: '0x6BC2179a284CB2A2857C379391E0158524de7cA0'
              fundingRate: '0.000066'
              instrumentId: '0xec37e578de46724d'
              instrumentMarkPrice: '175.40'
              pnl: '0'
              positionQuantity: '-0.37'
              round: 29119089
              timestamp: 1774368000000
          pageNumber: 0
          pageSize: 100
    PositionFundingEventsClientViewSet:
      type: array
      items:
        $ref: '#/components/schemas/PositionFundingEventView'
    PositionFundingEventView:
      type: object
      required:
        - fundingRate
        - timestamp
        - round
        - instrumentId
        - pnl
        - account
        - positionQuantity
        - instrumentMarkPrice
      properties:
        account:
          $ref: '#/components/schemas/AccountAddress'
        fundingRate:
          type: string
        instrumentId:
          $ref: '#/components/schemas/InstrumentId'
        instrumentMarkPrice:
          type: string
        pnl:
          type: string
        positionQuantity:
          type: string
        round:
          type: integer
          format: int64
          minimum: 0
        timestamp:
          $ref: '#/components/schemas/u64'
    AccountAddress:
      type: string
      format: hex
      description: An Ethereum-style account address (20 bytes).
      example: '0xf19e16fe3cf25c630f55f66d6c6cbf64f84fc86b'
    InstrumentId:
      type: string
      format: decimal
      description: An instrument identifier (8-byte hash).
      example: '42'
    u64:
      type: integer
      format: int64
      minimum: 0

````