LogoLogo
1.4.x
1.4.x
  • Documentation
    • Introduction
    • Overview
      • Authorization
      • Rate limits and quotas
      • Pagination
      • Sorting
      • Filtering
      • Optional properties
      • Errors
    • Getting started
    • Highlights
      • Including related entities
      • Including CSPR rates
      • Including account info
      • Accessing auction data
      • Accessing token data
      • Accessing NFT data
      • De-anonymizing account hashes
      • De-anonymizing account purses
      • Receiving contract-level events
      • Resolving CSPR.name
    • Changelog
  • REST API
    • Reference
    • Account
      • Get account
      • Get accounts
    • Account Info
      • Get account info
      • Get account infos
    • Auction metrics
      • Get auction metrics
    • Awaiting deploy
      • Create Awaiting Deploy
      • Add Awaiting Deploy signatures
      • Get Awaiting Deploy
    • Block
      • Get block
      • Get blocks
      • Get validator blocks
    • Bidder
      • Get bidder
      • Get bidders
    • Centralized account info
      • Get centralized account info
      • Get centralized account infos
    • Contract
      • Get contract
      • Get contracts
      • Get contracts by contract package
      • Get contract types
    • Contract entry point
      • Get contract entry points
      • Get contract entry point costs
    • Contract package
      • Get contract package
      • Get contract packages
      • Get account contract packages
    • Delegation
      • Get account delegations
      • Get validator delegations
    • Delegator reward
      • Get account delegator rewards
      • Get total account delegation rewards
      • Get total validator delegators' rewards
    • Deploy
      • Get deploy
      • Get deploys
      • Get account deploys
      • Get block deploys
      • Get deploy execution types
    • Fungible token action
      • Get fungible token actions
      • Get fungible token action types
      • Get account fungible token actions
      • Get contract package fungible token actions
    • Fungible token ownership
      • Get account fungible token ownership
      • Get contract package fungible token ownership
    • Non-fungible token (NFT)
      • Get NFT
      • Get account NFTs
      • Get contract package NFTs
      • Get NFT standards
      • Get off-chain NFT metadata statuses
    • Non-fungible token (NFT) action
      • Get contract package NFT actions for a token
      • Get account NFT actions
      • Get contract package NFT actions
      • Get NFT action types
    • Non-fungible token (NFT) ownership
      • Get contract package NFT ownership
      • Get account NFT ownership
    • CSPR.name resolution
      • Get CSPR.name resolution
    • CSPR rate
      • Get the current currency rate
      • Get historical currency rates
      • Get currencies
    • CSPR supply
      • Get supply
    • Transfer
      • Get account transfers
      • Get deploy transfers
    • Validator
      • Get validator
      • Get validators
    • Validator performance
      • Get historical validator performance
      • Get historical average validator performance
      • Get historical average validators performance
    • Validator reward
      • Get validator rewards
      • Get validator total rewards
  • Streaming API
    • Reference
    • Account balance
    • Block
    • Contract
    • Contract package
    • Contract-level events
    • Deploy
    • Fungible token action
    • Non-fungible token (NFT)
    • Non-fungible token (NFT) action
    • Transfer
  • Casper Node API
    • Connecting with an SDK
Powered by GitBook
On this page
  • Properties
  • Optional properties
  • Relations
  • Endpoints
  • Relation endpoints
Export as PDF
  1. REST API

Account

The Account entity represents the account observed in the network activity. For example, when the corresponding public key was passed as a deploy argument. Because of that, an Account may not necessarily have a purse and on-chain balance.

Properties

The Account entity has the following properties:

Property
Type
Description

public_key

string(68)

Account public key represented as a hexadecimal string. Primary account identifier

account_hash

string(64)

32-byte hash of the public_key represented as a hexadecimal string. Secondary account identifier

main_purse_uref

string(73)

Account main purse URef in the uref-dead...beef-007 format

balance

uint64

Account main purse balance in motes

Example

{
  "account_hash": "fa12d2dd5547714f8c2754d418aa8c9d59dc88780350cb4254d622e2d4ef7e69",
  "balance": 1325092768520378,
  "main_purse_uref": "uref-bb9f47c30ddbe192438fad10b7db8200247529d6592af7159d92c5f3aa7716a1-007",
  "public_key": "0106ca7c39cd272dbf21a86eeb3b36b7c26e2e9b94af64292419f7862936bca2ca"
}

Optional properties

Depending on the endpoint some of the following optional properties may be included in the Account entity:

Property
Type
Description

auction_status

string

Account auction status: inactive_bidder, active_bidder, active_validator, pending_validator

delegated_balance

uint64

Total funds delegated across all validators

staked_balance

uint64

Total funds staked as validator

undelegating_balance

uint64

Total undelegated funds that will be returned to the account main purse after the 7 era lockdown period

account_info

centralized_account_info

Account information available for known accounts provided by CSPR.cloud team

cspr_name

string

Primary CSPR.name of the account

Relations

The Account entity has the following relations with other entities:

Entity
Mapping property
Description

account_hash

public_key

Account can be a bidder in the auction

owner_public_key

Account can deploy contracts to the network

caller_public_key

Account can call deploys on the network

proposer_public_key

Account can have delegations to validators

public_key

Account can receive delegator rewards

owner_hash

Account can own fungible tokens

from_hash, to_hash

Account can be on the sending or receiving end of a fungible token action

owner_hash

Account can own NFTs

from_hash, to_hash

Account can be on the sending or receiving end of a fungible token action

owner_hash

Account can own multiple NFTs in one NFT contract

initiator_account_hash, to_account_hash

Account can initiate transfers and be a transfer recipient

public_key

Account can be a validator

Endpoints

The Account entity has the following endpoints:

Relation endpoints

The Account entity has the following relation endpoints:

PreviousReferenceNextGet account

Last updated 3 months ago

provided by the account owner

Account can have account info data if provided by the owner to the

Get account
Get accounts
Get account contract packages
Get account delegations
Get account delegation rewards
Get total account delegation rewards
Get account deploys
Get account fungible token ownership
Get account fungible token actions
Get account NFTs
Get account NFT actions
Get account transfers
AccountInfo
Account info
CentralizedAccountInfo
AccountInfo
Account Info contract
Bidder
Contract package
Deploy
Delegation
Delegator reward
Fungible token ownership
Fungible token action
NFT
NFT action
NFT ownership
Transfer
Validator