Skip to main content
POST
Prepare exchange registration

Authorizations

Authorization
string
header
required

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

Path Parameters

exchange
enum<string>
required

Supported perpetual exchange

Available options:
aster,
binance,
bybit,
extended,
gate,
hyperliquid,
lighter,
mexc,
ondo,
robinhood

Body

application/json
address
string
required

User address

Example:

"0x1234567890abcdef1234567890abcdef12345678"

agentExpiry
integer

Aster agent expiry timestamp (ms)

Required range: x <= 9007199254740991
apiKeyIndex
integer

Lighter API key index

Required range: x <= 9007199254740991
builderAddress
string

Aster builder address signed off in the API agent approval. Defaults to a server-side constant when omitted

Example:

"0x1234567890abcdef1234567890abcdef12345678"

builderName
string

Aster builder display name. Defaults to a server-side constant when omitted

Minimum string length: 1
maxFeeRate
string

Aster builder max fee-rate cap as a decimal string, where 3 bps equals 3 / 10,000 = 0.0003. Defaults to a server-side constant when omitted

Minimum string length: 1
Example:

"0.0003"

referralCode
string

Referral code bound to the new account right after registration on aster, hyperliquid, lighter, robinhood, extended and ondo. The VOOI code is applied when you omit it

Minimum string length: 1

Response

200 - application/json

Registration preparation data

exchange
enum<string>
required
Available options:
aster
registrationToken
string
required

Opaque token. Pass back unchanged in the execute request

signData
tuple
required

Two EIP-712 messages to sign in order: [0] register and approve the VOOI API agent (registerAndApproveAgent), [1] approve the VOOI builder for order-time fee attribution.