Sign in
Tables

Get raw table item

Get a table item at a specific ledger version from the table identified by {table_handle} in the path and the "key" (RawTableItemRequest) provided in the request body.

The get_raw_table_item requires only a serialized key comparing to the full move type information comparing to the get_table_item api, and can only return the query in the bcs format.

The Aptos nodes prune account state history, via a configurable time window. If the requested ledger version has been pruned, the server responds with a 410.

post/tables/{table_handle}/raw_item

Path parameters

table_handlestring hex required

A hex encoded 32 byte Aptos account address.

This is represented in a string as a 64 character hex string, sometimes shortened by stripping leading 0s, and adding a 0x.

For example, address 0x0000000000000000000000000000000000000000000000000000000000000001 is represented as 0x1.

Example:0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1

Table handle hex encoded 32-byte string

Query parameters

ledger_versionstring uint64

A string containing a 64-bit unsigned integer.

We represent u64 values as a string to ensure compatibility with languages such as JavaScript that do not parse u64s in JSON natively.

Example:32425224034

Ledger version to get state of account

If not provided, it will be the latest version

Request body

keystring hex required

All bytes (Vec<u8>) data is represented as hex-encoded string prefixed with 0x and fulfilled with two hex digits per byte.

Unlike the Address type, HexEncodedBytes will not trim any zeros.

Example request

{
  "key": "0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1"
}

Response

integer required

Move u8 value

OR
integer required

Move u16 value

OR
integer required

Move u32 value

OR
string uint64 required

Move u64 value

OR
string uint128 required

Move u128 value

OR
string uint256 required

Move u256 value

OR
boolean required

Move bool value

OR
string hex required

Move address value

OR
OR
string hex required

Move bytes value

OR
object required

Move struct value

OR
string required

Move string value

Example response

"32425224034"

Changes

No recorded changes to this endpoint across all 1 revision of this API.