> ## 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 Rates

> 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/funding-rates
openapi: 3.1.0
info:
  title: derivatives-api
  version: '2'
servers:
  - url: https://api.amberdata.com/markets/derivatives
security:
  - sec0: []
paths:
  /analytics/futures-perpetuals/funding-rates:
    get:
      summary: Funding Rates
      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-rates
      parameters:
        - name: underlying
          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: 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
            default: '2025-01-01'
        - 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: '2025-02-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
            default: hr
      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:
                            exchange:
                              type: string
                              example: binance
                              description: >-
                                The exchange where the funding rate is
                                calculated
                            fundingRateIntervalHours:
                              type: integer
                              example: 8
                              description: The funding rate interval in hours
                            fundingRateNormalized8h:
                              type: number
                              example: 0.00004817
                              description: The normalized funding rate for 8-hour intervals
                            instrument:
                              type: string
                              example: BTCUSDC
                              description: The perpetual contract instrument name
                            marginType:
                              type: string
                              example: linear
                              description: The type of margin used (linear or inverse)
                            quoteAsset:
                              type: string
                              example: USDC
                              description: The quote asset for the perpetual contract
                            realizedFunding:
                              type: number
                              example: 0.00004817
                              description: The realized funding payment for the period
                            realizedFundingCumulated:
                              type: number
                              example: 0.00004817
                              description: >-
                                The cumulative total of realized funding
                                payments
                            symbol:
                              type: string
                              example: binance_BTCUSDC
                              description: The exchange and instrument symbol
                            timestamp:
                              type: string
                              example: 2024-02-01 00:00:00 000
                              description: The timestamp for the funding rate data
                            underlying:
                              type: string
                              example: BTC
                              description: The underlying asset for the perpetual contract
              examples:
                Result:
                  value:
                    status: 200
                    title: OK
                    description: Successful request
                    payload:
                      data:
                        - exchange: binance
                          fundingRateIntervalHours: 8
                          fundingRateNormalized8h: 0.00004817
                          instrument: BTCUSDC
                          marginType: linear
                          quoteAsset: USDC
                          realizedFunding: 0.00004817
                          realizedFundingCumulated: 0.00004817
                          symbol: binance_BTCUSDC
                          timestamp: 2024-02-01 00:00:00 000
                          underlying: BTC
                        - exchange: binance
                          fundingRateIntervalHours: 8
                          fundingRateNormalized8h: 0.0001
                          instrument: BTCUSDT
                          marginType: linear
                          quoteAsset: USDT
                          realizedFunding: 0.0001
                          realizedFundingCumulated: 0.0001
                          symbol: binance_BTCUSDT
                          timestamp: 2024-02-01 00:00:00 000
                          underlying: BTC
                        - exchange: binance
                          fundingRateIntervalHours: 8
                          fundingRateNormalized8h: 0.0001
                          instrument: BTCUSD_PERP
                          marginType: inverse
                          quoteAsset: USD
                          realizedFunding: 0.0001
                          realizedFundingCumulated: 0.0001
                          symbol: binance_BTCUSD_PERP
                          timestamp: 2024-02-01 00:00:00 000
                          underlying: BTC
                        - exchange: bybit
                          fundingRateIntervalHours: 8
                          fundingRateNormalized8h: 0.0001
                          instrument: BTCPERP
                          marginType: linear
                          quoteAsset: USDC
                          realizedFunding: 0.0001
                          realizedFundingCumulated: 0.0001
                          symbol: bybit_BTCPERP
                          timestamp: 2024-02-01 00:00:00 000
                          underlying: BTC
                        - exchange: bybit
                          fundingRateIntervalHours: 8
                          fundingRateNormalized8h: 0.0001
                          instrument: BTCUSD
                          marginType: inverse
                          quoteAsset: USD
                          realizedFunding: 0.0001
                          realizedFundingCumulated: 0.0001
                          symbol: bybit_BTCUSD
                          timestamp: 2024-02-01 00:00:00 000
                          underlying: BTC
        '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

````