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

# Get funding fee history

> get funding fee history

**Limit: 20 requests per 60 seconds per user**\
Get funding fee history

<ResponseExample>
  ```bash theme={null}
  {
      "success": true,
      "data": {
          "meta": {
              "total": 670,
              "recordsPerPage": 25,
              "currentPage": 1
          },
          "rows": [
              {
                  "id": 1286360,
                  "symbol": "PERP_BTC_USDT",
                  "fundingRate": -0.00001445,
                  "markPrice": "26930.60000000",
                  "fundingFee": "9.56021744",
                  "fundingIntervalHours": 8,
                  "paymentType": "Pay",
                  "status": "COMPLETED",
                  "createdTime": 1696060873259,
                  "updatedTime": 1696060873286
              },
              {
                  "id": 1286115,
                  "symbol": "PERP_BTC_USDT",
                  "fundingRate": 0.00006526,
                  "markPrice": "26911.00000000",
                  "fundingFee": "43.14503239",
                  "fundingIntervalHours": 8,
                  "paymentType": "Receive",
                  "status": "COMPLETED",
                  "createdTime": 1696032073609,
                  "updatedTime": 1696032073643
              },
              ...
          ]
      },
      "timestamp": 1721351502594
  }
  ```
</ResponseExample>


## OpenAPI

````yaml GET /v3/futures/fundingFee/history
openapi: 3.0.2
info:
  title: Swagger Petstore - OpenAPI 3.0
  description: >-
    This is a sample Pet Store Server based on the OpenAPI 3.0 specification. 
    You can find out more about

    Swagger at [http://swagger.io](http://swagger.io). In the third iteration of
    the pet store, we've switched to the design first approach!

    You can now help us improve the API whether it's by making changes to the
    definition itself or to the code.

    That way, with time, we can improve the API in general, and expose some of
    the new features in OAS3.


    Some useful links:

    - [The Pet Store
    repository](https://github.com/swagger-api/swagger-petstore)

    - [The source API definition for the Pet
    Store](https://github.com/swagger-api/swagger-petstore/blob/master/src/main/resources/openapi.yaml)
  termsOfService: http://swagger.io/terms/
  contact:
    name: API Team
    email: apiteam@swagger.io
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  version: 1.0.19
servers:
  - url: https://api.woox.io/
security: []
externalDocs:
  description: Find out more about Swagger
  url: http://swagger.io
paths:
  /v3/futures/fundingFee/history:
    get:
      description: get funding fee history
      parameters:
        - name: x-api-key
          in: header
          required: true
          schema:
            type: string
            example: abcdef123456
          description: ''
        - name: x-api-signature
          in: header
          required: true
          schema:
            type: string
            example: signaturestring
          description: ''
        - name: x-api-timestamp
          in: header
          required: true
          schema:
            type: string
            example: '1718943200000'
          description: ''
        - name: symbol
          in: query
          description: Symbol name
          required: true
          schema:
            type: string
        - name: startTime
          in: query
          description: Start timestamp in Unix timestamp format in milliseconds
          required: false
          schema:
            type: integer
        - name: endTime
          in: query
          description: End timestamp in Unix timestamp format in milliseconds
          required: false
          schema:
            type: integer
        - name: page
          in: query
          description: Page number
          required: false
          schema:
            type: integer
        - name: size
          in: query
          description: Data size per page, max 500
          required: false
          schema:
            type: integer
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetFundingFeeHistoryResponse'
      security: []
components:
  schemas:
    GetFundingFeeHistoryResponse:
      allOf:
        - $ref: '#/components/schemas/CommonResponse'
        - type: object
          properties:
            data:
              type: object
              properties:
                rows:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: integer
                        description: The unique identifier for the funding transaction.
                      symbol:
                        type: string
                        description: The trading pair symbol, e.g., PERP_BTC_USDT.
                      fundingRate:
                        type: number
                        format: float
                        description: The funding rate applied to the position.
                      markPrice:
                        type: string
                        description: The mark price of the position at the time of funding.
                      fundingFee:
                        type: string
                        description: The total funding fee for the position.
                      fundingIntervalHours:
                        type: integer
                        description: >-
                          The interval in hours at which funding is paid or
                          received.
                      paymentType:
                        type: string
                        description: The type of funding payment, e.g., 'Receive' or 'Pay'.
                      status:
                        type: string
                        description: >-
                          The status of the funding transaction, e.g.,
                          'COMPLETED'.
                        enum:
                          - COMPLETED
                          - FAILED
                      createdTime:
                        type: integer
                        format: int64
                        description: >-
                          The Unix timestamp when the funding transaction was
                          created.
                      updatedTime:
                        type: integer
                        format: int64
                        description: >-
                          The Unix timestamp when the funding transaction was
                          last updated.
                meta:
                  $ref: '#/components/schemas/Meta'
    CommonResponse:
      type: object
      properties:
        success:
          type: boolean
          description: 'true'
        timestamp:
          type: integer
          description: timestamp
    Meta:
      type: object
      properties:
        total:
          type: integer
          description: Total number of record
        recordsPerPage:
          type: integer
          description: Number of records per page
        currentPage:
          type: integer
          description: Current page number

````