Skip to main content

History by Key

Fetch the historical values for a selected key across accounts and predecessors.

Network
AscRequest body field
Include MetadataRequest body field
FastNear API keyNo saved key
Get API key
Endpointhttps://kv.main.fastnear.com
Authnone detected
Live Response

Responses from the selected endpoint appear here after you run a request.

Live response output will appear here after you run a request.

Request reference

application/json

This operation performs POST /v0/history with an application/json request body.

Required request inputs: yes

POST /v0/history
{
  "asc": false,
  "include_metadata": false,
  "key": "graph/follow/sleet.near",
  "limit": 50
}

Request body schema

objectByKeyRequest
requires key
ascboolean

Sort ascending for history results. Defaults to newest-first.

Default: false

include_metadataboolean

Include receipt and signer metadata in each entry.

Default: false

key *string

Exact key name to match across all accounts and predecessors.

limitinteger
page_tokenstring

Opaque pagination cursor from a previous response for the same endpoint and filter set.

Response reference

200 application/json

Historical rows for the selected key

Response schema

objectListResponse
requires entries
entries *array
itemsobjectKvEntry
requires predecessor_id, current_account_id, block_height, block_timestamp, key, value
action_indexinteger
block_height *integer
block_timestamp *integer
current_account_id *string
key *string
predecessor_id *string
receipt_idstring
signer_idstring
tx_hashstring
value *value

Raw JSON value as stored in FastData.

page_tokenstring

Opaque pagination cursor for the next page. Absent when there are no more results.