Skip to main content
POST
Import an external wallet

Authorizations

Authorization
string
header
required

Session JWT (from register/login) or API key (pk_...). X-API-Key: <token> is accepted as an alternative header.

Headers

X-OTP-Token
string

One-time OTP challenge token (user sessions).

Body

application/json
chain
enum<string>
required
Available options:
tron,
eth,
btc
private_key_hex
string
required

32-byte hex private key (64 chars

asset
enum<string>
default:usdt
Available options:
usdt,
usdc,
btc
label
string
idempotency_key
string

Response

Wallet imported.

wallet_id
string<uuid>
type
enum<string>

Product discriminator for segregated wallets.

Available options:
segregated
chain
enum<string>
Available options:
tron,
eth,
btc
asset
string
Example:

"USDT"

address
string
label
string
origin
enum<string>

How the wallet entered the platform.

Available options:
created,
imported
exported
boolean

Whether the private key was ever exported (shared custody).

exported_at
string<date-time>
created_at
string<date-time>
Last modified on July 18, 2026