Api authorize builder request

ApiAuthorizeBuilderRequest

Authorizes a specific Builder to execute transactions on behalf of the Main Account.

This endpoint acts as an upsert operation:
- New Authorization: If the builder is not currently authorized, a new record is created.
- Update Limit: If the builder is already authorized, this request updates the maxFuturesFeeRate and maxSpotFeeRate to the new values provided.

Name
Lite
Type Required
Default
Description
main_account_id
ma
string True The Main Account ID of the user granting the authorization.
builder_account_id
ba
string True The Main Account ID of the Builder receiving the authorization.
max_futures_fee_rate
mf
string True The maximum fee rate cap for Futures trades executed by this builder, expressed as a percentage (e.g., 0.001 means 0.001%). The builder cannot charge fees exceeding this limit.
max_spot_fee_rate
ms
string True The maximum fee rate cap for Spot trades executed by this builder, expressed as a percentage (e.g., 0.0001 means 0.0001%). The builder cannot charge fees exceeding this limit.
signature
s
Signature True The cryptographic signature authenticating this request. Must be signed by the private key associated with mainAccountID.
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.