---
title: "Funding History"
method: POST
path: "/api/v4/collateral-account/funding-history"
tags: ["Collateral Trading"]
---

# Funding History

`POST /api/v4/collateral-account/funding-history`

The endpoint returns the funding rate payment history for [collateral](/glossary#balance-collateral) positions. Each record includes the funding rate, settlement price, position amount, and the resulting funding payment. Use the optional `market` parameter to filter results to a single trading pair. The response supports pagination via `limit` and `offset` parameters. Results are ordered by funding time (`fundingTime`), newest first.

<Warning>
Rate limit: 12000 requests/10 sec.
</Warning>

<Note>
This endpoint supports pagination. Use `limit` (default: 100) and `offset` (default: 0) to page through results. The response does not include a `total` field — detect the last page when `records.length < limit`. An empty `records` array means you have paged past the end; receiving exactly `limit` records does not guarantee that another page exists.
</Note>

<Accordion title="Error Codes">
  - `30` - default validation error code (invalid pagination — `limit` outside 1–100 or negative `offset`)
  - `31` - market validation failed (the `market` filter is unknown or not available for collateral trading)
</Accordion>

## Request body

- object
  - `market` string — Filter by specific market. For example: BTC_PERP If not specified, returns funding history for all markets.
  - `limit` integer — Number of records to return
  - `offset` integer — Number of records to skip
  - `request` string — Request signature
  - `nonce` integer — Unique request identifier

## Response `200`

Successful response - returns paginated funding history

- object
  - `records` object[] — Array of funding history entries
    - `market` string — Market name
    - `fundingTime` string — Funding time in Unix timestamp format
    - `fundingRate` string — Funding rate applied
    - `fundingAmount` string — Funding amount paid or received
    - `positionAmount` string — Position amount at funding time
    - `settlementPrice` string — Settlement price used for funding calculation
    - `rateCalculatedTime` string — Time when the funding rate was calculated in Unix timestamp format
  - `limit` integer — Number of records per page
  - `offset` integer — Number of records skipped

## Other responses

- `422` — Inner validation failed
- `503` — Service temporarily unavailable

---

[API](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4.md) · [All operations](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whitebit/whitebit-private-http-api-v4/revisions/76c9def9942f/schema)