Skip to main content
The Create Wallet endpoint provisions a new MPC wallet for the specified asset within your sub-account. Finrock enforces a one-wallet-per-asset-per-sub-account limit, so this call is typically made once during initial onboarding for each asset you intend to support. Once provisioned, the wallet is immediately available for address generation and transaction submission.

Request

string
required
Your Finrock API key.
string
required
Your JWT bearer token in the format Bearer {JWT}.
string
required
The asset for which to provision a wallet. Use the asset_name value from the Supported Assets list (e.g. ETH, BTC, USDT_ETH).

Example Request

cURL

Response

A successful request returns HTTP 200 with the newly created wallet object.
string
Unique Finrock identifier for the new wallet.
string
The asset ticker for this wallet (e.g. ETH).
string
Wallet status immediately after creation. Typically active.
string
ISO 8601 timestamp of wallet creation.
Sample 200 Response
object
Returned when the x-api-key or Authorization header is missing or invalid.
Sample 401 Response
Attempting to create a second wallet for an asset that already has one in your sub-account will return an error. Retrieve your existing wallet using List Wallets first.