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

# Funding Realized/Accumulated

> This endpoint returns funding realized/accumulated data, which refers to the payments made between traders holding long and short positions in perpetual futures contracts. Accumulated funding is the total series of payments made between selected dates.



## OpenAPI

````yaml get /analytics/futures-perpetuals/realized-funding-rates-cumulated
openapi: 3.1.0
info:
  title: derivatives-api
  version: '2'
servers:
  - url: https://api.amberdata.com/markets/derivatives
security:
  - sec0: []
paths:
  /analytics/futures-perpetuals/realized-funding-rates-cumulated:
    get:
      summary: Funding Realized/Accumulated
      description: >-
        This endpoint returns funding realized/accumulated data, which refers to
        the payments made between traders holding long and short positions in
        perpetual futures contracts. Accumulated funding is the total series of
        payments made between selected dates.
      operationId: derivatives-futures-perpetuals-funding-realized-accumulated
      parameters:
        - name: asset
          in: query
          description: >-
            **[Required]** The underlying currency for which there are futures
            contracts/instruments. 

            **[Examples]** ` BTC | ETH `
          required: true
          schema:
            type: string
            default: BTC
        - name: marginType
          in: query
          description: >-
            **[Required]** This is the type of margin for the perpetuals.
            Perpetuals are either settled in stable coins or underlying currency
            coins.. 

            **[Examples]** `  coins | stables `
          required: true
          schema:
            type: string
            default: coins
        - name: startDate
          in: query
          description: >-
            **[Required]** Payload only includes data after this date
            (inclusive). 

            **[Formats]** `seconds | milliseconds | iso8601`

            **[Examples]** `1578531600 | 1578531600000 | 2020-09-01T01:00:00`
          required: true
          schema:
            type: string
            format: date-time
            default: '2024-05-21'
        - name: endDate
          in: query
          description: >-
            **[Required]** Payload only includes data before this date
            (exclusive). 

            **[Formats]** `seconds | milliseconds | iso8601`

            **[Examples]** `1578531600 | 1578531600000 | 2020-09-01T01:00:00`
          required: true
          schema:
            type: string
            default: '2024-06-01'
        - name: timeFormat
          in: query
          description: >-
            **[Optional]** Time format of the timestamps in the return payload.

            **[Defaults]** `milliseconds | ms* | iso | iso8601 | hr |
            human_readable`
          schema:
            type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 200
                  title:
                    type: string
                    example: OK
                  description:
                    type: string
                    example: Successful request
                  payload:
                    type: object
                    properties:
                      data:
                        type: array
                        items:
                          type: object
                          properties:
                            symbol:
                              type: string
                              example: binance BTCUSD_PERP
                              description: The exchange and perpetual contract symbol
                            timestamp:
                              type: string
                              example: 1704067200000
                              description: The timestamp for the funding data point
                            realizedFunding:
                              type: number
                              example: 0.037711
                              description: The realized funding payment for the period
                            accumulatedRealizedFunding:
                              type: number
                              example: 0.037711
                              description: >-
                                The cumulative total of realized funding
                                payments
              examples:
                Result:
                  value:
                    status: 200
                    title: OK
                    description: Successful request
                    payload:
                      data:
                        - symbol: binance BTCUSD_PERP
                          timestamp: 1704067200000
                          realizedFunding: 0.037711
                          accumulatedRealizedFunding: 0.037711
                        - symbol: binance BTCUSD_PERP
                          timestamp: 1704096000000
                          realizedFunding: 0.020162
                          accumulatedRealizedFunding: 0.057873
                        - symbol: binance BTCUSD_PERP
                          timestamp: 1704124800000
                          realizedFunding: 0.028009999999999997
                          accumulatedRealizedFunding: 0.085883
                        - symbol: binance BTCUSD_PERP
                          timestamp: 1704153600000
                          realizedFunding: 0.059009000000000006
                          accumulatedRealizedFunding: 0.14489200000000002
                        - symbol: binance BTCUSD_PERP
                          timestamp: 1704182400000
                          realizedFunding: 0.036388000000000004
                          accumulatedRealizedFunding: 0.18128000000000002
                        - symbol: binance BTCUSD_PERP
                          timestamp: 1704211200000
                          realizedFunding: 0.033397
                          accumulatedRealizedFunding: 0.21467700000000003
                        - symbol: binance BTCUSD_PERP
                          timestamp: 1704240000000
                          realizedFunding: 0.01
                          accumulatedRealizedFunding: 0.22467700000000004
                        - symbol: binance BTCUSD_PERP
                          timestamp: 1704268800000
                          realizedFunding: 0.013201000000000001
                          accumulatedRealizedFunding: 0.23787800000000003
                        - symbol: binance BTCUSD_PERP
                          timestamp: 1704297600000
                          realizedFunding: 0.01
                          accumulatedRealizedFunding: 0.24787800000000004
                        - symbol: binance BTCUSD_PERP
                          timestamp: 1704326400000
                          realizedFunding: 0.01
                          accumulatedRealizedFunding: 0.25787800000000005
                        - symbol: binance BTCUSD_PERP
                          timestamp: 1704355200000
                          realizedFunding: 0.01
                          accumulatedRealizedFunding: 0.26787800000000006
                        - symbol: binance BTCUSD_PERP
                          timestamp: 1704384000000
                          realizedFunding: 0.01
                          accumulatedRealizedFunding: 0.27787800000000007
                        - symbol: binance BTCUSD_PERP
                          timestamp: 1704412800000
                          realizedFunding: -0.008453
                          accumulatedRealizedFunding: 0.2694250000000001
                        - symbol: binance BTCUSD_PERP
                          timestamp: 1704441600000
                          realizedFunding: 0.01
                          accumulatedRealizedFunding: 0.2794250000000001
                        - symbol: binance BTCUSD_PERP
                          timestamp: 1704470400000
                          realizedFunding: 0.01
                          accumulatedRealizedFunding: 0.2894250000000001
                        - symbol: binance BTCUSD_PERP
                          timestamp: 1704499200000
                          realizedFunding: -0.009720000000000001
                          accumulatedRealizedFunding: 0.2797050000000001
                        - symbol: binance BTCUSD_PERP
                          timestamp: 1704528000000
                          realizedFunding: 0.001185
                          accumulatedRealizedFunding: 0.2808900000000001
                        - symbol: binance BTCUSD_PERP
                          timestamp: 1704556800000
                          realizedFunding: 0.0012850000000000001
                          accumulatedRealizedFunding: 0.28217500000000006
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: {}
              schema:
                type: object
                properties: {}
      deprecated: false
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````