Api authorize builder request
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.
NameLite |
Type | RequiredDefault |
Description |
|---|---|---|---|
main_account_idma |
string | True | The Main Account ID of the user granting the authorization. |
builder_account_idba |
string | True | The Main Account ID of the Builder receiving the authorization. |
max_futures_fee_ratemf |
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_ratems |
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. |
signatures |
Signature | True | The cryptographic signature authenticating this request. Must be signed by the private key associated with mainAccountID. |
Signature
NameLite |
Type | RequiredDefault |
Description |
|---|---|---|---|
signers |
string | True | The address (public key) of the wallet signing the payload |
rr |
string | True | Signature R |
ss1 |
string | True | Signature S |
vv |
integer | True | Signature V |
expiratione |
string | True | Timestamp after which this signature expires, expressed in unix nanoseconds. Must be capped at 30 days |
noncen |
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_idci |
string | True | Chain ID used in EIP-712 domain. Zero value fallbacks to GRVT Chain ID. |