Production API ReferenceSubkey

Register Subkey

Register a new subkey for the authenticated account.

Authentication

Authorizationstring
API Key authentication via header

Request

Subkey registration request
namestringRequired

User-friendly name for the subkey.

public_keystringRequired
Public key to be registered as a subkey.
encrypted_keystringOptional

Encrypted private key (required if state=pending).

eph_public_keystringOptional

Ephemeral public key for signature verification (required if state=pending).

evm_signaturestringOptional

EVM (EIP-191) registration signature, used in place of signature / signature_timestamp / signature_expiry when the account’s main key is a secp256k1 key (AccountSignerType == EIP191). The server reconstructs nothing — the raw SIWE message presented to the user is supplied verbatim in siwe_message and the personal_sign signature in evm_signature. The SIWE message’s Statement must equal “Paradex Subkey Registration: 0x<new_subkey_pubkey>” (lowercased pubkey); that line is what binds the authorisation to the specific subkey being registered.

signaturelist of stringsOptional

Signature from the account’s main StarkNet private key over pedersen_array(account, public_key, signature_timestamp, signature_expiry). Required when the server enforces main-key authorization on subkey registration (feature flag EnableSubkeyRegistrationSignature). Format: [r, s].

signature_expiryintegerOptional

Unix seconds; included in signed message and bounds replay window.

signature_timestampintegerOptional

Unix seconds; included in signed message.

siwe_messagestringOptional
statestringOptionalDefaults to active

State of the subkey: ‘active’ or ‘pending’. Defaults to ‘active’.

Response

An empty response

Errors

400
Bad Request Error
401
Unauthorized Error