big_map_value - Tezos
Example code for the /context/big_maps/{big_map_id}/{script_expr} REST method. Complete guide on how to use the /context/big_maps/{big_map_id}/{script_expr} REST method in GetBlock Web3 documentation
Returns a single value from a big map by its packed-key hash (script expression). Big maps hold large key-value stores such as token ledgers.
Endpoint
GET /chains/main/blocks/{block}/context/big_maps/{big_map_id}/{script_expr}Path Parameters
block
string
Block identifier: head, a level, or a block hash
big_map_id
string
Numeric big map identifier
script_expr
string
Script expression hash of the packed key (expr…)
Example
export TEZOS_REST=https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/
curl "${TEZOS_REST}chains/main/blocks/head/context/big_maps/5696/exprvValue..."const axios = require('axios');
const response = await axios.get('https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/chains/main/blocks/head/context/big_maps/5696/exprvValue...', {
headers: { 'Content-Type': 'application/json' }
});
console.log(response.data);import requests
response = requests.get(
'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/chains/main/blocks/head/context/big_maps/5696/exprvValue...',
headers={'Content-Type': 'application/json'}
)
print(response.json())use reqwest::Client;
use serde_json::Value;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let client = Client::new();
let response = client
.get("https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/chains/main/blocks/head/context/big_maps/5696/exprvValue...")
.header("Content-Type", "application/json")
.send()
.await?
.json::<Value>()
.await?;
println!("Result: {}", response);
Ok(())
}Response
{
"prim": "Pair",
"args": [
{
"int": "1000000"
},
[]
]
}Response Fields
(root)
object
Big map value as a Micheline expression
Use Cases
Token Balances: Read an FA1.2/FA2 ledger entry
dApp State: Look up a specific big-map key
Error Handling
400 / Bad request
Bad request
A path or body parameter was invalid
404 / Not found
Not found
The block, contract, or resource does not exist
403 / RBAC: access denied
Access denied
The GetBlock access token is missing or incorrect
Was this helpful?