Accounts / Contracts

Learn to query information from accounts and contracts using the NEAR RPC API.

The RPC API enables you to view details about accounts and contracts as well as perform contract calls.

Quick Reference

Method	Purpose
view_account	Get basic account information
view_account_changes	Monitor account state changes
view_code	Get deployed contract WASM code
view_state	Get contract storage data
data_changes	Monitor contract state changes
contract_code_changes	Monitor contract deployments
call_function	Execute read-only contract methods

---

View Account

Returns basic account information.

• method: query
• params: request_type: view_account, finality OR block_id, account_id

JSON

{
  "jsonrpc": "2.0",
  "id": "dontcare",
  "method": "query",
  "params": {
    "request_type": "view_account",
    "finality": "final",
    "account_id": "account.rpc-examples.testnet"
  }
}

JavaScript

import { JsonRpcProvider } from "near-api-js";

const provider = new JsonRpcProvider({ url: "https://test.rpc.fastnear.com" });

const response = await provider.query({
  request_type: 'view_account',
  finality: 'final',
  account_id: 'account.rpc-examples.testnet',
});

HTTPie

http POST https://rpc.testnet.near.org \
  jsonrpc=2.0 id=dontcare method=query \
  params:='{"request_type":"view_account","finality":"final","account_id":"account.rpc-examples.testnet"}'

Example response

{
  "jsonrpc": "2.0",
  "result": {
    "amount": "999788200694421800000000",
    "block_hash": "56xEo2LorUFVNbkFhCncFSWNiobdp1kzm14nZ47b5JVW",
    "block_height": 187440904,
    "code_hash": "11111111111111111111111111111111",
    "locked": "0",
    "storage_usage": 410
  },
  "id": "dontcare"
}

---

View Account Changes

Returns account changes from transactions in a given account.

• method: changes
• params: changes_type: account_changes, account_ids, finality OR block_id

JSON

{
  "jsonrpc": "2.0",
  "id": "dontcare",
  "method": "changes",
  "params": {
    "changes_type": "account_changes",
    "account_ids": ["contract.rpc-examples.testnet"],
    "block_id": 187310139
  }
}

JavaScript

import { JsonRpcProvider } from "near-api-js";

const provider = new JsonRpcProvider({ url: "https://archival-rpc.testnet.near.org" });

const response = await provider.accountChanges(
  ['contract.rpc-examples.testnet'],
  { blockId: 187310139 }
);

HTTPie

http POST https://archival-rpc.testnet.near.org \
  jsonrpc=2.0 id=dontcare method=changes \
  params:='{"changes_type":"account_changes","account_ids":["contract.rpc-examples.testnet"],"block_id":187310139}'

---

View Contract Code

Returns the contract code (Wasm binary) deployed to the account. The returned code is encoded in base64.

• method: query
• params: request_type: view_code, finality OR block_id, account_id

JSON

{
  "jsonrpc": "2.0",
  "id": "dontcare",
  "method": "query",
  "params": {
    "request_type": "view_code",
    "finality": "final",
    "account_id": "contract.rpc-examples.testnet"
  }
}

JavaScript

import { JsonRpcProvider } from "near-api-js";

const provider = new JsonRpcProvider({ url: "https://test.rpc.fastnear.com" });

const response = await provider.query({
  request_type: 'view_code',
  finality: 'final',
  account_id: 'contract.rpc-examples.testnet',
});

HTTPie

http POST https://rpc.testnet.near.org \
  jsonrpc=2.0 id=dontcare method=query \
  params:='{"request_type":"view_code","finality":"final","account_id":"contract.rpc-examples.testnet"}'

---

View Contract State

Returns the state (key-value pairs) of a contract based on a key prefix (base64 encoded). Pass an empty string for prefix_base64 to return the entire state.

• method: query
• params: request_type: view_state, finality OR block_id, account_id, prefix_base64

By default, RPC nodes only return up to 50kB of contract state. If the contract’s state exceeds this limit, the query will return an error. To query larger state, use an archival node and paginate with prefix_base64.

JSON

{
  "jsonrpc": "2.0",
  "id": "dontcare",
  "method": "query",
  "params": {
    "request_type": "view_state",
    "finality": "final",
    "account_id": "contract.rpc-examples.testnet",
    "prefix_base64": ""
  }
}

JavaScript

import { JsonRpcProvider } from "near-api-js";

const provider = new JsonRpcProvider({ url: "https://test.rpc.fastnear.com" });

const response = await provider.query({
  request_type: 'view_state',
  finality: 'final',
  account_id: 'contract.rpc-examples.testnet',
  prefix_base64: '',
});

HTTPie

http POST https://rpc.testnet.near.org \
  jsonrpc=2.0 id=dontcare method=query \
  params:='{"request_type":"view_state","finality":"final","account_id":"contract.rpc-examples.testnet","prefix_base64":""}'

---

View Contract State Changes

Returns state change details of a contract based on a key prefix (base64 encoded).

• method: changes
• params: changes_type: data_changes, account_ids, key_prefix_base64, finality OR block_id

JSON

{
  "jsonrpc": "2.0",
  "id": "dontcare",
  "method": "changes",
  "params": {
    "changes_type": "data_changes",
    "account_ids": ["contract.rpc-examples.testnet"],
    "key_prefix_base64": "",
    "block_id": 187310139
  }
}

JavaScript

import { JsonRpcProvider } from "near-api-js";

const provider = new JsonRpcProvider({ url: "https://archival-rpc.testnet.near.org" });

const response = await provider.contractStateChanges(
  ['contract.rpc-examples.testnet'],
  { blockId: 187310139 },
  ''
);

HTTPie

http POST https://archival-rpc.testnet.near.org \
  jsonrpc=2.0 id=dontcare method=changes \
  params:='{"changes_type":"data_changes","account_ids":["contract.rpc-examples.testnet"],"key_prefix_base64":"","block_id":187310139}'

---

View Contract Code Changes

Returns code changes made when deploying a contract. Change is returned as a base64 encoded WASM file.

• method: changes
• params: changes_type: contract_code_changes, account_ids, finality OR block_id

JSON

{
  "jsonrpc": "2.0",
  "id": "dontcare",
  "method": "changes",
  "params": {
    "changes_type": "contract_code_changes",
    "account_ids": ["contract.rpc-examples.testnet"],
    "block_id": 187309439
  }
}

JavaScript

import { JsonRpcProvider } from "near-api-js";

const provider = new JsonRpcProvider({ url: "https://archival-rpc.testnet.near.org" });

const response = await provider.contractCodeChanges(
  ['contract.rpc-examples.testnet'],
  { blockId: 187309439 }
);

HTTPie

http POST https://archival-rpc.testnet.near.org \
  jsonrpc=2.0 id=dontcare method=changes \
  params:='{"changes_type":"contract_code_changes","account_ids":["contract.rpc-examples.testnet"],"block_id":187309439}'

---

Call a Contract Function

Allows you to call a contract method as a view function (read-only).

• method: query
• params: request_type: call_function, finality OR block_id, account_id, method_name, args_base64

JSON

{
  "jsonrpc": "2.0",
  "id": "dontcare",
  "method": "query",
  "params": {
    "request_type": "call_function",
    "finality": "final",
    "account_id": "contract.rpc-examples.testnet",
    "method_name": "get_greeting",
    "args_base64": ""
  }
}

JavaScript

import { JsonRpcProvider } from "near-api-js";

const provider = new JsonRpcProvider({ url: "https://test.rpc.fastnear.com" });

const response = await provider.query({
  request_type: 'call_function',
  finality: 'final',
  account_id: 'contract.rpc-examples.testnet',
  method_name: 'get_greeting',
  args_base64: '',
});

HTTPie

http POST https://rpc.testnet.near.org \
  jsonrpc=2.0 id=dontcare method=query \
  params:='{"request_type":"call_function","finality":"final","account_id":"contract.rpc-examples.testnet","method_name":"get_greeting","args_base64":""}'

---

Error Handling

Error Code	Description	Solution
UnknownAccount	Account does not exist	Check account ID spelling
InvalidAccount	Invalid account format	Use valid account ID (e.g., account.near)
UnknownBlock	Block not found	Use a valid block hash or height
GarbageCollectedBlock	Block too old	Use archival node or more recent block
NoContractCode	No contract deployed	Verify the account has a deployed contract
MethodNotFound	Contract method does not exist	Check method name and contract ABI
InvalidArgs	Invalid method arguments	Verify args format and encoding