Register Subkey | Paradex

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

API Key authentication via header

Subkey registration request

User-friendly name for the subkey.

Public key to be registered as a subkey.

Encrypted private key (required if state=pending).

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

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

Unix seconds; included in signed message.

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

$	curl -X POST https://api.prod.paradex.trade/v1/account/keys/subkeys \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "My Trading Subkey",
>	"public_key": "0x3d9f2b2e5f50c1aade60ca540368cd7490160f41270c192c05729fe35b656a9"
>	}'

$	curl -X POST https://api.prod.paradex.trade/v1/account/keys/subkeys \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "My Trading Subkey",
>	"public_key": "0x3d9f2b2e5f50c1aade60ca540368cd7490160f41270c192c05729fe35b656a9"
>	}'