The RPC API enables you to view details about accounts and contracts as well as perform contract calls.
Quick Reference Method Purpose view_accountGet basic account information view_account_changesMonitor account state changes view_codeGet deployed contract WASM code view_stateGet contract storage data data_changesMonitor contract state changes contract_code_changesMonitor contract deployments call_functionExecute read-only contract methods
View Account Returns basic account information.
method : queryparams : request_type: view_account, finality OR block_id, account_id
{ "jsonrpc" : "2.0" , "id" : "dontcare" , "method" : "query" , "params" : { "request_type" : "view_account" , "finality" : "final" , "account_id" : "account.rpc-examples.testnet" } }
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' , });
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"}'
{ "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 : changesparams : changes_type: account_changes, account_ids, finality OR block_id
{ "jsonrpc" : "2.0" , "id" : "dontcare" , "method" : "changes" , "params" : { "changes_type" : "account_changes" , "account_ids" : [ "contract.rpc-examples.testnet" ], "block_id" : 187310139 } }
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 } );
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 : queryparams : request_type: view_code, finality OR block_id, account_id
{ "jsonrpc" : "2.0" , "id" : "dontcare" , "method" : "query" , "params" : { "request_type" : "view_code" , "finality" : "final" , "account_id" : "contract.rpc-examples.testnet" } }
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' , });
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 : queryparams : 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.
{ "jsonrpc" : "2.0" , "id" : "dontcare" , "method" : "query" , "params" : { "request_type" : "view_state" , "finality" : "final" , "account_id" : "contract.rpc-examples.testnet" , "prefix_base64" : "" } }
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: '' , });
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 : changesparams : changes_type: data_changes, account_ids, key_prefix_base64, finality OR block_id
{ "jsonrpc" : "2.0" , "id" : "dontcare" , "method" : "changes" , "params" : { "changes_type" : "data_changes" , "account_ids" : [ "contract.rpc-examples.testnet" ], "key_prefix_base64" : "" , "block_id" : 187310139 } }
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 }, '' );
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 : changesparams : changes_type: contract_code_changes, account_ids, finality OR block_id
{ "jsonrpc" : "2.0" , "id" : "dontcare" , "method" : "changes" , "params" : { "changes_type" : "contract_code_changes" , "account_ids" : [ "contract.rpc-examples.testnet" ], "block_id" : 187309439 } }
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 } );
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 : queryparams : request_type: call_function, finality OR block_id, account_id, method_name, args_base64
{ "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" : "" } }
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: '' , });
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 UnknownAccountAccount does not exist Check account ID spelling InvalidAccountInvalid account format Use valid account ID (e.g., account.near) UnknownBlockBlock not found Use a valid block hash or height GarbageCollectedBlockBlock too old Use archival node or more recent block NoContractCodeNo contract deployed Verify the account has a deployed contract MethodNotFoundContract method does not exist Check method name and contract ABI InvalidArgsInvalid method arguments Verify args format and encoding
