SDK Explorer

Derives an EOA (Externally Owned Account) or SCA (Smart Contract Account) wallet using the address of the specified wallet and blockchain. If the target wallet already exists, its metadata will be updated with the provided metadata. This operation is only supported for EVM-based blockchains.

Parameters
DeriveWalletRequest
object
Required
metadata
object
blockchain
string
Required

The unique identifier of the blockchains.

Allowed valuesETHETH-SEPOLIAAVAXAVAX-FUJIMATICMATIC-AMOYARBARB-SEPOLIAUNIUNI-SEPOLIABASEBASE-SEPOLIAOPOP-SEPOLIA
id
string
Required

The universally unique identifier of the resource.

x_request_id
string

Developer-provided parameter used to identify this request. Useful when communicating with Circle Support.

Responses
ResponseChoose an example
1{
2  "data": {
3    "wallet": {
4      "id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
5      "address": "0xca9142d0b9804ef5e239d3bc1c7aa0d1c74e7350",
6      "blockchain": "MATIC-AMOY",
7      "create_date": "2023-01-01T12:04:05Z",
8      "update_date": "2023-01-01T12:04:05Z",
9      "custody_type": "DEVELOPER",
10      "name": "",
11      "ref_id": "custom_ref_id",
12      "state": "LIVE",
13      "user_id": "ext_user_id_1",
14      "wallet_set_id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
15      "initial_public_key": "3eQoJ3ex6uWX3R8F1THF6Y6oBQwPYpF1X9HBM1gjqw7w",
16      "account_type": "EOA"
17    }
18  }
19}
Did this page help you?
© 2023-2025 Circle Technology Services, LLC. All rights reserved.