/v1/tables/{table_handle}/item

Retrieves a specific item from the table identified by {table_handle} using the provided key. This is a POST endpoint because the key can be complex and not suitable for query parameters.

⚠ This endpoint is only available with Blast access.

Path parameters

table_handlestringRequiredformat: "hex"

Hex-encoded 32-byte string representing the table handle.

Query parameters

ledger_versionstringOptional

Ledger version to get the state of the account. If not specified, the latest version is used.

Request

This endpoint expects an object.

key_typestringRequired

The Move type of the key.

value_typestringRequired

The Move type of the value.

keystring or map from strings to anyRequired

The key to identify the item in the table. Can be a primitive or a complex object.

Response

The retrieved table item.

1	import requests
2
3	url = "https://aptos-mainnet.alchemy-blast.com/v2/:apiKey/v1/tables/table_handle/item"
4
5	payload = {
6	"key_type": "0x1::string::String",
7	"value_type": "address",
8	"key": "dport"
9	}
10	headers = {"Content-Type": "application/json"}
11
12	response = requests.post(url, json=payload, headers=headers)
13
14	print(response.json())