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

# Funding History

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

## Request

- Base URL: `https://whitebit.com`
- URL: `https://whitebit.com/api/v4/collateral-account/funding-history`
- Auth: API key in header `X-TXC-APIKEY` and API key in header `X-TXC-PAYLOAD` and API key in header `X-TXC-SIGNATURE`
- TypeScript: <https://skmtc.dev/whitebit/apis/whitebit-private-http-api-v4/docs/api/v4/collateral-account/funding-history/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/whitebit/apis/whitebit-private-http-api-v4.md) - [All operations](https://skmtc.dev/whitebit/apis/whitebit-private-http-api-v4/llms.txt) - [OpenAPI document](https://skmtc.dev/whitebit/apis/whitebit-private-http-api-v4/revisions/76c9def9942f?raw)