POSTGet table item

A specific table item can be queried using table_handle, key_type, value_type, and key value. Aptos nodes prune account state history according to a configurable retention period. If the requested ledger version has already been pruned, the server returns a 410 response.

table_handlestringrequired

A pointer value indicating where the table is stored.

ledger_versioninteger

The ledger version of the transaction to fetch account state from. If no value is provided, the latest version is used.

key_typestringrequired

Type of the key

value_typestringrequired

Type of the value

keystring (json)required

Key value of the table item. The format of the returned data varies depending on key_type.

Headers

X-APTOS-BLOCK-HEIGHTintegerrequired

Current block height of the chain

예: 0

X-APTOS-CHAIN-IDintegerrequired

Chain ID of the current chain

예: 0

X-APTOS-EPOCHintegerrequired

Current epoch of the chain

예: 0

X-APTOS-LEDGER-OLDEST-VERSIONintegerrequired

Oldest unpruned ledger version of the chain

예: 0

X-APTOS-LEDGER-TIMESTAMPUSECintegerrequired

Current timestamp of the chain

예: 0

X-APTOS-LEDGER-VERSIONintegerrequired

Current ledger version of the chain

예: 0

X-APTOS-OLDEST-BLOCK-HEIGHTintegerrequired

Oldest unpruned block height of the chain

예: 0

X-APTOS-CURSORstring

Cursor for the next page

예: string

X-APTOS-GAS-USEDinteger

Amount of gas actually used for transaction execution

예: 0

curl -X POST "https://aptos-mainnet.nodit.io/v1/tables/0x7d7561f38ada5eb9066f05c6e80df069208c4de472d6414482016d38448d1a7d/item?ledger_version=0" \ -H "X-API-KEY: {YOUR_API_KEY}" \ -H "Content-Type: application/json" \ -d '{ "key_type": "0x1::type_info::TypeInfo", "value_type": "0x1::object::Object<0x1::fungible_asset::Metadata>", "key": "{"account_address":"0x1","module_name":"0x6170746f735f636f696e","struct_name":"0x4170746f73436f696e"}" }'