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

# Get user funding rate history

> Retrieve funding rate payment history for a specific user.
Shows funding payments including the direction, amount, and associated fees.
Supports filtering by market, side, and timestamp range. Supports sorting and pagination. Page size is capped at 200.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/funding_rate_history
openapi: 3.1.0
info:
  title: Decibel Trading API
  description: >-
    RESTful API for Decibel. Provides read-only endpoints for market data,
    trading operations, positions, and analytics.
  contact:
    name: Decibel Team
    url: https://decibel.trade/
  license:
    name: ''
  version: 1.0.0
servers:
  - url: https://api.mainnet.aptoslabs.com/decibel
    description: Mainnet
  - url: https://api.testnet.aptoslabs.com/decibel
    description: Testnet
security:
  - bearerAuth: []
tags:
  - name: Market Data
    description: Market information and real-time data endpoints
  - name: User
    description: User information and account management
  - name: Trades
    description: Trading operations and history
  - name: Positions
    description: User position management
  - name: Orders
    description: Order management and history
  - name: TWAP
    description: Time-weighted average price orders
  - name: Bulk Orders
    description: Bulk order management
  - name: Vaults
    description: Vault operations and management
  - name: Analytics
    description: Analytics and performance metrics
  - name: Predeposit Rewards
    description: Season 0 predeposit USDC rewards
  - name: Referrals
    description: Referral code management and tracking
paths:
  /api/v1/funding_rate_history:
    get:
      tags:
        - Account
      summary: Get user funding rate history
      description: >-
        Retrieve funding rate payment history for a specific user.

        Shows funding payments including the direction, amount, and associated
        fees.

        Supports filtering by market, side, and timestamp range. Supports
        sorting and pagination. Page size is capped at 200.
      operationId: handle_funding_rate_history
      parameters:
        - name: account
          in: query
          description: User account address
          required: true
          schema:
            type: string
          example: 0x123...
        - name: market
          in: query
          description: Filter by market address
          required: false
          schema:
            type: string
        - name: side
          in: query
          description: >-
            Filter by side: "buy" (OpenLong/CloseShort) or "sell"
            (CloseLong/OpenShort)
          required: false
          schema:
            $ref: 103a553b-2c52-4c5a-aba3-3ed022aa3126
        - name: pagination
          in: query
          description: Pagination parameters (limit and offset)
          required: true
          schema:
            type: object
            properties:
              limit:
                type: integer
                format: int32
                maximum: 1000
                minimum: 0
              offset:
                type: integer
                format: int32
                maximum: 10000
                minimum: 0
        - name: filter
          in: query
          description: Timestamp range filter
          required: true
          schema:
            $ref: 24e93dfc-f72d-4b88-9b3a-91162ef46f02
        - name: sorting
          in: query
          description: Sorting parameters
          required: true
          schema:
            $ref: 250c3ae3-9c34-48a6-b4be-a45159c4bc4d
      responses:
        '200':
          description: Funding rate history retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedResponse_FundingRateHistory'
        '500':
          description: Database error
components:
  schemas:
    PaginatedResponse_FundingRateHistory:
      type: object
      required:
        - items
        - total_count
      properties:
        items:
          type: array
          items:
            type: object
            required:
              - market
              - action
              - size
              - realized_funding_amount
              - is_rebate
              - fee_amount
              - transaction_unix_ms
            properties:
              action:
                type: string
                example: Close Long
              fee_amount:
                type: number
                format: double
              is_rebate:
                type: boolean
              market:
                type: string
                example: 0xmarket123...
              realized_funding_amount:
                type: number
                format: double
                description: >-
                  Realized funding amount in USDC

                  - Negative value: trader PAID funding (e.g., long position
                  with positive funding rate)

                  - Positive value: trader RECEIVED funding (e.g., short
                  position with positive funding rate)

                  - Zero: no funding accrued
                example: -15.5
              size:
                type: number
                format: double
                example: 1
              transaction_unix_ms:
                type: integer
                format: int64
                example: 1735758000000
          description: The items in the current page
        total_count:
          type: integer
          format: int32
          description: The total number of items across all pages
          minimum: 0
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Bearer token from Geomi. See
        [Authentication](/api-reference/rest/authentication) for setup
        instructions.

````