Balances & Reconciliation

Balance changes on accounts can be tracked by using our changes RPC endpoint. You can test this out by sending tokens to an account using NEAR-CLI and then viewing the changes made.

For continuous monitoring, use an indexer to process finalized receipts and outcomes across shards and store the movements affecting your accounts.

View Balance Changes

For an incoming deposit, identify the successful finalized receiving receipt and use its outcome’s block_hash; the transaction-inclusion block may be different. Query changes for the exchange receiver, not the original signer. For general reconciliation, select one finalized block hash and query all relevant accounts and token contracts at that checkpoint. Inspect change causes; fees, outgoing transfers, and refunds also change balances. The example below queries the receiving receipt of this finalized testnet transaction from influencer.testnet. It transfers 2 NEAR to linkdrop.primitives.testnet. The returned amount is the receiver’s total balance after the transfer, in yoctoNEAR. The receipt_hash identifies the receipt that caused the update. Example Query using HTTPie:

http post https://archival-rpc.testnet.near.org jsonrpc=2.0 id=dontcare \
    method=changes \
    'params:={
        "block_id": "C8hyrSb5LJjHS5fJXGroWA56hDenCL5YR5bVbuuguDCj",
        "changes_type": "account_changes",
        "account_ids": ["linkdrop.primitives.testnet"]
    }'

Balance Snapshot

Alternatively, query view_account for a balance snapshot. Use the same finalized block hash for reconciliation.

Balances like this do not include Fungible Tokens; FT balances require ft_balance_of on the token contract

Example HTTPie Request:

http post https://archival-rpc.testnet.near.org jsonrpc=2.0 id=dontcare method=query \
params:='{
  "request_type": "view_account",
  "block_id": "C8hyrSb5LJjHS5fJXGroWA56hDenCL5YR5bVbuuguDCj",
  "account_id": "linkdrop.primitives.testnet"
}'

Example Response:

{
  "jsonrpc": "2.0",
  "result": {
    "amount": "2998044874632158900000000",
    "block_hash": "C8hyrSb5LJjHS5fJXGroWA56hDenCL5YR5bVbuuguDCj",
    "block_height": 271205691,
    "code_hash": "11111111111111111111111111111111",
    "locked": "0",
    "storage_paid_at": 0,
    "storage_usage": 182
  },
  "id": "dontcare"
}

Frequently Asked Questions

Which balance look-ups exist? What is required?

We have an RPC method for viewing account.The JS implementation is here. Note that in this RPC interface you can specify the finality requirement (whether to query the latest state or finalized state).For custody purposes, query finalized state.

Protocol

Accounts & Transfers

Tokens & Staking

Balances & Reconciliation

View Balance Changes

Balance Snapshot

Frequently Asked Questions

​View Balance Changes

​Balance Snapshot

​Frequently Asked Questions

View Balance Changes

Balance Snapshot

Frequently Asked Questions