Skip to main content
GET
/
v1
/
accounts
/
{address.value}
:raw
Error
A valid request URL is required to generate request examples
{
  "address": {
    "value": "aSDinaTvuI8gbWludGxpZnk="
  },
  "rawMeta": "aSDinaTvuI8gbWludGxpZnk=",
  "rawData": "aSDinaTvuI8gbWludGxpZnk=",
  "versionContext": {
    "slot": "<string>",
    "blockTimestamp": "2023-11-07T05:31:56Z"
  }
}

Path Parameters

​
address.value
string<byte>
required

32-byte public key buffer.

Query Parameters

​
view
enum<string>
default:ACCOUNT_VIEW_UNSPECIFIED
  • ACCOUNT_VIEW_UNSPECIFIED: ACCOUNT_VIEW_UNSPECIFIED uses service defaults.
  • ACCOUNT_VIEW_PUBKEY_ONLY: ACCOUNT_VIEW_PUBKEY_ONLY returns only the account address.
  • ACCOUNT_VIEW_META_ONLY: ACCOUNT_VIEW_META_ONLY returns only account metadata.
  • ACCOUNT_VIEW_DATA_ONLY: ACCOUNT_VIEW_DATA_ONLY returns only account data.
  • ACCOUNT_VIEW_FULL: ACCOUNT_VIEW_FULL returns address, metadata, and data.
Available options:
ACCOUNT_VIEW_UNSPECIFIED,
ACCOUNT_VIEW_PUBKEY_ONLY,
ACCOUNT_VIEW_META_ONLY,
ACCOUNT_VIEW_DATA_ONLY,
ACCOUNT_VIEW_FULL
​
versionContext.slot
string<uint64>

Request the version for a specific slot number.

​
versionContext.timestamp
string<date-time>

Request the version nearest to the provided block timestamp.

​
versionContext.seq
string<uint64>

Request the version for a specific seq number. Relevant only for GetAccount and GetRawAccount requests.

​
minConsensus
enum<string>
default:CONSENSUS_STATUS_UNSPECIFIED
  • CONSENSUS_STATUS_UNSPECIFIED: CONSENSUS_STATUS_UNSPECIFIED indicates the consensus status is unknown.
  • CONSENSUS_STATUS_OBSERVED: CONSENSUS_STATUS_OBSERVED indicates the resource has been observed but not yet confirmed in a finalized block.
  • CONSENSUS_STATUS_INCLUDED: CONSENSUS_STATUS_INCLUDED indicates the resource has been included in the ledger but may not be finalized.
  • CONSENSUS_STATUS_FINALIZED: CONSENSUS_STATUS_FINALIZED indicates the resource is finalized for a slot.
  • CONSENSUS_STATUS_LOCALLY_EXECUTED: CONSENSUS_STATUS_LOCALLY_EXECUTED indicates the local node executed the resource but broader cluster finality may not have been achieved.
  • CONSENSUS_STATUS_CLUSTER_EXECUTED: CONSENSUS_STATUS_CLUSTER_EXECUTED indicates the entire cluster has executed and agreed on the resource.
Available options:
CONSENSUS_STATUS_UNSPECIFIED,
CONSENSUS_STATUS_OBSERVED,
CONSENSUS_STATUS_INCLUDED,
CONSENSUS_STATUS_FINALIZED,
CONSENSUS_STATUS_LOCALLY_EXECUTED,
CONSENSUS_STATUS_CLUSTER_EXECUTED

Response

A successful response.

RawAccount captures raw serialized account bytes.

​
address
object
required

Pubkey represents a 32-byte public key value.

​
rawMeta
string<byte>
required
Pattern: ^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$
​
rawData
string<byte>
Pattern: ^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$
​
versionContext
object

VersionContextMetadata captures context for a returned account state.