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 & LiquidationsParadex ChainEcosystemREST APIWebSocket APIAgentic AI HubRelease Notes
HomeOverviewDIME UtilityTradingRisk & LiquidationsParadex 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

Get Subkey

GET
https://api.prod.paradex.trade/v1/account/keys/subkeys/:public_key
GET
/v1/account/keys/subkeys/:public_key
$curl https://api.prod.paradex.trade/v1/account/keys/subkeys/public_key \
>     -H "Authorization: <apiKey>" \
>     -H "Content-Type: application/json"
1{
2  "account_id": "0x9f8e7d6c5b4a3210",
3  "allowed_cidrs": [
4    "203.0.113.0/24"
5  ],
6  "created_at": 1672531200000000000,
7  "id": 42,
8  "name": "Trading Bot Key",
9  "public_key": "0xabcdef1234567890fedcba0987654321",
10  "revoked_at": 0,
11  "state": "active",
12  "updated_at": 1675123200000000000
13}
Get a specific subkey for the authenticated account by its public key.
Was this page helpful?
Previous

Update Subkey

Next
Built with

Authentication

Authorizationstring
API Key authentication via header

Path parameters

public_keystringRequired
Subkey public key

Response

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
404
Not Found Error