getWallet

Web3 Services

API Overview

Health

Webhook Subscriptions

Configurations

Monitor Tokens

Developer Account

Faucet

Developer-Controlled Wallets

Wallet Sets

Wallets

Signing

Transactions

Token Lookup

Smart Contract Platform

Templates

View / Update

Interact

Deploy / Import

User-Controlled Wallets

Social/ Email Authentication

PIN Authentication

Users

Wallets

Transactions

Token Lookup

Signing

Compliance Engine

Address Screening

Get a wallet

GEThttps://api.circle.com/v1/w3s/wallets/{id}

Retrieves info for a single user-controlled wallet using it's unique identifier.

Header parameters

X-User-Token

string

Required

Unique system generated JWT session token for specific user.

Path parameters

uuid

Required

The universally unique identifier (UUID v4) of the resource.

Response

200WalletResponse

Response Body

object

data

object

Required

Show 1 properties

wallet

object

Required

option 1: EOAWallet

Show 12 properties

string

Required

System-generated unique identifier of the resource.

address

string

Required

Blockchain address of the wallet.

blockchain

string

Required

The blockchain network that the resource is to be created on or is currently on.

createDate

string

Required

Date and time the resource was created, in ISO-8601 UTC format.

updateDate

string

Required

Date and time the resource was last updated, in ISO-8601 UTC format.

custodyType

string

Required

Describes who controls the digital assets in a wallet: either the end-user or the developer.

name

string

Optional name or description associated with the wallet.

refId

string

Reference or description used to identify the object.

state

string

Required

This enum describes the current state of the wallet.

userId

string

Unique system generated identifier for the user.

walletSetId

string

Required

System-generated unique identifier of the resource.

accountType

string

Required

An account can be a Smart Contract Account (SCA) or an Externally Owned Account (EOA). To learn more, see the account types guide.

If an account type is not specified during the creation of a wallet, it defaults to EOA (Externally Owned Account). Note that Solana doesn't support Smart Contract Account (SCA).

option 2: SCAWallet

Show 13 properties

string

Required

System-generated unique identifier of the resource.

address

string

Required

Blockchain address of the wallet.

blockchain

string

Required

The blockchain network that the resource is to be created on or is currently on.

createDate

string

Required

Date and time the resource was created, in ISO-8601 UTC format.

updateDate

string

Required

Date and time the resource was last updated, in ISO-8601 UTC format.

custodyType

string

Required

Describes who controls the digital assets in a wallet: either the end-user or the developer.

name

string

Optional name or description associated with the wallet.

refId

string

Reference or description used to identify the object.

state

string

Required

This enum describes the current state of the wallet.

userId

string

Unique system generated identifier for the user.

walletSetId

string

Required

System-generated unique identifier of the resource.

accountType

string

Required

An account can be a Smart Contract Account (SCA) or an Externally Owned Account (EOA). To learn more, see the account types guide.

If an account type is not specified during the creation of a wallet, it defaults to EOA (Externally Owned Account). Note that Solana doesn't support Smart Contract Account (SCA).

scaCore

string

Required

SCAs can have different versions that have different functionality. SCACore will display the version of the SCA being created. Please refer to developer docs for a list of the versions supported.

401NotAuthorizedResponse

404NotFoundResponse

RequestChoose a language

ResponseChoose an example

1{
2  "data": {
3    "wallet": {
4      "id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
5      "address": "",
6      "blockchain": "MATIC-AMOY",
7      "createDate": "2023-01-01T12:04:05Z",
8      "updateDate": "2023-01-01T12:04:05Z",
9      "custodyType": "DEVELOPER",
10      "name": "my wallet",
11      "refId": "custom_ref_id",
12      "state": "LIVE",
13      "userId": "ext_user_id_1",
14      "walletSetId": "0192295a-3b32-76d7-b17e-7fcf263165a0",
15      "accountType": "EOA"
16    }
17  }
18}

Did this page help you?

Developer Terms Service Terms Privacy Policy Acceptable Use Your Privacy Choices

Cookie Policy