/v1/view | Alchemy Docs

Executes a Move view function with the provided arguments and returns the result. The function must be marked as a view function in the Move module. If a ledger_version is specified and has been pruned, the server will respond with a 410 error.

Query Parameters

ledger_versionstringOptionalformat: "uint64"

The ledger version to use when executing the view. If not provided, the latest version is used. This is a string representing a uint64 to ensure compatibility with JavaScript.

Request

This endpoint expects an object.

functionstringRequired

Fully qualified Move function to execute, in the format {address}::{module name}::{function name}. Both module name and function name are case-sensitive.

type_argumentslist of stringsRequired

Type arguments passed to the function.

argumentslist of stringsRequired

Arguments passed to the function.

Response

Successful execution of view function

string

integer

boolean

list of any

map from strings to any

1	import requests
2
3	url = "https://aptos-mainnet.g.alchemy.com/v2/docs-demo/v1/view"
4
5	payload = {
6	"function": "0x1::coin::balance",
7	"type_arguments": ["0x1::aptos_coin::AptosCoin"],
8	"arguments": ["0x1d8727df513fa2a8785d0834e40b34223daff1affc079574082baadb74b66ee4"]
9	}
10	headers = {"Content-Type": "application/json"}
11
12	response = requests.post(url, json=payload, headers=headers)
13
14	print(response.json())

1	[
2	"4168302193780"
3	]