Skip to main content

​
API integration for builders

​
Approving builder fees

Builder actions require users to approve a broker/builder fee. See Approve Broker Fee endpoint. 
curl --request POST \
  --url https://api.hotstuff.trade/exchange \
  --header 'Content-Type: application/json' \
  --data '{
    "action": {
      "data": {
        "broker": "0x1234567890123456789012345678901234567890",
        "maxFeeRate": "0.001",
        "nonce": 1769690420567
      },
      "type": "approveBrokerFee"
    },
    "signature": "0x79a8f17e198acb5532166f9705a4b9d49ac029cc390b310e07f11b2b3a03f591...",
    "nonce": 1769690420567
  }'

​
Check Builder fee approval

See Check Broker Approval endpoint

​
Place orders with builder codes

Set BrokerConfig in place order actions by adding a brokerConfig to all place order actions in the Place Order API endpoint

​
Claim rewards

Accumulated builder fee can be claimed via the referral dashboard in the UI or via the Claim Rewards API endpoint