For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
Join CommunityStart Trading
HomeOverviewDIME UtilityTradingRisk & LiquidationsVTFsParadex ChainEcosystemREST APIWebSocket APIAgentic AI HubRelease Notes
HomeOverviewDIME UtilityTradingRisk & LiquidationsVTFsParadex ChainEcosystemREST APIWebSocket APIAgentic AI HubRelease Notes
  • General Information
    • Server Location
    • Server URLs
    • Quick Start
    • Authentication
    • Rate Limits
    • Benchmarks
    • API Authentication
    • API Best Practices
  • Production API Reference
        • GETList Subkeys
        • POSTRegister Subkey
        • POSTActivate pending subkey
        • GETGet Subkey
        • PUTUpdate Subkey
        • DELRevoke Subkey
        • PUTUpdate subkey IP allowlist
  • Testnet API Reference
  • Useful Resources
    • Paradex Github
    • Paradex CLI
    • Code Samples
    • Python SDK
    • CCXT Integration
Join CommunityStart Trading
Production API ReferenceSubkey

Update subkey IP allowlist

PUT
https://api.prod.paradex.trade/v1/account/keys/subkeys/:public_key/allowed-cidrs
PUT
/v1/account/keys/subkeys/:public_key/allowed-cidrs
$curl -X PUT https://api.prod.paradex.trade/v1/account/keys/subkeys/public_key/allowed-cidrs \
>     -H "Authorization: <apiKey>" \
>     -H "Content-Type: application/json" \
>     -d '{}'
1{
2  "account_id": "0x1a2b3c4d5e6f7890",
3  "allowed_cidrs": [
4    "192.168.1.0/24",
5    "10.0.0.42/32"
6  ],
7  "created_at": 1685600000000000000,
8  "id": 42,
9  "name": "Trading Bot Subkey",
10  "public_key": "0xabcdef1234567890abcdef1234567890abcdef12",
11  "revoked_at": 0,
12  "state": "active",
13  "updated_at": 1685700000000000000
14}

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.

Was this page helpful?
Previous

List tokens

Next
Built with

Authentication

Authorizationstring
API Key authentication via header

Path parameters

public_keystringRequired
Subkey public key

Request

Replacement CIDR list
allowed_cidrslist of stringsOptional

Full replacement list. Empty = unrestricted.

Response

Updated subkey details
account_idstring
Account ID that owns this subkey
allowed_cidrslist of strings

IP CIDR allowlist; empty means unrestricted

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)

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error