> ## Documentation Index
> Fetch the complete documentation index at: https://whitebit-mintlify-fix-broken-links-1776039227.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Funding history

> Retrieve the public funding rate history for futures and collateral markets via the V4 API.

export const RelatedResources = ({children}) => {
  const ref = useRef(null);
  const [visible, setVisible] = useState(false);
  useEffect(() => {
    if (!ref.current) return;
    const el = ref.current;
    if (el.parentElement) {
      el.parentElement.appendChild(el);
    }
    setVisible(true);
  }, []);
  return <div ref={ref} className="related-resources" style={{
    marginTop: "2.5rem",
    paddingTop: "1.5rem",
    borderTop: "1px solid var(--border-color, #e5e7eb)",
    opacity: visible ? 1 : 0,
    transition: "opacity 0.15s ease-in"
  }}>
      <h2 style={{
    marginTop: 0
  }}>Related resources</h2>
      {children}
    </div>;
};

<RelatedResources>
  * [Available futures markets list](/api-reference/market-data/available-futures-markets-list) — futures market details including current predicted funding rate.
</RelatedResources>


## OpenAPI

````yaml /openapi/public/http-v4.yaml GET /api/v4/public/funding-history/{market}
openapi: 3.0.3
info:
  title: Public HTTP API V4
  description: >
    WhiteBIT Public HTTP API V4 for market data and trading information.

    Base URL: https://whitebit.com

    All endpoints return time in Unix-time format.

    All endpoints return either a JSON object or array.

    Use HTTP method GET for API calls.

    Send parameters as query string when an endpoint requires them.


    <Warning>

    Rate limit: 2000 requests/10 sec for most endpoints (specific limits noted
    per endpoint).

    </Warning>
  version: 4.0.0
servers:
  - url: https://whitebit.com
    description: WhiteBIT Global Server
  - url: https://whitebit.eu
    description: WhiteBIT EU Server
security: []
tags:
  - name: Public API V4
    description: Public endpoints for market data, trading information, and platform status
paths:
  /api/v4/public/funding-history/{market}:
    get:
      tags:
        - Public API V4
      summary: Funding History
      description: >
        The endpoint returns the funding rate history for a specified futures
        market. Use the response to analyze historical funding rate trends and
        settlement prices. Results are sorted by funding time in descending
        order and support offset-based pagination via `limit` and `offset`
        parameters.


        <Warning>

        Rate limit 2000 requests/10 sec.

        </Warning>


        <Note>

        This endpoint supports pagination. Use `limit` (default: 100, max: 1000)
        and `offset` (default: 0) to page through results.

        </Note>
      parameters:
        - name: market
          in: path
          required: true
          description: Market name (e.g., BTC_PERP)
          schema:
            type: string
            example: BTC_PERP
        - name: startDate
          in: query
          required: false
          description: Start timestamp in seconds
          schema:
            type: integer
            example: 1752480000
        - name: endDate
          in: query
          required: false
          description: End timestamp in seconds
          schema:
            type: integer
            example: 1752537600
        - name: limit
          in: query
          required: false
          description: 'Number of records to return. Default: 100, Maximum: 1000'
          schema:
            type: integer
            minimum: 1
            maximum: 1000
            default: 100
            example: 100
        - name: offset
          in: query
          required: false
          description: Number of records to skip
          schema:
            type: integer
            minimum: 0
            default: 0
            example: 0
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  required:
                    - fundingTime
                    - fundingRate
                    - market
                    - settlementPrice
                    - rateCalculatedTime
                  properties:
                    fundingTime:
                      type: string
                      description: >-
                        Unix timestamp in seconds when the funding settlement
                        executed.
                      example: '1752537600'
                    fundingRate:
                      type: string
                      description: >-
                        Funding rate applied at the settlement. A positive value
                        means long-position holders pay short-position holders;
                        a negative value means short-position holders pay
                        long-position holders. Expressed as a decimal ratio
                        (e.g., `"-0.0001229"`).
                      example: '-0.0001229'
                    market:
                      type: string
                      description: Futures market pair name (e.g., `BTC_PERP`).
                      example: BTC_PERP
                    settlementPrice:
                      type: string
                      description: >-
                        Mark price in the quote currency at the time of funding
                        settlement.
                      example: '119816.5'
                    rateCalculatedTime:
                      type: string
                      description: >-
                        Unix timestamp in seconds when the funding rate was
                        calculated. The rate is computed before the actual
                        settlement.
                      example: '1752508800'

````