Skip to main content
POST
Build the payload the user must sign to approve a broker on the given exchange

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
exchange
enum<string>
required
Available options:
aster
identifier
string

Builder Ethereum address. Omit if your account is registered through a broker — the configured builder address is used automatically. If provided alongside a configured broker, it must match exactly.

Example:

"0x1234567890abcdef1234567890abcdef12345678"

maxFeeBps
string

Builder fee in basis points. Omit if your account is registered through a broker — the configured fee is used automatically. If provided alongside a configured broker, it must match exactly.

Pattern: ^\d+(\.\d+)?$
Example:

"1.5"

Response

Per-exchange prepare payload. Response shape depends on the exchange field of the request body:

  • hyperliquid → { pendingData: { action, nonce }, signData: <EIP-712 typed data> }
  • lighter / robinhood → { pendingData: { txInfo, txType }, signData: <hex message> }
  • aster → { pendingData: { asterChain, builder, builderName, maxFeeRate, nonce, user }, signData: <EIP-712 typed data> }
pendingData
HyperliquidApproveBrokerPendingData · object
required

Opaque payload to pass back to the execute endpoint.

signData
object
required

EIP-712 typed data to sign with the main wallet.