Prepare a builder-fee approval

Prepare a builder-fee approval

post

Build the one-time approval that lets orders be routed with Nansen's builder code.

Hyperliquid refuses an order carrying a builder code until the wallet has approved a maximum fee rate at least as high as the fee on that order, so this approval is a prerequisite for /api/v1/perp/order and /api/v1/perp/close. It is needed once per wallet — check /api/v1/perp/builder-fee instead of prompting for it every session.

Same prepare → sign → execute flow as the trading endpoints: sign the returned eip712 payload and submit it to /api/v1/perp/execute. Sign it with the wallet's own key — an approval signed by an API (agent) wallet is not accepted. The approval covers exactly the fee rate applied to orders, which /api/v1/perp/builder-fee reports.

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication

Body

application/json

Wallet to prepare a one-time builder-fee approval for.

wallet_addressstringRequired

Wallet that will sign the approval. It must be signed by the wallet's own key — an approval signed by an API (agent) wallet is not accepted.

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

post/api/v1/perp/approve-builder-fee

HTTPcURLJavaScriptPython

POST /api/v1/perp/approve-builder-fee HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 63

{
  "wallet_address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}

{
  "action": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "nonce": 1,
  "vault_address": "text",
  "eip712": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "size": 1,
  "price": 1,
  "ANY_ADDITIONAL_PROPERTY": "anything"
}