Get builder-fee approval status

Get builder-fee approval status

get

Report whether a wallet has approved the builder fee that order routing requires.

Call this before placing a wallet's first order. approved: false means the exchange will reject orders from /api/v1/perp/order and /api/v1/perp/close until the wallet signs the approval from /api/v1/perp/approve-builder-fee.

required_fee is the fee attached to each order and max_fee_rate is what the wallet has approved so far — both in tenths of a basis point, so 80 means 8 basis points and 0 means no approval yet. builder_address is the address attached to orders; the prepare endpoints already include it in the action they build, so you only need it to display or verify what you are signing.

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication

Query parameters

wallet_addressstringRequired

Wallet address on Hyperliquid

Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

Responses

200

Successful Response

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

502

Bad Gateway

application/json

503

Service Unavailable

application/json

504

Gateway Timeout

application/json

get/api/v1/perp/builder-fee

HTTPcURLJavaScriptPython

GET /api/v1/perp/builder-fee?wallet_address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Accept: */*

{
  "approved": true,
  "max_fee_rate": 1,
  "required_fee": 1,
  "builder_address": "text"
}