API Reference

Derive a wallet

puthttps://api.circle.com/v1/w3s/developer/wallets/{id}/blockchains/{blockchain}

  • Reference
  • Playground

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.

Header parameters
X-Request-Id
string

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

Path parameters
blockchain
string
Required

The unique identifier of the blockchains.

id
uuid
Required

The universally unique identifier of the resource.

Body parameters
metadata
object
name
string

Name or description associated with the wallet or walletSet.

refId
string

Reference or description used to identify the object.

Response
RequestChoose a language
ResponseChoose an example
1{
2  "data": {
3    "wallet": {
4      "id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
5      "address": "0xca9142d0b9804ef5e239d3bc1c7aa0d1c74e7350",
6      "blockchain": "MATIC-AMOY",
7      "createDate": "2023-01-01T12:04:05Z",
8      "updateDate": "2023-01-01T12:04:05Z",
9      "custodyType": "DEVELOPER",
10      "name": "",
11      "refId": "custom_ref_id",
12      "state": "LIVE",
13      "userId": "ext_user_id_1",
14      "walletSetId": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
15      "initialPublicKey": "3eQoJ3ex6uWX3R8F1THF6Y6oBQwPYpF1X9HBM1gjqw7w",
16      "accountType": "EOA"
17    }
18  }
19}
Did this page help you?
© 2023-2025 Circle Technology Services, LLC. All rights reserved.