Interest & funding payments

Rate limits

480 requests/min or 80 requests/10secs per IP address. (weight = 5)

{% hint style="info" %} See more details in API Rate limits {% endhint %}

Request

{% tabs %} {% tab title="Interest and funding" %} Query subaccount historical interest and funding payments.

POST [ARCHIVE_ENDPOINT]

Body

{
  "interest_and_funding": {
    "subaccount": "0xD028878bF5c96218E53DA859e587cb8398B17b3f64656661756c740000000000",
    "product_ids": [1, 2],
    "limit": 10,
    "max_idx": 1315836
  }
}

{% endtab %} {% endtabs %}

Request Parameters

Parameter	Type	Required	Description
subaccount	string	Yes	A bytes32 sent as a hex string; includes the address and the subaccount identifier.
product_ids	number[]	Yes	Ids of products to historical interest/funding payments for.
max_idx	string/number	No	When provided, only return records with `idx` <= `max_idx`.
limit	number	Yes	Max number of records to return. Max possible of `100`.

Response

{
    "interest_payments": [
        {
            "product_id": 4,
            "idx": "5968022",
            "timestamp": "1701698400",
            "amount": "-12273223338657163",
            "balance_amount": "1000000000000000000",
            "rate_x18": "47928279191008320",
            "oracle_price_x18": "2243215034242228224820"
        },
        ...
    ],
    "funding_payments": [
        {
            "product_id": 2,
            "idx": "5968022",
            "timestamp": "1701698400",
            "amount": "-12273223338657163",
            "balance_amount": "1000000000000000000",
            "rate_x18": "47928279191008320",
            "oracle_price_x18": "2243215034242228224820"
        },
        ...
    ],
    "next_idx": "1314805"
}

Response Fields

Field name	Description
interest_payments.product_id	Id of spot product the interest payment is associated to.
interest_payments.idx	Id of transaction that triggered the interest payment.
interest_payments.timestamp	Timestamp of the transaction that triggered the interest payment.
interest_payments.amount	Amount of interest paid multiplied by 10**18.
interest_payments.balance_amount	Previous spot balance at the moment of payment (exclusive of payment amount)
interest_payments.rate_x18	Spot interest rate at the moment of payment, multiplied by 10**18.
interest_payments.oracle_price_x18	Oracle price for the spot product at the moment of payment, multiplied by 10**18.
funding_payments.product_id	Id of perp product the funding payment is associated to.
funding_payments.idx	Id of transaction that triggered the funding payment.
funding_payments.timestamp	Timestamp of the transaction that triggered the funding payment.
funding_payments.amount	Amount of funding paid multiplied by 10**18.
funding_payments.balance_amount	Previous perp balance at the moment of payment +amount of perps locked in LPs (exclusive of payment amount).
funding_payments.rate_x18	Perp funding rate at the moment of payment, multiplied by 10**18.
funding_payments.oracle_price_x18	Oracle price for the perp product at the moment of payment, multiplied by 10**18.
next_idx	Id of the next payment snapshot. Use this as `max_idx` on a subsequent call to get the next page. This will be `null` when there are no more records.

6.8 KiB Raw Permalink Blame History