API Docs

Appearance

Get Interest Earned​

GET
/v1/loans/credit-history

Returns the history of interest earned on loans for the current account. Each entry represents an interest payment credited from the hourly interest auction. Use the currencySymbol query parameter to filter results.

Authorizations​

apiKey

Your API key

Type
API Key (header: X-VALR-API-KEY)
+
apiSignature

HMAC SHA512 signature of the request (see Authentication section)

Type
API Key (header: X-VALR-SIGNATURE)
+
apiTimestamp

Request timestamp in milliseconds

Type
API Key (header: X-VALR-TIMESTAMP)

Parameters​

Query Parameters

currencySymbol*

The currency symbol to filter by (e.g., BTC, ETH).

Type
string
Required
Example"BTC"
skip

Number of items to skip before returning results.

Type
integer
Example0
Format
"int32"
limit

Maximum number of items to return (max 100).

Type
integer
Example100
Format
"int32"
startTime

Start time in ISO 8601 format (e.g., 2023-11-14T22:00:00.000Z)

Type
string
endTime

End time in ISO 8601 format (e.g., 2023-12-14T22:00:00.000Z)

Type
string

Responses​

Interest earned history retrieved successfully

application/json
JSON
[
{
"currency": "USDC",
"interestAmount": "0.00004567",
"quantity": "10",
"createdAt": "2024-10-14T14:00:00.322193Z"
}
]

Playground​

Authorization
Variables
Key
Value

Samples​