Subkey

Update Subkey

Changed on

Update properties of an existing subkey for the authenticated account.

put/account/keys/subkeys/{public_key}

Request

  • Base URL
    https://api.prod.paradex.trade/v1
  • URL
    https://api.prod.paradex.trade/v1/account/keys/subkeys/{public_key}
  • Auth
    API key in header Authorization

Path parameters

public_keystring required

Subkey public key

Request body

namestring required

New name for the subkey.

Example request

{
  "name": "My Updated Device Name"
}

Response

Updated subkey details

account_idstring

Account ID that owns this subkey

allowed_cidrsstring[]

IP CIDR allowlist; empty means unrestricted

block_trade_signing_enabledboolean

Whether this subkey is enabled for block trade signing (create, offer and execute signatures) for its account: it is active, and either the account owner enabled it with the main key or it is the Paradigm RFQ delegation key, which follows its delegation. Always false for pending and revoked subkeys.

created_atinteger

Subkey creation timestamp (nanoseconds since epoch)

idinteger

Unique subkey identifier

namestring

User-provided subkey name

public_keystring

Subkey public key

revoked_atinteger

Revocation timestamp (nanoseconds since epoch, 0 if not revoked)

statestring

Subkey state

updated_atinteger

Last modification timestamp (nanoseconds since epoch)

Example response

{
  "account_id": "0x1234567890abcdef",
  "allowed_cidrs": [
    "[\"203.0.113.0/24\"]"
  ],
  "created_at": 1640995200,
  "id": 1,
  "name": "My Subkey",
  "public_key": "0xabcdef1234567890abcdef",
  "updated_at": 1640995200
}

Changes

  • f33feb7333eaRevision changes
    • warning

      added the new ADDRESS_BOOK_NOT_PARADEX_ACCOUNT enum value to the //// response property for the response status

    • warning

      added the new ADDRESS_BOOK_NOT_PARADEX_ACCOUNT enum value to the //// response property for the response status

    • warning

      added the new ADDRESS_BOOK_NOT_PARADEX_ACCOUNT enum value to the //// response property for the response status

    • warning

      added the new ADDRESS_BOOK_NOT_PARADEX_ACCOUNT enum value to the //// response property for the response status

    • warning

      added the new ADDRESS_BOOK_REPEATED_IN_IMPORT enum value to the //// response property for the response status

    • warning

      added the new ADDRESS_BOOK_REPEATED_IN_IMPORT enum value to the //// response property for the response status

    • warning

      added the new ADDRESS_BOOK_REPEATED_IN_IMPORT enum value to the //// response property for the response status

    • warning

      added the new ADDRESS_BOOK_REPEATED_IN_IMPORT enum value to the //// response property for the response status

    • warning

      added the new STARKNET_PARENT_ONBOARDING_DISABLED enum value to the //// response property for the response status

    • warning

      added the new STARKNET_PARENT_ONBOARDING_DISABLED enum value to the //// response property for the response status

    • warning

      added the new STARKNET_PARENT_ONBOARDING_DISABLED enum value to the //// response property for the response status

    • warning

      added the new STARKNET_PARENT_ONBOARDING_DISABLED enum value to the //// response property for the response status

  • 72c125c93c2bRevision changes
    • warning

      added the new SESSION_EXPIRED enum value to the //// response property for the response status

    • warning

      added the new SESSION_EXPIRED enum value to the //// response property for the response status

    • warning

      added the new SESSION_EXPIRED enum value to the //// response property for the response status

    • warning

      added the new SESSION_EXPIRED enum value to the //// response property for the response status

    • warning

      added the new SESSION_REVOKED enum value to the //// response property for the response status

    • warning

      added the new SESSION_REVOKED enum value to the //// response property for the response status

    • warning

      added the new SESSION_REVOKED enum value to the //// response property for the response status

    • warning

      added the new SESSION_REVOKED enum value to the //// response property for the response status