Get contract map entry

RPC node

Retrieves a specific entry from a contract data map.

POST

Parameters

Path Parameters

contract_address
REQUIRED
string Standard Stacks address (e.g. `SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0`). Must be 28-41 characters long using Stacks base58check format.
contract_name
REQUIRED
string Contract name. Must start with a letter and can contain letters, numbers, hyphens, and underscores. Maximum length is 40 characters for new contracts. Legacy contracts may have names up to 128 characters.
map_name
REQUIRED
string

Query Parameters

proof
integer Controls MARF proof inclusion in response. Set to 1 (default) to include proof, 0 to exclude. Invalid values default to 0 (no proof).
tip
string Stacks chain tip to query from. Options: - (empty/omitted): Use latest anchored tip (canonical confirmed state) - `latest`: Use latest known tip including unconfirmed microblocks - `{block_id}`: Use specific block ID (64 hex characters)

Body

application/json
string
Status codeDescription
200Success
400Bad request
404Not found
500Internal Server Error
cURL
curl -L -X POST \

  "https://api.hiro.so/v2/map_entry/{contract_address}/{contract_name}/{map_name}?proof={proof}&tip={tip}" \

  -H 'Accept: application/json'
Response
{

  "data": "0x0a0c000000010a6d6f6e737465722d69640100000000000000000000000000000001",

  "proof": "0x123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"

}

How is this guide?