Skip to main content
GET
/
api
/
v1
/
funding-payments
List funding payments
curl --request GET \
  --url https://staging.zerolatencylabs.com/api/v1/funding-payments \
  --header 'X-API-KEY: <api-key>'
[
  {
    "account_id": 1,
    "portfolio_index": 1,
    "subaccount_index": 1,
    "funding_rate": "0.0001",
    "id": "0190b6c2-7e4a-7c3b-9f21-2b6a1c4e5d8f",
    "market": "BTC-PERP",
    "payment": "-12.50",
    "position_size": "0.25",
    "time": 1
  }
]

Authorizations

​
X-API-KEY
string
header
required

Base64-encoded API key issued by POST /api/v1/api-keys.

Query Parameters

​
subaccount_index
integer<int32>
required
Required range: x >= 0
​
portfolio_index
integer<int32>
required
Required range: x >= 0
​
market
string

Optional market symbol filter (e.g. BTC-PERP).

​
start_time
integer<int64>

Optional lower bound on effective_at, in unix milliseconds (inclusive).

​
end_time
integer<int64>

Optional upper bound on effective_at, in unix milliseconds (inclusive).

​
limit
integer<int64>
default:100

Maximum number of funding payments to return. Must be between 1 and 1000; defaults to 100.

Required range: 1 <= x <= 1000
​
offset
integer<int64>
default:0

Number of funding payments to skip from the start of the result set. Must be >= 0; defaults to 0.

Required range: x >= 0

Response

Funding payments (newest first)

​
account_id
integer<int64>
required

A system-generated unique identifier for an account.

Required range: x >= 0
​
portfolio_index
integer<int32>
required

A unique identifier for a portfolio within a subaccount.

Required range: x >= 0
​
subaccount_index
integer<int32>
required

A unique identifier for a subaccount within an account.

Required range: x >= 0
​
funding_rate
string
required

The settled funding rate for the period, as a decimal string.

Example:

"0.0001"

​
id
string<uuid>
required

The unique identifier of the funding payment

Example:

"0190b6c2-7e4a-7c3b-9f21-2b6a1c4e5d8f"

​
market
string
required

The symbol of the market (e.g. BTC-PERP)

Example:

"BTC-PERP"

​
payment
string
required

The signed payment applied to the portfolio cash balance in USDC. Positive means the portfolio received funding; negative means it paid.

Example:

"-12.50"

​
position_size
string
required

The signed position size at the time of settlement (positive for long, negative for short), expressed in base-asset units.

Example:

"0.25"

​
time
integer<int64>
required

The timestamp at which the funding payment was effective.

Required range: x >= 0