---
title: "Get interest payments history"
method: POST
path: "/api/v4/main-account/smart/interest-payment-history"
tags: ["Crypto Lending - Fixed"]
---

# Get interest payments history

`POST /api/v4/main-account/smart/interest-payment-history`

## Request

- Base URL: `https://whitebit.com`
- URL: `https://whitebit.com/api/v4/main-account/smart/interest-payment-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/main-account/smart/interest-payment-history/post.ts> (a function with typed inputs; its response is checked against the schema)

The endpoint retrieves the history of interest payments.

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

<Note>
The API does not cache the response.
</Note>

## Request body

- object
  - `planId` string: [Invest plan](/glossary#crypto-lending) identifier
  - `ticker` string: [Invest plan](/glossary#crypto-lending) target currency's [ticker](/glossary#ticker)
  - `limit` integer: LIMIT is a special clause used to limit records a particular query can return.
  - `offset` integer: Use the OFFSET clause to return entries starting from a particular line.
  - `request` string, required: Request signature
  - `nonce` integer, required: Unique request identifier

## Response `200`

Successful response

- object
  - `offset` integer
  - `limit` integer
  - `records` InterestPayment[]
    - `planId` string: Invest plan identifier
    - `investmentId` string: Investment identifier
    - `amount` string: Interest amount
    - `ticker` string: Interest currency [ticker](/glossary#ticker)
    - `timestamp` integer: Transaction timestamp

## Other responses

- `400`: Request validation failed

---

[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)