Api submit qualified maker funding rates request

ApiSubmitQualifiedMakerFundingRatesRequest

Submits a qualified maker's long and short funding rates for stable perps. Each entry applies from the instrument's next charge. Only qualified makers can submit.

Name
Lite
Type Required
Default
Description
rates
r
[QualifiedMakerFundingRateEntry] True One entry per instrument; the request is accepted or rejected as a whole
signature
s
Signature True The EIP-712 signature over rates
QualifiedMakerFundingRateEntry
Name
Lite
Type Required
Default
Description
instrument
i
string True A listed stable perp
mode
m
SfpFundingMode True Either funding mode; the entry carries only that mode's pair of rate fields
long_rate_apr_pct
lr
string False
0
ANNUAL_PCT_OF_CURRENT_PRICE only: the long rate in percent a year, up to 6 decimals ("-4.5" = retail longs pay 4.5%); positive = retail receives, negative = retail pays
short_rate_apr_pct
sr
string False
0
ANNUAL_PCT_OF_CURRENT_PRICE only: the short rate in percent a year, up to 6 decimals; positive = retail receives, negative = retail pays
long_rate_cash_per_unit
lr1
string False
0
DAILY_CASH_PER_UNIT only: the long rate in quote currency per unit per day, up to 6 decimals; positive = retail receives, negative = retail pays
short_rate_cash_per_unit
sr1
string False
0
DAILY_CASH_PER_UNIT only: the short rate in quote currency per unit per day, up to 6 decimals; positive = retail receives, negative = retail pays
SfpFundingMode
Value Description
UNSPECIFIED = 0
ANNUAL_PCT_OF_CURRENT_PRICE = 1 Rate is an annual percentage of notional, as a fraction with 9 decimals: 4.5% = 45000000
DAILY_CASH_PER_UNIT = 2 Rate is quote currency per unit per day, with 9 decimals: 0.25 USDC = 250000000
Signature
Name
Lite
Type Required
Default
Description
signer
s
string True The address (public key) of the wallet signing the payload
r
r
string True Signature R
s
s1
string True Signature S
v
v
integer True Signature V
expiration
e
string True Timestamp after which this signature expires, expressed in unix nanoseconds. Must be capped at 30 days
nonce
n
integer True Users can randomly generate this value, used as a signature deconflicting key.
ie. You can send the same exact instruction twice with different nonces.
When the same nonce is used, the same payload will generate the same signature.
Our system will consider the payload a duplicate, and ignore it.
Range: 0 to 4,294,967,295 (uint32)
chain_id
ci
string True Chain ID used in EIP-712 domain. Zero value fallbacks to GRVT Chain ID.