Subkey

Update subkey IP allowlist

Changed on

Replace the IP CIDR allowlist for a subkey. Empty array clears the allowlist (unrestricted). Only callable with the main account; subkeys cannot widen their own allowlist.

put/account/keys/subkeys/{public_key}/allowed-cidrs

Request

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

Path parameters

public_keystring required

Subkey public key

Request body

allowed_cidrsstring[]

Full replacement list. Empty = unrestricted.

Example request

{
  "allowed_cidrs": [
    "[\"203.0.113.0/24\"",
    "\"198.51.100.42/32\"]"
  ]
}

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